通过该接口轮训到未执行的任务。
按任务创建时间排序,优先取创建时间最早的未执行的任务
请求方式: POST(HTTPS)
请求地址: https://specapi.weixin.qq.com/spec/list_job?access_token=XXX
请求header说明: 参考 专区接口调用说明,该接口header中不需要传auth-corpid
{
"limit":10,
"cursor":"xxx",
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 数据分析专区接口调用凭证 |
limit | 否 | 每次拉取的数量上限,默认为100 |
cursor | string | 分页游标,分页拉取时,为回包中的next_cusor字段,拉取首页可不填 |
请求回包
{
"errcode":0,
"errmsg":"ok",
"has_more":true,
"job_list": [
{
"jobid": "aaaaaaaaaa1",
"auth_corpid":"xxx",
"create_time": 1672502400,
"custom_data": "CUSTOM_DATA"
},
{
"jobid": "aaaaaaaaaa2",
"auth_corpid":"xxx",
"create_time": 1672502400,
"custom_data": "CUSTOM_DATA"
}
]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int | 错误码 |
errmsg | string | 错误描述 |
has_more | bool | 该次是否已经拉取结束 |
next_cursor | string | 分页游标,用于拉取下一页时的cursor字段 |
job_list | Job列表 | 任务列表 |
Job结构体说明
参数 | 类型 | 说明 |
---|---|---|
jobid | 任务id | string |
auth_corpid | 任务所属授权企业corpid | string |
create_time | uint32 | 任务提交时间 |
custom_data | string | 任务自定义数据 |