网站解决方案-主站检测任务更新接口

2024.05.08 20:38:59

    网站解决方案-主站检测任务更新接口用于未开始的任务更新。

    接口描述

    该接口为网站检测任务更新接口,支持HTTP协议接口调用。支持一次性检测任务和周期性检测任务。

    检测数据要求

    待检测的网站必须是外网可以访问的,且网站的响应时间不能过长,否则容易导致页面爬取超时。

    鉴权说明

    易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5、SHA1、SHA256、SM3几种加密算法,详细信息,请参见接口鉴权

    接口地址

    名称
    HTTP URL https://as.dun.163.com/v1/crawler/job/update
    HTTP Method POST

    请求头

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

    请求参数

    请求参数由公共参数和业务参数两部分组成。

    公共参数

    公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数

    业务参数

    名称 类型 必填 最大长度 描述
    version String 4 接口版本号,可选值v1.0
    jobId Number Y 13 需要更新的任务的id,只有未开始的任务才支持更新
    siteUrl String N 1024 主站URL,网站检测的入口,URL必须是外网可访问的,且以http开头
    siteName String N 64 网站名称
    sliceStartTime Number N 13 任务开始时间。必须大于当天的开始时间

    请求体示例

    {
        "jobId": "16336803080311",
        "siteUrl": "http://xxxxx",
        "sliceStartTime": "1633680287444",
        "signature": "cf0b18c7250cb54ea513b176db67e5aa",
        "secretId": "xxx2",
        "signatureMethod": "MD5",
        "version": "v1.0",
        "nonce": "1633680308031",
        "timestamp": "1633680308030"
    }
    

    响应

    响应结果

    没有单独的业务响应字段,根据code码来判断是否成功即可,响应公共字段已省略,详细见响应公共字段

    响应体示例

    {
        "code": 200,
        "msg": "ok"
    }
    

    响应返回码

    响应返回码见:响应返回码

    Online Chat Tel:95163223 Free trial