idcard-face-validate

人脸身份证比对

提供姓名、身份证号及人脸照片三要素一致性核验服务，通过比对照片与身份信息，返回是否一致及相似度得分，辅助判断用户身份真实性。

调用价格

30 匠币/次

快速接入请求字段响应字段接口简介

快速接入

保持统一返回结构，直接通过服务端发起请求即可接入。

POSThttps://openapi.toolkk.com/v1/idcard-face-validate

cURL Python Go Java PHP

cURL 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/idcard-face-validate' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "name": "张三",\n  "idCardNo": "110105199003078887",\n  "facePhotoUrl": "https://example.com/face.jpg"\n}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/v1/idcard-face-validate"
payload = {
  "name": "张三",
  "idCardNo": "110105199003078887",
  "facePhotoUrl": "https://example.com/face.jpg"
}

headers = {
    "Content-Type": "application/json",
    "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}

response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())

Go 示例

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/v1/idcard-face-validate"
    payload := []byte("{\n  \"name\": \"张三\",\n  \"idCardNo\": \"110105199003078887\",\n  \"facePhotoUrl\": \"https://example.com/face.jpg\"\n}")

    req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

Java 示例

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ToolkkExample {
    public static void main(String[] args) throws Exception {
        String payload = "{\n  \"name\": \"张三\",\n  \"idCardNo\": \"110105199003078887\",\n  \"facePhotoUrl\": \"https://example.com/face.jpg\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/idcard-face-validate"))
            .method("POST", HttpRequest.BodyPublishers.ofString(payload))
            .header("Content-Type", "application/json")
            .header("X-API-Key", "YOUR_API_KEY")
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

PHP 示例

<?php

$endpoint = 'https://openapi.toolkk.com/v1/idcard-face-validate';
$payload = "{\n  \"name\": \"张三\",\n  \"idCardNo\": \"110105199003078887\",\n  \"facePhotoUrl\": \"https://example.com/face.jpg\"\n}";

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-API-Key: YOUR_API_KEY',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

curl_close($ch);
echo $response;

响应示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "一致",
    "similarity": 0.92,
    "threshold": 0.7
  }
}

示例用于理解返回结构，实际结果以接口返回为准。

请求字段

从服务端发起请求，并在 X-API-Key 请求头中传入密钥。

请求字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	必填	说明	示例值
name	`string`	未标注	未标注	`张三`
idCardNo	`string`	未标注	未标注	`110105199003078887`
facePhotoUrl	`string`	未标注	未标注	`https://example.com/face.jpg`

请求示例

{
  "name": "张三",
  "idCardNo": "110105199003078887",
  "facePhotoUrl": "https://example.com/face.jpg"
}

鉴权方式: 请求头传入 X-API-Key
默认限流: 600 次/分钟
超时时间: 5000 ms

响应字段

示例用于理解返回结构，实际结果以接口返回为准。

响应字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	必填	说明	示例值
code	`string`	未标注	未标注	`SUCCESS`
message	`string`	未标注	未标注	`success`
data	`object`	未标注	未标注	`{...}`
data.result	`string`	未标注	未标注	`一致`
data.similarity	`number`	未标注	未标注	`0.92`
data.threshold	`number`	未标注	未标注	`0.7`

响应示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "一致",
    "similarity": 0.92,
    "threshold": 0.7
  }
}

成功判定$.code == 200

人脸身份证比对API_三要素实名认证核验接口 | 工具匠

人脸身份证比对

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

响应示例

接入文档

核对身份信息与人脸照片

用于实名流程中的辅助核验

按输入、请求、结果三步接入

区分无结果、低质量照片与明确结论

常见问题

照片地址无法访问时会得到不一致吗？

相关推荐

`similarity` 高于 `threshold` 就一定能通过吗？

接口会检测真人或翻拍照片吗？

返回缺少 `data` 或 `result` 应如何处理？

身份证人脸比对验证

航班列表与参考票价查询

国内航班时刻表查询

航班号数据查询

航班实时状态查询

图片质量评分

英文简历解析

快速接入

cURL 示例

Python 示例

Go 示例

Java 示例

PHP 示例

响应示例

请求字段

请求字段

请求示例

响应字段

响应字段

响应示例

接入文档

核对身份信息与人脸照片

用于实名流程中的辅助核验

按输入、请求、结果三步接入

区分无结果、低质量照片与明确结论

常见问题

照片地址无法访问时会得到不一致吗？

相关推荐

相关工具

相关 API

`similarity` 高于 `threshold` 就一定能通过吗？

接口会检测真人或翻拍照片吗？

返回缺少 `data` 或 `result` 应如何处理？

身份证人脸比对验证

航班列表与参考票价查询

国内航班时刻表查询

航班号数据查询

航班实时状态查询

图片质量评分

英文简历解析