小程序认证上传补充材料

查看 Markdown

最后一次编辑于 2025-11-04

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：secwxaapi_uploadauthmaterial

小程序认证上传补充材料

1. 调用方式

HTTPS 调用

POST https://api.weixin.qq.com/wxa/sec/uploadauthmaterial?access_token=ACCESS_TOKEN

云调用

本接口不支持云调用。

第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：18
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

2. 请求参数

查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 authorizer_access_token

请求体 `Request Payload`

参数名	类型	必填	说明
media	buffer	是	图片（image）: 不超过2M，支持PNG\JPEG\JPG\GIF格式

3. 返回参数

返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
type	string	类型
mediaid	-	媒体id

4. 注意事项

本接口无特殊注意事项

5. 代码示例

请求示例

curl -F media=@xxx.jpg "https://api.weixin.qq.com/wxa/sec/uploadauthmaterial?access_token=TOKEN"

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "mediaid": "xxxxxxxxxxxxxxxxx"
}

6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述	解决方案
40005	invalid file type	上传素材文件格式不对
40006	invalid meida size	上传素材文件大小超出限制
41005	media data missing	缺少多媒体文件数据，传输素材无视频或图片内容
43002	require POST method	需要 POST 请求

7. 适用范围

本接口在不同账号类型下的可调用情况：

小程序	小游戏
✔	✔

✔：该账号可调用此接口。
其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。

调用方式
请求参数
- 查询参数 Query String Parameters
- 请求体 Request Payload
返回参数
- 返回体 Response Payload
注意事项
代码示例
错误码
适用范围