# 申请接口

  • 从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 审核通过