POSTPublicrandom-phone-generate

随机手机号生成

Documentation

批量生成随机手机号,支持中国(按运营商)、美国、日本等多国。最多100条/次。

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

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

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

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	array	"13812345678"
data[]	string	13812345678