主站检测任务结果获取-主动回调

2021.12.03 11:40:09

    主站检测任务结果获取接口,用于将网站任务机器检测结果主动推送给客户。客户需要按照以下规范实现接收结果的接口。

    接口说明

    结果主动推送模式以数据为维度,将机器检测结果推送给客户,需客户在调用网站任务接口时设置回调地址callbackUrl参数,客户方需保证回调接收接口的可用性和稳定性,确保能正常接收推送过来的结果数据。

    鉴权说明

    客户接口可以通过业务开通时易盾分配的密钥信息字段进行接口鉴权,鉴权粒度是否要精确到业务级别,用户可以根据需要自行决定,请参见接口鉴权

    接入说明

    • 协议说明:检测接口请求参数中指定了回调地址参数callbackUrl(即一个http(s)协议接口的URL)。主动推送接口需要支持http协议,支持POST方法,传输数据编码采用utf-8
    • 接口性能:推送结果接口默认超时时间为2s,为了保证顺利接收数据,客户需保证接收接口可用性和性能稳定
    • 失败重试:客户接口处理结果数据,并返回应答。如果客户接口请求异常,超时或收到的应答不符合规范,易盾会认为推送失败;我们将每隔10分钟推送一次,如果一直失败,持续一天后不再推送
    • 幂等性:结果推送时同样的结果可能会多次请求客户接口。客户接口需要保证幂等性,能够正确处理重复结果数据

    接口耗时

    客户接收接口需保证接收接口可用性和性能稳定,易盾请求超时时间为2s,客户接口尽量保证在1s内返回应答,如有特殊要求,可联系易盾运营适当调整超时时间

    请求

    请求地址

    名称
    HTTP URL 回调地址callbackUrl
    HTTP Method POST

    请求头

    名称 类型 必填 描述
    Content-Type String 固定值:"application/x-www-form-urlencoded"

    请求参数

    名称 类型 必填 描述
    secretId String 产品秘钥 id ,由易盾内容安全云服务分配,产品标识
    signature String 请求签名,用来验证此次请求的合法性,具体算法见接口鉴权
    callbackData Object 主动推送结果数据,格式为json字符串
     ∟antispam Object 主动推送结果数据,格式为json字符串
      ∟jobId Number 创建网站任务时返回的任务id
      ∟checkStatus Number 检测状态: 2-检测成功,3-检测失败
      ∟checkTime Number 检测时间,格式为毫秒时间戳,如:1634204125521
      ∟siteUrl String 检测主站url
      ∟reportUrl String 网站检测报告url,检测失败数据无此结果
      ∟suggestion Number 建议动作:0-通过,1-嫌疑,2-不通过,检测失败数据无此结果
      ∟totalUrlCount Number 检测总url数量
      ∟suspectUrlCount Number 嫌疑url数量
      ∟unPassUrlCount Number 不通过url数量
      ∟labels Object[] 命中的分类信息
       ∟label Number 命中的分类信息,详细编码见下方label值

    labels 数据结构

    参数名称 类型 描述
    label Number 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,600:谩骂,700:灌水,800:恶心类,900:其他,1100:涉价值观

    请求体示例

    callbackData=***&signature=xxx&secretId=xxx&businessId=xxx
    

    请求体callbackData格式如下,callbackData为json字符串格式,请自行解析或者反转成json对象使用

    {
        "antispam": {
            "checkStatus": 2,
            "checkTime": 1634204125521,
            "jobId": "107986",
            "labels": [
                {
                    "label": 300
                }
            ],
            "reportUrl": "https://nos.netease.com/yidun/1234567.xlsx",
            "siteUrl": "http://123.com/site.html",
            "suggestion": 1,
            "suspectUrlCount": 1,
            "totalUrlCount": 35,
            "unPassUrlCount": 0
        }
    }
    

    响应

    响应结果

    客户接口接收到我们回调的结果后,需要返回应答信息,接口响应HTTP状态码为200,当回调处理异常时,应答的HTTP状态码应为500,或者4xx; 应答信息为json格式,字段定义如下:

    名称 类型 必须返回 描述
    code Number 应答code,易盾方解析code为200表示推送成功
    msg String 具体描述信息

    响应体示例

    { 
        "code": 200, 
        "msg": "接收成功"
    }
    
    Online Chat Tel:95163223