获取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：建议直接放行说明当Stock为true时必填。
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://gw.alicdn.com/bao/uploaded/LB1Q7lIoIbI8KJjy1zdXXbe1VXa.mp4	原始文件链接地址。
Thumbnail	String	https://img.alicdn.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://img.alicdn.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png","Offset":0,"Url":"https://img.alicdn.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png"}]	（仅使用视频对象）存在风险的问题帧。详细信息，请参见FrameResults

表 2. FrameResults
名称	类型	示例值	描述
Thumbnail	String	https://img.alicdn.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png	该帧的缩略图链接。
Offset	String	0	该帧的位置，即距离视频开头的偏移量，单位为秒。
Url	String	https://img.alicdn.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://gw.alicdn.com/bao/uploaded/LB1Q7lIoIbI8KJjy1zdXXbe1VXa.mp4",
        "Thumbnail": "https://img.alicdn.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://img.alicdn.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png",
            "Offset": 0,
            "Url": "https://img.alicdn.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png"
          }
        ]
      },
      {
        "Id": 123579,
        "TaskId": "222222",
        "DataId": "srffdffdfd2",
        "SequestTime": "1527410977000",
        "ScanFinishedTime": "1527410977000",
        "RequestTime": "1527410977000",
        "Suggestion": "review",
        "NewUrl": "https://gw.alicdn.com/bao/uploaded/LB1Q7lIoIbI8KJjy1zdXXbe1VXa.mp4",
        "Thumbnail": "https://img.alicdn.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://img.alicdn.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png",
            "Offset": 0,
            "Url": "https://img.alicdn.com/tfs/TB1HPS9qb9YBuNjy0FgXXcxcXXa-200-200.png"
          }
        ]
      }
    ]
  },
  "requestId": "@guid",
  "successResponse": true
}