# 获取小程序备案媒体材料
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
getIcpMedia
# 功能描述
用于小程序备案过程中获取所上传的图片或视频媒体材料。
# 注意事项
- 如果获取成功,则响应体中直接返回图片或视频内容,
Content-Type
为image/jpeg
或video/mp4
。如果获取失败,则响应体为 JSON,包含具体错误码和错误提示,Content-Type
为application/json; charset=UTF-8
。
# 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxa/icp/get_icp_media?access_token=ACCESS_TOKEN&media_id=MEDIA_ID
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:18、156
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用authorizer_access_token |
media_id | string | 是 | 上传小程序备案媒体材料接口返回的 media_id,示例值:4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7 |
# 返回参数
成功时直接返回图片或视频。失败时返回 JSON,包含以下字段:
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 调用示例
示例说明: 成功
# 请求数据示例
curl https://api.weixin.qq.com/wxa/icp/get_icp_media?access_token=access_token123456&media_id=media_id123456
# 返回数据示例
HTTP/1.1 200 OK
Server: openresty/x.x.x.x
Date: Wed, 07 Feb 2024 09:28:43 GMT
Content-Type: image/jpeg
Content-Length: 25083
Connection: close
<image_data>
示例说明: 失败
# 请求数据示例
curl https://api.weixin.qq.com/wxa/icp/get_icp_media?access_token=access_token123456&media_id=media_id654321
# 返回数据示例
HTTP/1.1 200 OK
Server: openresty/x.x.x.x
Date: Wed, 07 Feb 2024 09:32:39 GMT
Content-Type: application/json; charset=UTF-8
Content-Length: 78
Connection: close
{"errcode":86205,"errmsg":"media_id不合法 rid: xxxxxxxx-xxxxxxxx-xxxxxxxx"}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
86206 | 无权限访问该资源 | 请检查该media_id是否属于该小程序 |
86205 | media_id不合法 | 填入上传小程序备案媒体材料接口返回的合法media_id |