POSTrandom-address-generate
隨機地址生成
批次生成隨機中國大陸地址,包含省市區、街道門牌及郵編,支援按省份和城市進行篩選,單次最多生成 100 條,適用於測試資料填充。
1 匠幣/次
線上除錯
無需寫程式,瀏覽器中直接發起真實請求
接入文件
介面能力
本介面用於批次生成隨機的中國大陸地址資訊。生成的地址資料結構完整,包含省份、城市、區縣、街道門牌號、郵政編碼以及完整的拼接地址字串。開發者可以透過傳入國家、省份和城市引數,對生成的地址進行地域篩選,從而獲取特定區域的隨機地址資料。
請求與返回
請求引數包括生成數量(count,單次最多 100 條)、國家程式碼(country,如 CN)、省份(province)和城市(city)。 介面成功響應後,data 欄位將返回一個 JSON 物件陣列。每個物件包含 province(省份)、city(城市)、district(區縣)、street(街道門牌)、zipCode(郵編)以及 full(完整地址)等欄位,方便開發者直接解析和使用。
使用場景
- 軟體測試與演示:在電商、物流、外賣等系統的開發測試階段,批次生成逼真的收貨地址資料,用於功能驗證和介面演示。
- 資料庫填充:為開發環境的資料庫生成大量的模擬使用者地址資訊,進行效能測試或資料脫敏處理。
- 表單自動化測試:在自動化測試指令碼中,提供隨機且結構完整的地址輸入源。
使用說明與限制
- 單次請求生成的地址數量上限為 100 條。
- 介面生成的地址資訊(尤其是街道和門牌號)均為演算法隨機組合生成,並非真實存在的實體地址,僅供測試和模擬使用,請勿用於真實物流配送或身份核驗。
- 篩選引數需輸入正確的省份和城市名稱,若輸入有誤可能導致生成失敗或返回預設隨機地址。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例,便於直接接到現有專案裡。
請求示例
{
"count": 5,
"country": "CN",
"province": "广东",
"city": "深圳"
}響應示例
{
"code": "SUCCESS",
"message": "success",
"data": [
{
"province": "广东省",
"city": "深圳市",
"district": "南山区",
"street": "科技路88号",
"zipCode": "518000",
"full": "广东省深圳市南山区科技路88号",
"country": "CN"
}
]
}請求欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| count | number | 5 |
| country | string | CN |
| province | string | 广东 |
| city | string | 深圳 |
響應欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| 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 | 南山区 |