生成异步上传任务

POST

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

权限说明：

客户联系权限

上传的媒体文件限制

所有文件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-06 08:00:54

回调异步任务结果

查询异步任务结果

生成异步上传任务

上传的媒体文件限制#

请求参数

返回响应

上传的媒体文件限制