# 查询人脸核身任务状态

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

# 接口说明

queryIcpVerifyTask

该接口用于查询人脸核身任务的状态和结果。流程可参考服务商代备案指引或服务商代认证及备案介绍。

使用过程中如遇到问题，可在开放平台服务商专区发帖交流


POST https://api.weixin.qq.com/wxa/icp/query_icp_verifytask?access_token=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` 才是最终状态。
along_with_auth_result	number	发起时 `along_with_auth` 填 `true` 时有效：9. 认证短信核验通过。

示例说明: 查询示例


{
    "task_id": "R5PqRPNb6GmG3i0rqd4pTg"
}


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