数美天净通用纠错 API 接口说明文档#

文档相关名词说明#

必传参数：使用数美接口服务时，接口使用者必须传入的参数，否则将导致该接口服务无法正常使用；

强烈建议：使用数美接口服务时，强烈建议接口使用者传入的参数并可大幅度提高识别准确率；

可选：使用数美接口服务时，建议接口使用者传入的参数并可在特定的场景下提高识别准确率。

请求 Header 参数如下：

参数名称	类型	是否必选	说明
X-Accesskey	string	必须参数	用于权限认证，开通账号服务时由数美提供

接口描述

该接口用于提供所有天净服务的纠错功能，支持近 2 天的请求数据纠错。

本接口所纠错的数据不进入名单

字符编码：UTF-8

请求方法：POST

建议超时时长：1s

请求参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下：

请求参数名	类型	参数说明	传入说明	备注
requestId	string	回调请求唯一标识，与数美服务返回结果中的 requestId 对应	必传参数
serviceId	string	所属的天净服务	必选参数
type	string	纠错类型	必传参数	可选值： error：误杀 miss：漏杀
riskType	int	内容风险类型，参考下方表格	可选	误杀：不传默认按 “正常” 处理漏杀：必传，默认按 “黑名单” 处理，部分服务无 “黑名单” 的按 “自定义”
timestamp	int	默认可以纠错 2 天内数据，如果需要纠错时间大于 2 天，必须传该参数	可选	该记录发生时间，13 位时间戳
account	string	调用接口的账号	可选	如：test@ishumei.com
appId	array	针对指定应用纠错，最多 3 个	可选	如：[“default”,“test”]
channel	array	针对指定渠道纠错，最多 3 个	可选
remark	string	客户纠错备注，用于后台展示	可选

其中，riskType 可供选择的内容参考其他服务的细分文档（所选风险类型必须与服务对应）

serviceId 取值如下：

返回参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下：

返回结果参数名	参数类型	参数说明	是否必返	备注
code	string	返回码	是
message	string	返回码详情描述	是

code 请求返回码列表如下：

示例

请求示例：

{
  "riskType": 100,
  "type": "miss",
  "serviceId": "POST_TEXT",
  "requestId": "xxx_a0000"
}

成功返回示例：

{
  "code": 1100,
  "message": "成功"
}

错误返回示例 1：

{
  "code": 1902,
  "message": "Accesskey 验证失败，请确认 Accesskey 是否正确"
}

错误返回示例 2：

{
  "code": 1902,
  "message": "反馈的记录不存在",
  "content": {
    "requestId": "e03c7fcfa38358cb12d9a49f0495f7b8"
  }
}