公众号批量提交接口
2024.09.02 17:59:14
公众号检测任务批量创建接口
接口说明
该接口支持批量创建公众号检测任务
鉴权说明
易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5,SHA1,SHA256,SM3几种加密算法,详细信息,请参见接口鉴权
请求
名称 | 值 |
---|---|
HTTP URL | http://as.dun.163.com/v1/official-accounts/job/batch-submit |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | Y | 固定值:"application/x-www-form-urlencoded" |
请求参数
公共参数
公共参数包含密钥信息和参数签名信息,公共参数详细见请求公共参数
业务参数
名称 | 类型 | 必填 | 最大长度 | 描述 |
---|---|---|---|---|
version | String | Y | 4 | 接口版本v1.0 |
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,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。 |
officialAccounts | String | Y | 100个 | 批量提交的公众号信息,为json数组的字符串,数组长度不能超过100 |
∟dataId | String | N | 128 | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
∟wechatAccount | String | Y | 64 | 微信号 |
∟officialAccountName | String | N | 64 | 公众号名称 |
请求体示例
officialAccounts=[{"wechatAccount":"xxx","officialAccountName":"xxx"}]
&strategy=3
&maxCheckCount=10
&checkFlags=1,2
&type=4
&signature=xxx
&secretId=xxx
&version=v1.0
响应
响应结果
名称 | 类型 | 必须返回 | 描述 |
---|---|---|---|
result | Array | Y | 融媒体提交结果 |
∟jobId | Number | Y | 本次创建的任务id,根据任务id可以查看任务信息 |
∟taskId | String | Y | 本次请求数据标识,可以根据该标识查询数据最新结果 |
∟dataId | String | N | 上传数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给策略经理查询 |
响应体示例
{
"code": 200,
"msg": "ok",
"result": [{
"jobId": 123456789,
"dataId": "123",
"taskId": "xae23xdakieooxide23x9xoq"
}]
}
响应返回码
响应返回码见:响应返回码