执行任务以及上报进度或结果 - 接口文档

第三方应用开发服务端API 数据分析专区专区接口执行任务以及上报进度或结果

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

最后更新：2024/01/11

任务执行说明：

同一个任务只允许一个pod执行。若任务超时或者执行该任务的pod出问题，服务商可通过创建任务接口重新创建任务进行重试。

不同场景调用说明：

（1）开始执行任务：status=1
（2）更新任务进度：status=1, progress = 10
（3）任务完成：status=2，result="xx"

请求方式： POST（HTTPS）
请求地址： https://specapi.weixin.qq.com/spec/exec_and_report_job?access_token=xxx
请求header说明： 参考专区接口调用说明

{
	"jobid": "aaaabbbccc",
	"status":1,
	"progress": 10,
	"result":{
	     "job_type":"xxxx",
	      "data": "{\"items\":[{\"id\":1,\"value\":\"1234567890\"}]}"
	}
}

参数说明：

参数	必须	说明
access_token	是	数据分析专区接口调用凭证
jobid	是	任务ID
status	是	任务状态，1：执行任务 2：完成
progress	否	任务进度百分比，[0-99], 仅当status为1时，更新任务进度，否则忽略
result	否	任务结果，仅当status为2时有效。详见Result结构说明

Result结构说明：

参数	必须	说明
job_type	是	任务类型，服务商管理端创建得到的字符串类型
data	是	任务结果数据，参考data说明。仅当status为2时才更新任务结果，否则忽略。结果大小上限为10*任务中消息条数，若超过该长度则会报错。最多支持10k个字节

data说明：
data对应的值为镜像中的任务输出协议：
enter image description here

示例请求包中对应的输出协议为：

package specapi;

message Item {
    optional uint32 id = 1;
    optional string value = 2;
}
message Result {
    repeated Item items = 1;
}

请求回包

{
	"errcode":0,
	"errmsg":"ok"
}

参数说明：

参数	类型	说明
errcode	int	错误码
errmsg	string	错误描述

轮训获取任务

拉取消息

本节内容

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