POST已開放idcard-face-validate

人脸身份证比对

通过判断姓名、身份证、头像照片三要素是否一致来核实用户身份的真实性

接入文件

通过判断姓名、身份证、头像照片三要素是否一致来核实用户身份的真实性

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

Shell 示例Python 示例Go 示例Java 示例PHP 示例

Shell 示例

curl --request POST \
  --url 'https://openapi.toolkk.com/idcard-face/validate' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{}'

Python 示例

import os
import requests

url = "https://openapi.toolkk.com/idcard-face/validate"
payload = {}

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/idcard-face/validate"
    payload := []byte("{}")

    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))
}

請求示例

{}

響應示例

{
  "code": 200,
  "data": {
    "msg": {
      "type": "string",
      "example": "系统判断为同一人",
      "description": "比较结果的描述"
    },
    "sex": {
      "type": "string",
      "example": "男",
      "description": "性别"
    },
    "score": {
      "type": "number",
      "example": 0.82,
      "description": "两张照片的相似度，0-1之间的小数，值越大相似度越高，incorrect为100时，才有该字段。判断依据： score < 0.40: 系统判断为不同人； 0.40 ≤ score < 0.60: 不能确定是否为同一人 ； score >= 0.60: 系统判断为同一人"
    },
    "result": {
      "type": "number",
      "example": 1,
      "description": "人像比较结果，incorrect为100时，返回该字段，1-同一人，2-不同人，3-不确定是否同一人"
    },
    "address": {
      "type": "string",
      "example": "浙江省**市**区",
      "description": "籍贯"
    },
    "birthday": {
      "type": "string",
      "example": "19****05",
      "description": "生日"
    },
    "incorrect": {
      "type": "number",
      "example": 100,
      "description": "比较结果返回码，见incorrect详解"
    }
  },
  "message": "success"
}

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
code	number	200
data	object	{...}
data.msg	object	{...}
data.msg.type	string	string
data.msg.example	string	系统判断为同一人
data.msg.description	string	比较结果的描述
data.sex	object	{...}
data.sex.type