# 查询小程序认证及备案进度

调试诊断

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

# 请求体 Request Payload

参数名类型必填说明
procedure_idstring小程序认证及备案任务流程id

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
procedure_statusnumber当前任务流程状态,见下方任务流程状态枚举
orderidnumber小程序后台展示的认证订单号
refill_reasonstring小程序认证审核单被驳回(`procedure_status` 为 `18`)时有效
fail_reasonstring小程序认证审核最终失败的原因(`procedure_status` 为 `20`)时有效
icp_auditobject小程序备案相关信息

# Res.icp_audit Object Payload

小程序备案相关信息

参数名类型说明
hintsobjarray错误提示,创建备案审核单失败时返回(`procedure_status` 为 `21`)
audit_dataobjarray驳回原因,备案不通过时返回(`procedure_status` 为 `23`、`25`)
sms_verify_statusnumber管局短信核验状态,仅当任务流程状态为 `24`(备案管局审核中)的时候才有效。1:等待核验中,2:核验完成,3:核验超时。

# Res.icp_audit.hints(Array) Object Payload

错误提示,创建备案审核单失败时返回(procedure_status21

参数名类型说明
errcodenumber字段校验的错误码
err_fieldstring校验失败的字段,示例值:`"icp_subject.principal_info.certificate_photo_front"`
errmsgstring校验失败提示信息,示例值:`"缺少必填字段"`

# Res.icp_audit.audit_data(Array) Object Payload

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

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

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

错误码错误描述解决方案
-1system error系统繁忙,此时请开发者稍候再试
0okok

# 7. 适用范围

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