查询异步任务结果

POST

https://qyapi.weixin.qq.com/cgi-bin/media/get_upload_by_url_result

权限说明：

客户联系权限

任务结果常见错误码列表（`detail.errcode`）

错误码	错误说明	排查方法
830001	url非法	确认url是否支持`Range`分块下载
830003	url下载数据失败	确认url本身是否能正常访问
45001	文件大小超过限制	确认文件在5字节~200M范围内
301019	文件MD5不匹配	确认url对应的文件内容md5，跟所填的md5参数是否一致

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/media/get_upload_by_url_result' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jobid": "JOBID"
}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "status": 2,
  "detail": {
    "errcode": 0,
    "errmsg": "ok",
    "media_id": "3*1*G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
    "created_at": "1380000000"
  }
}

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

jobid

string

必需

任务id。最长为128字节，60分钟内有效

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

错误码描述

必需

status

integer

必需

任务状态。1-处理中，2-完成，3-异常失败

detail

object

结果明细

必需

errcode

integer

必需

任务失败返回码。当status为3时返回非0，其他返回0

errmsg

string

任务失败错误码描述

必需

media_id

string

必需

媒体文件上传后获取的唯一标识，3天内有效。当status为2时返回。

created_at

string

必需

媒体文件创建的时间戳。当status为2时返回。

修改于 2022-12-01 07:07:12

回调异步任务结果

生成异步上传任务

查询异步任务结果

任务结果常见错误码列表（detail.errcode）#

请求参数

返回响应

任务结果常见错误码列表（`detail.errcode`）