有奖捉虫:云通信与企业服务文档专题,速来> HOT

功能描述

您可通过本接口反馈与预期不符的审核结果,例如色情文本被审核判定为正常或正常文本被判定为色情时可通过该接口直接反馈。
本接口不会直接修改审核结果,您反馈的错误审核结果将在后台进行确认,并在后续的审核任务中生效。

授权说明

授权策略中 action 设置为 ci:ReportBadCase 。查看所有 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

推荐使用 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>
<Text></Text>
<SuggestedLabel></SuggestedLabel>
<Label></Label>
</Request>
具体的数据描述如下:
节点名称(关键字)
父节点
描述
类型
是否必选
Request
反馈审核错误的具体参数
Container
Container 类型 Request 的具体数据描述如下:
节点名称(关键字)
父节点
描述
类型
是否必选
ContentType
Request
需要反馈的数据类型,错误文本样本取值为1。
Integer
Text
Request
文本类型的样本,需要填写 base64 的文本内容,ContentType 为1时必填。
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>
<Text>6L+Z5piv5Li65LuA5LmI</Text>
<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>