获取临时素材
GET
/cgi-bin/media/get
服务端API企业内部开发第三方应用开发智慧硬件开发
完全公开,media_id在同一企业内所有应用之间可以共享。
正确时返回(和普通的http下载相同,请根据http头做相应的处理):
HTTP/1.1 200 OK Connection: close Content-Type: image/jpeg Content-disposition: attachment; filename="MEDIA_ID.jpg" Date: Sun, 06 Jan 2013 10:20:18 GMT Cache-Control: no-cache, must-revalidate Content-Length: 339721 Xxxx
{ "errcode": 40007, "errmsg": "invalid media_id"}
附注:支持断点下载(分块下载)
Range
来分块下载。在文件很大,可能下载超时的情况下,推荐使用分块下载。
以curl命令进行测试为例,假如我有一个2048字节的文件,
下面是获取文件前1024字节:
curl ‘https://qyapi.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID’ -i -H “Range: bytes=0-1023”
GET /cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID HTTP/1.1
Host: qyapi.weixin.qq.com
Range: bytes 0-1023
HTTP/1.1 206 Partial Content
Accept-Ranges: bytes
Content-Range: bytes 0-1023/2048
Content-Length: 1024
…
(1024 Bites binary content)
206 Partial Content
,而非200 ok
Accept-Ranges
首部表示可用于定义范围的单位Content-Range
首部表示这一部分内容在整个资源中所处的位置原文档地址:
https://open.work.weixin.qq.com/api/doc/90000/90254
https://open.work.weixin.qq.com/api/doc/90001/90390
https://open.work.weixin.qq.com/api/doc/90002/90872
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://qyapi.weixin.qq.com/cgi-bin/media/get'
响应示例响应示例
{
"errcode": 40007,
"errmsg": "invalid media_id"
}
请求参数
Query 参数
media_id
可选
示例值:
media_id
access_token
调用接口凭证
示例值:
{{accesstoken}}
返回响应
修改于 2022-01-14 04:25:43