# 上传小程序备案媒体材料
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
uploadIcpMedia
# 功能描述
备案小程序需要提交图片或视频媒体材料,使用该接口完成媒体材料上传。使用过程中如遇到问题,可在开放平台服务商专区发帖交流
# 注意事项
Content-Type
需要指定为multipart/form-data
- 一个媒体材料可重复用于一次申请备案的多个字段,例如:当备案主体负责人和小程序负责人是同一人时,证件照正面只需上传一次,返回的
media_id
可同时传入申请小程序备案接口入参的icp_subject.principal_info.certificate_photo_front
和icp_applets.principal_info.certificate_photo_front
字段,证件照反面也是如此。 - 图片仅支持 JPG、JPEG、PNG 格式,大小不超过 2 MB。
- 视频仅支持 MP4 格式。
- 当需要填写
certificate_type
字段时,如果和icp_order_field
无法对应,则会上传失败,例如:当上传身份证人像面时,icp_order_field
填了"icp_subject.principal_info.certificate_photo_front"
,certificate_type
必须填2
(居民身份证),如果填其它值,则会在使用该media_id
调用申请小程序备案接口时报错,或上传失败。 - 上传前置审批文件时,
icp_order_field
填"icp_applets.base_info.nrlx_details"
即可。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/icp/upload_icp_media?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:18、156
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用authorizer_access_token |
type | string | 是 | 媒体材料类型。目前支持两种:图片("image" )和视频("video" ),示例值:"image" |
certificate_type | number | 否 | 证件类型(参考:获取证件类型),如果上传的是证件媒体材料,则必填,示例值:2 |
icp_order_field | string | 是 | 媒体材料所属的备案字段名(参考:申请小程序备案接口),如要用于多个备案字段,则填写其中一个字段名即可。例如:要上传身份证头像面照片作为备案主体负责人和小程序负责人的证件照正面,就填写 "icp_subject.principal_info.certificate_photo_front" |
media | string | 是 | 待上传的图片或视频的二进制内容 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
type | string | 媒体材料类型。目前支持两种:图片("image" )和视频("video" ),示例值:"image" |
media_id | string | 媒体id,示例值:"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7" |
created_at | number | 创建时间,UNIX时间戳,示例值:1692883651 |
# 调用示例
示例说明: CURL示例
# 请求数据示例
curl -F "type=image" -F "certificate_type=2" -F "icp_order_field=icp_applets.principal_info.certificate_photo_back" -F "media=@test.jpg" "https://api.weixin.qq.com/wxa/icp/upload_icp_media?access_token=ACCESS_TOKEN"
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"type": "image",
"media_id": "4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7",
"create_at": 1690969148
}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
0 | ok | ok |
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
86201 | 上传失败 | 请重试 |
86200 | 内部错误 | 请重试 |