查询认证结果

POST

https://api.btr.cc/api/v1/face_verify

人脸核身

使用获取认证链接时返回的 authToken 查询人脸认证结果。

计费：回查操作免费，不重复扣费。

注意：此接口与「获取认证链接」使用相同的 URL 路径，通过请求体中是否包含 authToken 字段来区分：

不传 authToken → 获取认证链接（扣费）

传入 authToken → 查询认证结果（免费）

请求参数

Authorization

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

Body 参数application/json必填

示例

{
    "authToken": "eyJhbGciOiJIUzI..."
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.btr.cc/api/v1/face_verify' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authToken": "eyJhbGciOiJIUzI..."
}'

返回响应

🟢201

application/json

查询成功

Body

示例

{
    "code": 0,
    "message": "authToken 校验成功",
    "requestId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "priceSource": "recheck_free",
    "unitPrice": "0.0000",
    "data": {
        "providerCode": "netease_yidun",
        "taskId": "task_abc123",
        "status": 1,
        "authToken": "eyJhbGciOiJIUzI..."
    }
}

🟠403

修改于 2026-03-05 05:42:36

获取人脸认证链接

FaceVerifyRequest