# 查询小程序认证及备案进度
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:queryAuthAndIcp
查询小程序认证及备案进度。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/sec/query_auth_and_icp?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:18
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证,可使用 authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| procedure_id | string | 是 | 小程序认证及备案任务流程id |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| procedure_status | number | 当前任务流程状态,见下方任务流程状态枚举 |
| orderid | number | 小程序后台展示的认证订单号 |
| refill_reason | string | 小程序认证审核单被驳回(`procedure_status` 为 `18`)时有效 |
| fail_reason | string | 小程序认证审核最终失败的原因(`procedure_status` 为 `20`)时有效 |
| icp_audit | object | 小程序备案相关信息 |
# Res.icp_audit Object Payload
小程序备案相关信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| hints | objarray | 错误提示,创建备案审核单失败时返回(`procedure_status` 为 `21`) |
| audit_data | objarray | 驳回原因,备案不通过时返回(`procedure_status` 为 `23`、`25`) |
| sms_verify_status | number | 管局短信核验状态,仅当任务流程状态为 `24`(备案管局审核中)的时候才有效。1:等待核验中,2:核验完成,3:核验超时。 |
# Res.icp_audit.hints(Array) Object Payload
错误提示,创建备案审核单失败时返回(procedure_status 为 21)
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 字段校验的错误码 |
| err_field | string | 校验失败的字段,示例值:`"icp_subject.principal_info.certificate_photo_front"` |
| errmsg | string | 校验失败提示信息,示例值:`"缺少必填字段"` |
# Res.icp_audit.audit_data(Array) Object Payload
驳回原因,备案不通过时返回(procedure_status 为 23、25)
| 参数名 | 类型 | 说明 |
|---|---|---|
| key_name | string | 审核不通过的字段中文名 |
| error | string | 字段不通过的原因 |
| suggest | string | 修改建议 |
# 4. 注意事项
# 其他说明
任务流程状态枚举
| 值 | 含义 |
|---|---|
| 9 | 手机验证成功 |
| 15 | 等待支付认证审核费用 |
| 16 | 认证审核费用支付成功 |
| 17 | 认证审核中 |
| 18 | 认证审核驳回 |
| 19 | 认证审核通过 |
| 20 | 认证审核最终失败(不能再修改) |
| 21 | 创建备案审核单失败 |
| 22 | 备案平台审核中 |
| 23 | 备案平台审核驳回 |
| 24 | 备案管局审核中 |
| 25 | 管局审核驳回 |
| 26 | 认证及备案完成 |
| 27 | 流程已过期 |
| 28 | 流程已终止 |
| 29 | 备案已撤回 |
# 5. 代码示例
请求示例
{
"procedure_id": "2df5025489464f2288e93395b75a628c"
}
返回示例
{
"errcode": 0,
"errmsg": "",
"procedure_status": 15
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | system error | 系统繁忙,此时请开发者稍候再试 |
| 0 | ok | ok |
# 7. 适用范围
本接口支持「第三方平台」账号类型代调用,权限集请参考「调用方式」部分。其他账号类型如无特殊说明,均不可调用。