轮训获取任务 - 接口文档 - 企业微信开发者中心

第三方应用开发服务端API 数据分析专区专区接口轮训获取任务

轮训获取任务

最后更新：2024/01/11

通过该接口轮训到未执行的任务。
按任务创建时间排序，优先取创建时间最早的未执行的任务

请求方式： 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	任务自定义数据

获取数据分析专区接口调用凭证

执行任务以及上报进度或结果

本节内容

轮训获取任务