获取人脸认证链接

POST

/api/v1/face_verify

人脸核身

责任人：未设置

传入姓名和身份证号，生成人脸认证二维码/链接。用户打开链接完成人脸识别后，可通过查询接口获取认证结果。

计费：首次调用按产品单价扣费。

请求参数

Authorization

API Key

在 header 添加参数

x-api-key

示例：

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

Body 参数application/json必填

示例

最小必填参数包含服务端回调

{
    "name": "张三",
    "cardNo": "110101199001011234",
    "redirectUrl": "https://example.com/result"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

最小必填参数包含服务端回调

curl --location --request POST '/api/v1/face_verify' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "张三",
    "cardNo": "110101199001011234",
    "redirectUrl": "https://example.com/result"
}'

返回响应

🟢201

application/json

获取认证链接成功

Body

示例

{
    "code": 0,
    "message": "获取认证链接成功",
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "priceSource": "default",
    "unitPrice": "1.0000",
    "data": {
        "productCode": "face_verify",
        "providerCode": "netease_yidun",
        "authToken": "eyJhbGciOiJIUzI...",
        "authUrl": "https://verify.dun.163.com/v1/face/..."
    }
}

🟠403

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

查询认证结果