POSTPublicrandom-address-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-address-generate' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "count": 5,\n  "country": "CN",\n  "province": "广东",\n  "city": "深圳"\n}'

Python Example

import os
import requests

url = "https://openapi.toolkk.com/v1/random-address-generate"
payload = {
  "count": 5,
  "country": "CN",
  "province": "广东",
  "city": "深圳"
}

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-address-generate"
    payload := []byte("{\n  \"count\": 5,\n  \"country\": \"CN\",\n  \"province\": \"广东\",\n  \"city\": \"深圳\"\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": 5,
  "country": "CN",
  "province": "广东",
  "city": "深圳"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": [
    {
      "province": "广东省",
      "city": "深圳市",
      "district": "南山区",
      "street": "科技路88号",
      "zipCode": "518000",
      "full": "广东省深圳市南山区科技路88号",
      "country": "CN"
    }
  ]
}

Request Fields

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

Path	Type	Sample
count	number	5
country	string	CN
province	string	广东
city	string	深圳

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	{"province":"广东省","city":"深圳市","district":"南山区","street":"科技路88号","zipCode":"518000","full":"广东省深圳市南山区科技路88号","country":"CN"}
data[]	object	{...}
data[].province	string	广东省
data[].city	string	深圳市
data[].district	string