功能描述
您可通过本接口反馈与预期不符的审核结果,例如色情图片被审核判定为正常或正常图片被判定为色情时可通过该接口直接反馈。
本接口不会直接修改审核结果,您反馈的错误审核结果将在后台进行确认,并在后续的审核任务中生效。
推荐使用 SDK
数据万象 SDK 提供了完整的 Demo、自动集成、计算签名等能力。您可通过 SDK 方便快捷地调用接口。点此查看 SDK 文档。
请求
请求示例
POST /report/badcase HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml
<body>
说明:
请求头
此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。
请求体
该请求操作的实现需要有如下请求体。
<Request>
<ContentType></ContentType>
<JobId></JobId>
<ModerationTime></ModerationTime>
<Url></Url>
<SuggestedLabel></SuggestedLabel>
<Label></Label>
</Request>
具体的数据描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
---|---|---|---|---|
Request | 无 | 反馈审核错误的具体参数 | Container | 是 |
Container 类型 Request 的具体数据描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
---|---|---|---|---|
ContentType | Request | 需要反馈的数据类型,反馈图片错误样本,取值为2。 | Integer | 是 |
Url | Request | 图片类型的样本,需要填写图片的 url 链接,ContentType 为2时必填。 | String | 否 |
Label | Request | 数据万象审核判定的审核结果标签,例如 Porn。 | String | 是 |
SuggestedLabel | Request | 您自己期望的正确审核结果的标签,例如期望是正常,则填 Normal。 | String | 是 |
JobId | Request | 该数据样本对应的审核任务 ID,有助于定位审核记录。 | String | 否 |
ModerationTime | Request | 该数据样本之前审核的时间,有助于定位审核记录。 格式为 2021-08-07T12:12:12+08:00 | String | 否 |
响应
响应头
此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。
响应体
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response>
<RequestId></RequestId>
</Response>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
---|---|---|---|
Response | 无 | 返回的具体响应内容 | Container |
Container 节点 Response 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
---|---|---|---|
RequestId | Response | 每次请求发送时,服务端将会自动为请求生成一个 ID,遇到问题时,该 ID 能更快地协助定位问题 | String |
错误码
该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。
实际案例
请求
POST /report/badcase HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1********&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff9050055********
Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com
Content-Length: 66
Content-Type: application/xml
<Request>
<ContentType>1</ContentType>
<Url>http://www.example.com/abc.jpg</Url>
<Label>Porn</Label>
<SuggestedLabel>Normal</SuggestedLabel>
</Request>
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 230
Connection: keep-alive
Date: Thu, 15 May 2022 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
<Response>
<RequestId>xxxxxxxxxxxxxx</RequestId>
</Response>