接口请求域名： faceid.intl.tencentcloudapi.com 。
完成Web核验流程后，用核验令牌（BizToken）调用本接口查询对应核验结果信息。BizToken申请后三天内（259,200秒）有效，可多次调用。
默认接口请求频率限制：20次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：GetWebVerificationResultIntl。 |
| Version | 是 | String | 公共参数，本接口取值：2018-03-01。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| BizToken | 是 | String | Web核验令牌，由ApplyWebVerificationBizTokenIntl接口生成。 |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| ErrorCode | Integer | 本次流程的最终结果，0为核验通过，是同一人。 |
| ErrorMsg | String | 本次流程的最终结果描述。 |
| VerificationDetailList | Array of VerificationDetail | 本次流程的详细核验结果列表，由于可重试的原因，本次流程可能存在多个核验信息。 |
| VideoBase64 | String | 视频流中采集的视频内容的base64编码字符串，由于可重试的原因，该字段返回最后一次核验采集的数据，如果未采集到视频，则返回null。 |
| BestFrameBase64 | String | 视频流中采集的最佳人脸照片的base64编码字符串，由于可重试的原因，该字段返回最后一次核验采集的数据，如果未采集到最佳人脸照片，则返回null。 |
| OCRResult | Array of OCRResult | 证照识别的结果 |
| Extra | String | 业务透传参数 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
POST / HTTP/1.1
Host: faceid.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: GetWebVerificationResultIntl
<公共请求参数>
{
"BizToken": "4A7E7CE1-834C-4016-84DB-23823024233F"
}{
"Response": {
"BestFrameBase64": "/9j/4AAQSkZJRgABAQAAA**",
"ErrorCode": 0,
"ErrorMsg": "Success, tap next to continue",
"Extra": null,
"OCRResult": null,
"RequestId": "e7ad0f19-0c3e-402f-9fb0-720dd7ed0d99",
"VerificationDetailList": [
{
"CompareErrorCode": null,
"CompareErrorMsg": null,
"ErrorCode": 0,
"ErrorMsg": "Success, tap next to continue",
"LivenessErrorCode": 0,
"LivenessErrorMsg": "Success, tap next to continue",
"LivenessInfoTag": null,
"ReqTimestamp": 1789473304325,
"Seq": "11a370d4-9a16-49c8-b1bb-74ad89ac6965",
"Similarity": 0
}
],
"VideoBase64": "AAAAIGZ0eXBpc29tAAACAG**"
}
}云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
| InvalidParameterValue.BizTokenExpired | BizToken过期。 |
| InvalidParameterValue.BizTokenIllegal | BizToken不合法。 |
| OperationDenied | 操作被拒绝。 |
文档反馈