公众号检测任务创建接口

2022.12.08 11:08:48

    接口说明

    该接口支持创建公众号检测任务,并支持数据回调

    鉴权说明

    易盾内容安全服务使用签名方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(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 请求时提交的dataId

    响应体示例

    {
        "code": 200,
        "msg": "ok",
        "result": {
            "jobId": 123456789,
            "dataId": "123",
            "taskId": "xae23xdakieooxide23x9xoq"
        }
    }
    

    响应返回码

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

    Online Chat Tel:95163223