Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
企业内部开发智慧硬件开发
第三方应用开发
企业内部开发智慧硬件开发
第三方应用开发
  1. 素材管理
  • 开发指南
    • 回调配置
      • 虚拟业务信息查询接口
    • 获取服务商凭证
      POST
  • 消息推送
    • 接收消息与事件
      • 概述
        • 概述-验证URL有效性
        • 概述-获取企业微信服务器的ip段
        • 概述-使用接收消息
    • 发送应用消息
      POST
    • 更新模版卡片消息
      POST
  • 通讯录管理
    • 成员管理
      • 创建成员
      • 读取成员
      • 更新成员
      • 删除成员
      • 批量删除成员
      • 获取部门成员
      • 获取部门成员详情
      • userid与openid互换-userid转openid
      • userid与openid互换-openid转userid
      • 二次验证
      • 邀请成员
    • 部门管理
      • 创建部门
      • 更新部门
      • 删除部门
      • 获取部门列表
    • 标签管理
      • 创建标签
      • 更新标签名字
      • 删除标签
      • 获取标签成员
      • 增加标签成员
      • 删除标签成员
      • 获取标签列表
    • 异步批量接口
      • 增量更新成员
      • 全量覆盖成员
      • 全量覆盖部门
      • 获取异步任务结果
  • 应用管理
    • 获取应用-获取指定的应用详情
      GET
    • 获取应用-获取access_token对应的应用列表
      GET
  • 素材管理
    • 上传临时素材
      POST
    • 上传图片
      POST
    • 获取临时素材
      GET
    • 获取高清语音素材
      GET
  • OA数据接口
    • 审批流程引擎
      POST
  • 电子发票
    • 查询电子发票
      POST
    • 更新发票状态
      POST
    • 批量更新发票状态
      POST
    • 批量查询电子发票
      POST
  • 推广二维码
    • 回调通知
      • 注册完成回调事件
    • 调用接口
      • 获取注册码
      • 查询注册状态
      • 设置授权应用可见范围
      • 设置通讯录同步完成
  • 应用授权
    • 接口调用
      • 获取第三方应用凭证
      • 获取预授权码
      • 设置授权配置
      • 获取企业永久授权码
      • 获取企业授权信息
      • 获取企业凭证
      • 获取应用的管理员列表
    • 回调接口
      • 标签通知事件 标签成员变更事件
  • 身份验证
    • 网页授权登录
      • 获取访问用户身份
      • 获取访问用户敏感信息
    • 扫码授权登录
      • 获取登录用户信息
  • 设备管理
    • 接口调用
      • 添加设备实例
      • 查询设备绑定信息
      • 重置设备SecretNo
      • 获取设备列表
      • 上传设备日志
      • 获取设备自定义参数
      • 删除设备实例
      • 设置打印机支持状态
  1. 素材管理

获取临时素材

GET
http://127.0.0.1/cgi-bin/media/get
智慧硬件开发/素材管理
最后修改时间:2022-08-30 03:03:35
责任人:未设置
权限说明:
完全公开,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
错误时返回(这里省略了HTTP首部):
{   "errcode": 40007,   "errmsg": "invalid media_id"}

附注:支持断点下载(分块下载)#

本接口支持通过在http header里指定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”
生成如下http请求:
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
服务器端会返回状态码为 206 Partial Content 的响应:
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
返回的header中,Accept-Ranges首部表示可用于定义范围的单位
返回的header中,Content-Range首部表示这一部分内容在整个资源中所处的位置
更多协议详情参考RFC: Range Requests
文档ID: 10115
原文档地址:
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

请求参数

Query 参数
media_id
string 
可选
媒体文件id, 见上传临时素材
示例值:
media_id
access_token
string 
调用接口凭证
可选
示例值:
{{accesstoken}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1/cgi-bin/media/get'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
上一页
上传图片
下一页
获取高清语音素材
Built with