POSTPublicmobile-2-validate

Phone & Name Verification

This API provides real-time verification of a user's phone number and name, accurately authenticating identity information to ensure data is genuine and valid.

Documentation

Feature Overview

The Phone & Name Verification V2 API is designed to provide highly efficient and accurate matching and verification of a user's phone number and name. By inputting a user's phone number and real name, the system queries and cross-references telecom carrier data in real time, returning a verification result indicating whether the phone number and name match. Building upon V1, this version features performance optimizations and expanded data sources, delivering a higher verification success rate and faster response times to effectively mitigate business risks associated with fake identity information.

Use Cases

Financial Risk Control: Verify the authenticity of user identities during bank account openings, loan applications, and payment transactions to effectively prevent fraud.
Platform Real-Name Authentication: Authenticate user identities during registration, login, content publishing, or large transactions to ensure regulatory compliance and data security.
Government Services: Verify applicant identity information during online service processing to improve efficiency and security.
E-commerce & Logistics: Perform secondary identity confirmation during sensitive operations (e.g., changing a linked phone number or withdrawing funds) to protect user assets.
Membership Management: Verify the authenticity of member information during onboarding to improve the quality of customer data.

Integration Examples

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

Request Example

{
  "name": "张三",
  "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	张三
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-2-validate' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "name": "张三",\n "mobile": "13800138000"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/mobile-2-validate" payload = { "name": "张三", "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-2-validate" payload := []byte("{\n \"name\": \"张三\",\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 \"mobile\": \"13800138000\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/mobile-2-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 $endpoint = 'https://openapi.toolkk.com/v1/mobile-2-validate'; $payload = "{\n \"name\": \"张三\",\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 Verification

Documentation

Feature Overview

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online