POSTPublicmobile-3-validate-beckoning

Phone, Name, and ID Verification

Verify user identity using three key elements: phone number, full name, and ID number. Ensure data authenticity and prevent fraud.

Documentation

Feature Overview

The Phone, Name, and ID Verification service is designed to help businesses quickly and accurately verify the authenticity and consistency of user identity information. By cross-checking the submitted phone number, full name, and ID number, it determines whether the three elements match, effectively authenticating the user's identity and mitigating business risks. This service relies on authoritative and reliable data sources, returning verification results in real-time to ensure data timeliness and accuracy.

Use Cases

User Registration & Login: Ensure new or logging-in users have real identities, preventing malicious registrations and account takeovers.
Financial Risk Control: Verify user identities during account opening, lending, payments, and other financial services to effectively identify potential fraud.
E-commerce Transactions: Authenticate buyer or seller identities to enhance transaction security and reduce disputes.
Government Services: Verify citizen identities during online government service processing to ensure regulatory compliance.
Content Moderation: Verify the identity of publishers on user-generated content platforms to enforce real-name registration requirements.

Usage Instructions

To call this API, you need to provide the user's phone number, full name, and ID number. The API will return the verification result, which typically includes one of the following statuses:

Match: The phone number, name, and ID number all match.
Mismatch: At least one of the three elements (phone number, name, or ID number) does not match.
Unable to Verify: The provided identity information cannot be found in the authoritative data sources, or the system is currently busy.

Please ensure you have obtained explicit user authorization before performing any identity verification.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "name": "张三",
  "idcard": "110105199003078887",
  "mobile": "13800138000"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "一致",
    "desc": "姓名/身份证/手机号一致"
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
name	string	张三
idcard	string	110105199003078887
mobile	string	13800138000

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.result	string	一致
data.desc	string	姓名/身份证/手机号一致

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

import os import requests url = "https://openapi.toolkk.com/v1/mobile-3-validate-beckoning" payload = { "name": "张三", "idcard": "110105199003078887", "mobile": "13800138000" } 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())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/mobile-3-validate-beckoning" payload := []byte("{\n \"name\": \"张三\",\n \"idcard\": \"110105199003078887\",\n \"mobile\": \"13800138000\"\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)) }

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 \"idcard\": \"110105199003078887\",\n \"mobile\": \"13800138000\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/mobile-3-validate-beckoning")) .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 $endpoint = 'https://openapi.toolkk.com/v1/mobile-3-validate-beckoning'; $payload = "{\n \"name\": \"张三\",\n \"idcard\": \"110105199003078887\",\n \"mobile\": \"13800138000\"\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;

Phone, Name, and ID Verification

Documentation

Feature Overview

Use Cases

Usage Instructions

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online