# 获取小程序备案状态及驳回原因

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、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_tokenstring接口调用凭证,可使用 authorizer_access_token

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
infoobject备案状态信息

# Res.info Object Payload

备案状态信息

参数名类型说明枚举
statusnumber备案状态,取值参考备案状态枚举,示例值:`1024`枚举值
is_cancelingboolean是否正在注销备案-
audit_dataobjarray驳回原因,备案不通过时返回-
availablenumber备案入口是否对该小程序开放,0:不开放,1:开放。特定情况下入口不会开放,如小程序昵称包含某些关键词时、管局系统不可用时,当备案入口开放时才能提交备案申请。-
sms_verify_statusnumber管局短信核验状态,仅当备案状态为 `4`(管局审核中)的时候才有效。1:等待核验中,2:核验完成,3:核验超时。-

# Res.info.audit_data(Array) Object Payload

驳回原因,备案不通过时返回

参数名类型说明
key_namestring审核不通过的字段中文名
errorstring字段不通过的原因
suggeststring修改建议

# 4. 枚举信息

# Res.info.status Enum

备案状态,取值参考备案状态枚举,示例值:1024

枚举值描述
2平台审核中
3平台审核驳回
4管局审核中
5管局审核驳回
6已备案
1024未备案
1025未备案 && 小程序信息未填
1026未备案 && 小程序类目未填
1027未备案 && 小程序信息未填 && 小程序类目未填
1028未备案 && 小程序未认证
1029未备案 && 小程序信息未填 && 小程序未认证
1030未备案 && 小程序类目未填 && 小程序未认证
1031未备案 && 小程序信息未填 && 小程序类目未填 && 小程序未认证

# 5. 注意事项

  1. 申请小程序备案之前,需要先确保下列前置条件已经完成,当小程序处于未备案状态,该接口会返回未满足的前置条件。

    • 小程序名称、图标、描述等小程序基本信息已填写完成。
    • 小程序至少存在一个审核通过的类目。
    • 非个人类型小程序必须完成微信认证。

# 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 诊断工具 辅助定位和分析问题。

错误码错误描述解决方案
0okok
86328无法找到资源无法找到资源

# 8. 适用范围

本接口支持「第三方平台」账号类型代调用,权限集请参考「调用方式」部分。其他账号类型如无特殊说明,均不可调用。