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

接口描述

该接口为网站检测任务更新接口，支持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"
}

响应返回码

响应返回码见：响应返回码