微信企業(yè)號(hào)開發(fā)之如何管理多媒體文件
企業(yè)在使用接口時(shí)，對(duì)多媒體文件、多媒體消息的獲取和調(diào)用等操作，是通過media_id來進(jìn)行的。通過本接口，企業(yè)可以上傳或下載多媒體文件。
注意，每個(gè)多媒體文件（media_id）會(huì)在上傳到微信服務(wù)器3天后自動(dòng)刪除，以節(jié)省服務(wù)器資源。
一、上傳媒體文件
用于上傳圖片、語音、視頻等媒體資源文件以及普通文件（如doc，ppt），接口返回媒體資源標(biāo)識(shí)ID：media_id。請(qǐng)注意，media_id是可復(fù)用的，同一個(gè)media_id可用于消息的多次發(fā)送。
- 請(qǐng)求說明
Https請(qǐng)求方式: POST
https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
- 參數(shù)說明
| 參數(shù) | 必須 | 說明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| type | 是 | 媒體文件類型，分別有圖片（image）、語音（voice）、視頻（video），普通文件(file) |
| media | 是 | form-data中媒體文件標(biāo)識(shí)，有filename、filelength、content-type等信息 |
- 權(quán)限說明
完全公開。所有管理員均可調(diào)用，media_id可以共享。
- 返回說明
- {
- "type": "image",
- "media_id": "0000001",
- "created_at": "1380000000"
- }
| 參數(shù) | 說明 |
|---|---|
| type | 媒體文件類型，分別有圖片（image）、語音（voice）、視頻（video）,普通文件(file) |
| media_id | 媒體文件上傳后獲取的***標(biāo)識(shí) |
| created_at | 媒體文件上傳時(shí)間戳 |
- 上傳的媒體文件限制
圖片（image）:1MB，支持JPG格式
語音（voice）：2MB，播放長度不超過60s，支持AMR格式
視頻（video）：10MB，支持MP4格式
普通文件（file）：10MB
二、獲取媒體文件
通過media_id獲取圖片、語音、視頻等文件。
- 請(qǐng)求說明
Https請(qǐng)求方式: GET
https://qyapi.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
- 參數(shù)說明
| 參數(shù) | 必須 | 說明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| media_id | 是 | 媒體文件id |
- 權(quán)限說明
完全公開。所有管理員均可調(diào)用，media_id可以共享。
- 返回結(jié)果
a)正確時(shí)返回：
- {
- 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
- }
b)錯(cuò)誤時(shí)返回（這里省略了HTTP首部）：
- {
- "errcode": "40004",
- "errmsg": "invalid media_id"
- }
