调用DescribeOssResultItems接口分页显示OSS违规检测的检测结果。

使用说明

业务接口:DescribeOssResultItems

您可以调用该接口分页显示OSS违规检测的检测结果。关于如何构造HTTP请求,请参见请求结构;您也可以直接选用已构造好的HTTP请求,更多信息,请参见SDK概览

计费信息:该接口为免费接口。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

请求参数

关于在请求中必须包含的公共请求参数,请参见公共参数

请求body是一个结构体,结构说明如下:
名称 类型 是否必选 示例值 描述
PageSize Integer 20 每页显示的结果数量。
CurrentPage Integer 1 当前页码。
StartDate String 2018-09-04 14:17:56 +0800 要查询的起始时间,格式为:yyyy-MM-dd HH:mm:ss Z
EndDate String 2018-10-04 14:17:56 +0800 要查询的结束时间,格式为:yyyy-MM-dd HH:mm:ss Z
Scene String porn 要查询的检测场景,取值:
  • porn:涉黄
  • terrorism:涉政
Suggestion String block 要查询的结果建议类型。取值:
  • block:建议直接拦截
  • review:建议人工审核
  • pass:建议直接放行
说明Stocktrue时必填。
Stock Boolean true 是否查询存量扫描结果。
  • true:表示查询存量扫描结果。
  • false:表示查询增量扫描结果。
MinScore Float 90.01 (仅适用于图片对象)要查询的结果的最低风险分值。
MaxScore Float 99.01 (仅适用于图片对象)要查询的结果的最高风险分值。
ResourceType String VIDEO 要查询的对象类型,取值:
  • IMAGE:图片对象
  • VIDEO:视频对象
Bucket String 123 要查询的OSS的Bucket名称。
QueryId String @guid 要查询的检测请求ID。

返回数据

关于返回结果说明,请参见返回结果

返回body中的Data字段是JSON数组,每一个元素包含如下字段:
名称 类型 示例值 描述
TotalCount Integer 2 结果总数。
PageSize Integer 20 分页大小。
CurrentPage Integer 1 当前页码。
ScanResultList JSONArray xxx 扫描结果列表。详细信息,请参见ScanResultList
表 1. ScanResultList
名称 类型 示例值 描述
Id String 1235789 扫描结果的唯一标识。
TaskId String 222222 任务ID。
DataId String srffdffdfd2 数据ID。
SequestTime String 1527410977000 请求时间。
ScanFinishedTime String 1527410977000 扫描完成时间。
RequestTime String 1527410977000 请求时间。
Suggestion String review 建议您执行的后续操作,取值:
  • pass:结果正常,无需进行其余操作。
  • review:结果不确定,需要进行人工审核。
  • block:结果违规,建议直接删除或者限制公开。
NewUrl String https://example.com/bao/uploaded/LB1Q7lIoIbI8KJjy1zdXXbe1VXa.mp4 原始文件链接地址。
Thumbnail String https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png 缩略图链接。
  • 图片对象链接到图片缩略图。
  • 视频对象链接到视频第一帧的缩略图。
CreateTime String 1527410977000 扫描时间。
Bucket String uc-image 资源所在的OSS Bucket。
Object String post/image/eae1722368b6951ac05cfb68b1cdeb03.jpg OSS Object名称。
Score Float 90.9 资源的风险分值,取值:0~100。分值越高,违规可能越大。
HandleStatus Integer 0 资源的处理状态,取值:
  • 0:未处理
  • 1:删除
  • 2:忽略
  • 3:解冻
  • 4:屏蔽
  • 10:已处理
ResourceStatus Integer 1 资源的状态,取值:
  • 0:已删除
  • 1:已冻结
  • 2:可用
FrameResults JSONArray [{"Thumbnail":"https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png","Offset":0,"Url":"https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png"}] (仅使用视频对象)存在风险的问题帧。详细信息,请参见FrameResults
表 2. FrameResults
名称 类型 示例值 描述
Thumbnail String https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png 该帧的缩略图链接。
Offset String 0 该帧的位置,即距离视频开头的偏移量,单位为秒。
Url String https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png 该帧的链接。

示例

请求示例
{
  "Scene": "porn",
  "Suggestion": "block",
  "Stock": true,
  "ResourceType": "VIDEO"
}
返回示例
{
  "code": "200",
  "data": {
    "TotalCount": 2,
    "PageSize": 20,
    "CurrentPage": 1,
    "ScanResultList": [
      {
        "Id": 1235789,
        "TaskId": "222222",
        "DataId": "srffdffdfd2",
        "SequestTime": "1527410977000",
        "ScanFinishedTime": "1527410977000",
        "RequestTime": "1527410977000",
        "Suggestion": "review",
        "NewUrl": "https://example.com/bao/uploaded/LB1Q7lIoIbI8KJjy1zdXXbe1VXa.mp4",
        "Thumbnail": "https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png",
        "CreateTime": "1527410977000",
        "Bucket": "uc-image",
        "Object": "post/image/eae1722368b6951ac05cfb68b1cdeb03.jpg",
        "Score": 90.9,
        "HandleStatus": 0,
        "ResourceStatus": 1,
        "FrameResults": [
          {
            "Thumbnail": "https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png",
            "Offset": 0,
            "Url": "https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png"
          }
        ]
      },
      {
        "Id": 123579,
        "TaskId": "222222",
        "DataId": "srffdffdfd2",
        "SequestTime": "1527410977000",
        "ScanFinishedTime": "1527410977000",
        "RequestTime": "1527410977000",
        "Suggestion": "review",
        "NewUrl": "https://example.com/bao/uploaded/LB1Q7lIoIbI8KJjy1zdXXbe1VXa.mp4",
        "Thumbnail": "https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png",
        "CreateTime": "1527410977000",
        "Bucket": "uc-image",
        "Object": "post/image/eae1722368b6951ac05cfb68b1cdeb03.jpg",
        "Score": 90.9,
        "HandleStatus": 0,
        "ResourceStatus": 1,
        "FrameResults": [
          {
            "Thumbnail": "https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png",
            "Offset": 0,
            "Url": "https://example.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png"
          }
        ]
      }
    ]
  },
  "requestId": "@guid",
  "successResponse": true
}