公众号检测任务创建接口
2024.09.02 17:59:14
接口说明
该接口支持创建公众号检测任务，并支持数据回调。
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权。
请求
| 名称 | 值 |
|---|---|
| HTTP URL | http://as.dun.163.com/v1/official-accounts/job/submit |
| HTTP Method | POST |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Content-Type | String | Y | 固定值："application/x-www-form-urlencoded" |
请求参数
公共参数
公共参数包含密钥信息和参数签名信息，公共参数详细见请求公共参数。
业务参数
| 名称 | 类型 | 必填 | 最大长度 | 描述 |
|---|---|---|---|---|
| version | String | Y | 4 | 接口版本v1.0 |
| dataId | String | N | 128 | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
| wechatAccount | String | Y | 64 | 微信号 |
| officialAccountName | String | N | 64 | 公众号名称 |
| strategy | Number | N | 4 | 公众号爬取策略，默认值3， 1-单测检测，全量爬取，2-循环检测，首次全量爬取,后续增量，3-单测检测，特定范围文章，4-循环检测，仅检测更新文章。注意，此字段与公众号任务类型关联 |
| maxCheckCount | Number | N | 11 | 最大检测数量，默认值10， 0代表不限制，当爬虫策略strategy为3时必填 |
| checkFlags | Array | N | 检测内容，默认为1和2，1-检测文本，2-检测图片 | |
| type | Number | N | 4 | 公众号任务类型，默认为4，4-公众号单次检测任务，5-公众号循环检测任务 |
| startTime | Number | N | 11 | 循环爬虫时间区间--开始时间, 当爬虫任务类型type=5时必填 |
| endTime | Number | N | 11 | 循环爬虫时间区间--结束时间, 当爬虫任务类型type=5时必填 |
| callbackUrl | String | N | 1024 | 异步结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。 |
请求体示例
dataId=任务提交dataId
&wechatAccount=xxx
&strategy=3
&maxCheckCount=10
&checkFlags=1，2
&type=4
&signature=xxx
&secretId=xxx
&version=v1.0
响应
响应结果
| 名称 | 类型 | 必须返回 | 描述 |
|---|---|---|---|
| result | Object | Y | 融媒体提交结果 |
| ∟jobId | Number | Y | 本次创建的任务id，根据任务id可以查看任务信息 |
| ∟taskId | String | Y | 本次请求数据标识，可以根据该标识查询数据最新结果 |
| ∟dataId | String | N | 上传数据唯一标识，能够根据该值定位到该条数据，如对数据结果有异议，可以发送该值给策略经理查询 |
响应体示例
{
"code": 200,
"msg": "ok",
"result": {
"jobId": 123456789,
"dataId": "123",
"taskId": "xae23xdakieooxide23x9xoq"
}
}
响应返回码
响应返回码见：响应返回码
