企业微信素材管理的使用

素材管理

使用场景

在使用企业微信API接口中，开发者需要使用自定义的资源，比如发送本地图片消息，设置通讯录自定义头像等。
为了实现资源文件，一次上传可以多次使用，提供了素材管理接口：以media_id来标识资源文件，实现文件的上传与下载。

上传临时素材

调试工具

素材上传得到media_id，该media_id仅三天内有效

media_id在同一企业内应用之间可以共享

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

1. 获取access_token

相当于创建了一个登录凭证，其它的业务API接口，都需要依赖于access_token来鉴权调用者身份

2. 上传临时素材文件

可以选择上传文件的类型

此处默认选择image

填入access_token

选择上传文件的类型

上传想要上传的文件

调用接口返回的数据如下

{
  "errcode":0,
  "errmsg":"ok",
  "type":"image",
  "media_id":"31d1e0gkY26St0YSZK0kgXnZO6pWEqDWCTCO4q-kHcW0",
  "created_at":"1627737122"
}

• media_id:媒体文件上传后获取的唯一标识，3天内有效
• created_at: 媒体文件上传时间戳

获得media_id: 31d1e0gkY26St0YSZK0kgXnZO6pWEqDWCTCO4q-kHcW0

3. 上传的媒体文件限制

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

• 图片（image）：2MB，支持JPG,PNG格式
• 语音（voice） ：2MB，播放长度不超过60s，仅支持AMR格式
• 视频（video） ：10MB，支持MP4格式
• 普通文件（file）：20MB

上传图片

调试工具

得到图片URL，该URL永久有效

仅能用于图文消息正文中的图片展示，或者给客户发送欢迎语等

注：若用于非企业微信环境下的页面，图片将被屏蔽。

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN

1. 获取access_token

与上传临时素材获取方法一致

2. 上传图片

填入access_token

选择需要上传的图片

调用接口返回值

{
  "errcode":0,
  "errmsg":"ok",
  "url":"https://wework.qpic.cn/wwpic/496678_-XVKHvLWS9ucJJ4_1627737613/0"
}

• errcode：返回码
• errmsg：对返回码的文字描述
• url：上传后得到的图片URL。永久有效

得到的url: https://wework.qpic.cn/wwpic/496678_-XVKHvLWS9ucJJ4_1627737613/0

上传后可通过url在浏览器中查看该图片

3. 上传的图片大小限制

图片文件大小应在 5B ~ 2MB 之间

获取临时素材

调试工具

请求方式：GET（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

1. 获取access_token

与上传临时素材获取方法一致

2. 获取临时素材

填入access_token

填入之前上传临时素材获得的media_id

(31d1e0gkY26St0YSZK0kgXnZO6pWEqDWCTCO4q-kHcW0)

调用接口后可获得之前上传临时素材

获取高清语音素材

方法与获取临时素材方法一致