生成异步上传任务

POST

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

概述

为了满足临时素材的大文件诉求（最高支持200M），支持指定文件的CDN链接（必须支持Range分块下载），由企微微信后台异步下载和处理，处理完成后回调通知任务完成，再通过接口主动查询任务结果。

跟普通临时素材一样，media_id仅三天内有效，media_id在同一企业内应用之间可以共享。

使用场景说明

跟上传临时素材拿到的media_id使用场景是不通用的，目前适配的接口如下：

接口	适用场景值(scene)	说明
获取临时素材	所有	若文件大小超过`20M`，必须使用`Range`分块下载且分块大小不超过`20M`，否则返回错误`830002`
入群欢迎语素材管理	`1`	添加素材、编辑素材兼容`video`和`file`两种素材类型使用；获取素材返回的media_id类型则跟添加/编辑时的media_id类型对应

上传的媒体文件限制

所有文件size必须大于5个字节

图片（image）：暂不支持

语音（voice）：暂不支持

视频（video）：200MB，仅支持MP4格式

普通文件（file）：200MB

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/media/upload_by_url' \
--header 'Content-Type: application/json' \
--data-raw '{
    "scene": 1,
    "type": "video",
    "filename": "video.mp4",
    "url": "https://xxxx",
    "md5": "MD5"
}'

响应示例

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

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

scene

integer

必需

场景值。1-客户联系入群欢迎语素材（目前仅支持1）。 注意：每个场景值有对应的使用范围，详见上面的「使用场景说明」

type

string

必需

媒体文件类型。目前仅支持video-视频，file-普通文件 不超过32字节。

filename

string

必需

文件名，标识文件展示的名称。比如，使用该media_id发消息时，展示的文件名由该字段控制。不超过128字节。

url

string

必需

文件cdn url。url要求支持Range分块下载不超过1024字节。

md5

string

必需

文件md5。对比从url下载下来的文件md5是否一致。不超过32字节。

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

errmsg

string

必需

jobid

string

必需

任务id。可通过此jobid查询结果

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

查询异步任务结果

上传临时素材

生成异步上传任务

概述#

使用场景说明#

上传的媒体文件限制#

请求参数

返回响应

概述

使用场景说明

上传的媒体文件限制