申请接口 | 微信开放文档

# 申请接口

从2022年4月18日开始，部分小程序前端api需申请后，方可使用。该接口用于发起申请使用部分小程序前端api。发起申请后可通过get_privacy_interface查看审核状态。
每个接口都有类目要求，申请之前建议先阅读api原文，详细查看类目要求。
使用过程中如遇到问题，可在开放平台服务商专区发帖交流。

# 频率说明

280个请求/min

# 请求地址

POST https://api.weixin.qq.com/wxa/security/apply_privacy_interface?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	必填	说明
access_token	string	是	第三方平台接口调用令牌authorizer_access_token
api_name	string	是	申请的api英文名，例如wx.choosePoi，严格区分大小写
content	string	是	申请说原因，不超过300个字符；需要以utf-8编码提交，否则会出现审核失败
url_list	string array	否	(辅助网页)例如，上传官网网页链接用于辅助审核
pic_list	string array	否	(辅助图片)填写图片的url ，最多10个
video_list	string array	否	(辅助视频)填写视频的链接，最多支持1个；视频格式只支持mp4格式

# 请求示例

注意，需要以utf-8编码提交，否则审核失败。


{
    "api_name": "wx.test",
    "content": "1312",
    "pic_list": [
        "pic_url1",
        "pic_url2"
    ],
    "video_list":["video_url1", "video_ul2"],
    "url_list":["url1", "url2"]
}

# 返回参数说明

参数	类型	说明
errcode	int32	返回码
errmsg	string	返回码信息
audit_id	uint32	审核单id

# 返回结果示例


 {
    "errcode":0,
    "errmsg":"getuserriskrank succ",
    "audit_id":123456
}

# 返回码说明

返回码	errmsg	说明
0	ok	查询成功
61031	our last submission is under review, please do not apply again	审核中，请不要重复申请
61032	invalid video type, need mp4-type	视频格式不对，要传mp4格式的
61033	the media upload fail, please try again	视频下载失败
61034	invalid args, please check	必填的参数没填，检查后重新提交
61035	the api not need apply	输入的api（api_name严格区分大小写）无需申请，可以直接使用；或者就是api_name输入错了；或者就是这个api已经申请了，不需要再申请
61036	the appid is not allowed to apply the api	该账号不可申请，请检查类目是否符合
61037	the encoding of content is invalid, need utf-8	需要以ntf-8的编码格式提交
61038	apply api too frequently	调用频率太快了，额度(280个请求/min)
其他错误码		请查看全局错误码

# 审核结果推送

审核结果推送至第三方平台-开发资料-消息与事件url。接收到的消息体如下：

<xml>
  <ToUserName><![CDATA[gh_fb9688c2a4b2]]></ToUserName>
  <FromUserName><![CDATA[od1P50M-fNQI5Gcq-trm4a7apsU8]]></FromUserName>
  <CreateTime>1488856741</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[wxa_privacy_apply]]></Event>
  <result_info>
      <api_name>"wx.choosePoi"</api_name>
      <apply_time>"1644805538"</apply_time>
      <audit_id>"421609337"</audit_id>
      <audit_time>"1644828435"</audit_time>
      <reason>"小程序内未含有相应使用场景"</reason>
      <status>"2"</status>
  </result_info>
</xml>

# status状态说明

状态码	说明
2	审核不通过
3	审核通过