# 查询人脸核身任务状态

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

# 接口说明

# 接口英文名

queryIcpVerifyTask

# 功能描述

该接口用于查询人脸核身任务的状态和结果。使用过程中如遇到问题,可在开放平台服务商专区发帖交流

# 注意事项

  1. 应先判断 is_finish 字段,如果为 true,表明人脸核身任务已完成,face_status 已到达最终状态,不会再变化。

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/icp/query_icp_verifytask?access_token=ACCESS_TOKEN 

# 第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:18、156

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性 类型 必填 说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用authorizer_access_token
task_id string 人脸核身任务id,示例值:"R5PqRPNb6GmG3i0rqd4pTg"

# 返回参数

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
is_finish boolean 人脸核身任务是否已完成
face_status number 任务状态枚举:0. 未开始;1. 等待中;2. 失败;3. 成功。返回的 is_finish 字段为 true 时,face_status 才是最终状态。

# 调用示例

示例说明: 查询示例

# 请求数据示例


{
    "task_id": "R5PqRPNb6GmG3i0rqd4pTg"
} 

# 返回数据示例


{
    "errcode": 0,
    "errmsg": "ok",
    "is_finish": true,
    "face_status": 3
} 

# 错误码

错误码 错误描述 解决方案
0 ok ok
1 code过期或不存在
86328 无法找到资源 无法找到资源