# 获取小程序备案媒体材料

接口应在服务器端调用,详细说明参见服务端API

# 接口说明

# 接口英文名

getIcpMedia

# 功能描述

用于小程序备案过程中获取所上传的图片或视频媒体材料。

# 注意事项

  1. 如果获取成功,则响应体中直接返回图片或视频内容,Content-Typeimage/jpegvideo/mp4。如果获取失败,则响应体为 JSON,包含具体错误码和错误提示,Content-Typeapplication/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