mobile-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.
Usage Cost
40 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/mobile-3-validate-beckoningcURL Example
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}'Python Example
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())Go Example
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))
}Java Example
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 Example
<?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;Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"result": "一致",
"desc": "姓名/身份证/手机号一致"
}
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 600 req/min
- Timeout
- 5000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| name | string | Unspecified | Unspecified | 张三 |
| idcard | string | Unspecified | Unspecified | 110105199003078887 |
| mobile | string | Unspecified | Unspecified | 13800138000 |
Request Example
{
"name": "张三",
"idcard": "110105199003078887",
"mobile": "13800138000"
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 600 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| code | string | Unspecified | Unspecified | SUCCESS |
| message | string | Unspecified | Unspecified | success |
| data | object | Unspecified | Unspecified | {...} |
| data.result | string | Unspecified | Unspecified | 一致 |
| data.desc | string | Unspecified | Unspecified | 姓名/身份证/手机号一致 |
Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"result": "一致",
"desc": "姓名/身份证/手机号一致"
}
}$.code == 200API overview
Capabilities, use cases, limitations, and frequently asked questions.
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: