POSTPublicrandom-phone-generate

Random Phone Number Generator

批量生成随机手机号，支持中国（按运营商）/ 美国 / 日本等多国。最多 100 条/次。

Documentation

Bulk generate random phone numbers for multiple countries, including China (by carrier), the United States, and Japan. Generate up to 100 numbers per batch.

Integration Examples

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

Shell ExamplePython ExampleGo ExampleJava ExamplePHP Example

Shell Example

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/random-phone-generate' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "count": 10,\n  "country": "CN",\n  "operator": "all",\n  "includeDialCode": false,\n  "formatWithDash": false\n}'

Python Example

import os
import requests

url = "https://openapi.toolkk.com/v1/random-phone-generate"
payload = {
  "count": 10,
  "country": "CN",
  "operator": "all",
  "includeDialCode": false,
  "formatWithDash": false
}

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/random-phone-generate"
    payload := []byte("{\n  \"count\": 10,\n  \"country\": \"CN\",\n  \"operator\": \"all\",\n  \"includeDialCode\": false,\n  \"formatWithDash\": false\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  \"count\": 10,\n  \"country\": \"CN\",\n  \"operator\": \"all\",\n  \"includeDialCode\": false,\n  \"formatWithDash\": false\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/random-phone-generate"))
            .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/random-phone-generate';
$payload = "{\n  \"count\": 10,\n  \"country\": \"CN\",\n  \"operator\": \"all\",\n  \"includeDialCode\": false,\n  \"formatWithDash\": false\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;

Request Example

{
  "count": 10,
  "country": "CN",
  "operator": "all",
  "includeDialCode": false,
  "formatWithDash": false
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": [
    "13812345678",
    "15987654321"
  ]
}

Request Fields

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

Path	Type	Sample
count	number	10
country	string	CN
operator	string	all
includeDialCode	boolean	false
formatWithDash	boolean	false

Response Fields