# 申请地理位置接口

调试工具

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

# 接口说明

# 接口英文名

applyPrivacyInterface

# 功能描述

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

# 注意事项

280个请求/min
需要以utf-8编码提交，否则审核失败。

# 调用方式

# HTTPS 调用


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

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：18
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

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

# 返回参数

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
audit_id	number	审核id

# 其他说明

# 审核结果推送

审核结果推送至第三方平台-开发资料-消息与事件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	审核通过

# 调用示例

示例说明: HTTPS请求

# 请求数据示例


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

# 返回数据示例


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

# 错误码

错误码	错误码取值	解决方案
0	ok	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	需要以utf-8的编码格式提交
61038	apply api too frequently	调用频率太快了，不可超过280个请求/min