# 获取小程序备案状态及驳回原因
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:getIcpEntranceInfo
使用该接口获取小程序备案状态,如果小程序未备案通过,则返回其驳回原因。使用过程中如遇到问题,可在小程序备案专区发帖交流
# 1. 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxa/icp/get_icp_entrance_info?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:18、156
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证,可使用 authorizer_access_token |
# 请求体 Request Payload
无
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| info | object | 备案状态信息 |
# Res.info Object Payload
备案状态信息
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| status | number | 备案状态,取值参考备案状态枚举,示例值:`1024` | 枚举值 |
| is_canceling | boolean | 是否正在注销备案 | - |
| audit_data | objarray | 驳回原因,备案不通过时返回 | - |
| available | number | 备案入口是否对该小程序开放,0:不开放,1:开放。特定情况下入口不会开放,如小程序昵称包含某些关键词时、管局系统不可用时,当备案入口开放时才能提交备案申请。 | - |
| sms_verify_status | number | 管局短信核验状态,仅当备案状态为 `4`(管局审核中)的时候才有效。1:等待核验中,2:核验完成,3:核验超时。 | - |
# Res.info.audit_data(Array) Object Payload
驳回原因,备案不通过时返回
| 参数名 | 类型 | 说明 |
|---|---|---|
| key_name | string | 审核不通过的字段中文名 |
| error | string | 字段不通过的原因 |
| suggest | string | 修改建议 |
# 4. 枚举信息
# Res.info.status Enum
备案状态,取值参考备案状态枚举,示例值:1024
| 枚举值 | 描述 |
|---|---|
| 2 | 平台审核中 |
| 3 | 平台审核驳回 |
| 4 | 管局审核中 |
| 5 | 管局审核驳回 |
| 6 | 已备案 |
| 1024 | 未备案 |
| 1025 | 未备案 && 小程序信息未填 |
| 1026 | 未备案 && 小程序类目未填 |
| 1027 | 未备案 && 小程序信息未填 && 小程序类目未填 |
| 1028 | 未备案 && 小程序未认证 |
| 1029 | 未备案 && 小程序信息未填 && 小程序未认证 |
| 1030 | 未备案 && 小程序类目未填 && 小程序未认证 |
| 1031 | 未备案 && 小程序信息未填 && 小程序类目未填 && 小程序未认证 |
# 5. 注意事项
申请小程序备案之前,需要先确保下列前置条件已经完成,当小程序处于未备案状态,该接口会返回未满足的前置条件。
- 小程序名称、图标、描述等小程序基本信息已填写完成。
- 小程序至少存在一个审核通过的类目。
- 非个人类型小程序必须完成微信认证。
# 6. 代码示例
请求示例
curl https://api.weixin.qq.com/wxa/icp/get_icp_entrance_info?access_token=ACCESS_TOKEN
返回示例
{
"errcode": 0,
"errmsg": "ok",
"info": {
"status": 6 // 已备案
}
}
# 7. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 0 | ok | ok |
| 86328 | 无法找到资源 | 无法找到资源 |
# 8. 适用范围
本接口支持「第三方平台」账号类型代调用,权限集请参考「调用方式」部分。其他账号类型如无特殊说明,均不可调用。