网站解决方案-主站检测任务更新接口
2024.09.02 17:59:14
网站解决方案-主站检测任务更新接口用于未开始的任务更新。
接口描述
该接口为网站检测任务更新接口，支持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"
}
响应返回码
响应返回码见：响应返回码
