控制台指南

最佳实践

开发者指南

数据湖存储

API 文档

SDK 文档

文档捉虫大赛火热进行中,好礼多多> HOT

功能描述

您可通过本接口反馈与预期不符的审核结果,例如色情图片被审核判定为正常或正常图片被判定为色情时可通过该接口直接反馈。

本接口不会直接修改审核结果,您反馈的错误审核结果将在后台进行确认,并在后续的审核任务中生效。

推荐使用 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>

说明:

  • Authorization: Auth String(详情请参见 请求签名 文档)。
  • 通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求操作的实现需要有如下请求体。

<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>

目录