← 返回美國地址產生器
GET
GET
GET
GET
GET
ℹ 兩套API層級。 免費層級完全在瀏覽器中本地執行,適合原型和學习。付費層級是託管的REST 端點,適合需要高吞吐、SLA和伺服器到伺服器访問的生產工作负载。
身分驗證
免費層級無需任何身分驗證——它是仅瀏覽器的演示。付費層級通過 x-api-key 請求標头传遞API金鑰來驗認請求。您可以在帳戶儀表板中產生金鑰。
API端點
GET /v1/address
產生一條隨機美國地址。可通過 ?state=CA 限定州。
curl "https://api.us-address.example/v1/address?state=TX" \
-H "x-api-key: $API_KEY"
→ 200 OK
{
"name": "John Smith",
"street": "123 Main St",
"city": "Houston",
"state": "TX",
"zip": "77012",
"phone": "(713) 555-0123",
"email": "jsmith@example.com",
"country": "United States"
}
實時演示(瀏覽器)
點擊下方按鈕在瀏覽器中模拟請求——無需伺服器,無需金鑰。
// 輸出在此顯示
GET /v1/batch
一次請求最多返回1000個地址。传遞 count 和可選的 state。
curl "https://api.us-address.example/v1/batch?count=100&state=CA" \
-H "x-api-key: $API_KEY"
→ 200 OK
{
"count": 100,
"addresses": [ { "name": "…", "street": "…", … }, … ]
}
實時演示(瀏覽器)
在瀏覽器中產生批量結果。
// 輸出在此顯示
GET /v1/ein
產生一個 XX-XXXXXXX 格式的合成EIN。
curl "https://api.us-address.example/v1/ein" \
-H "x-api-key: $API_KEY"
→ { "ein": "47-1234567" }
// 輸出在此顯示
GET /v1/phone
產生一條隨機美國電話號碼。
curl "https://api.us-address.example/v1/phone?state=NY" \
-H "x-api-key: $API_KEY"
→ { "phone": "(212) 555-0199", "intl": "+1 212-555-0199" }
// 輸出在此顯示
GET /v1/zip/{zip}
查詢5位郵遞區號以返回對應州 + 示例城市。
curl "https://api.us-address.example/v1/zip/90001" \
-H "x-api-key: $API_KEY"
→ { "zip": "90001", "state": "CA", "stateFull": "California", "city": "Los Angeles" }
實時演示(瀏覽器)
輸入5位郵遞區號并本地執行查詢。
// 輸出在此顯示
速率限制与定价
| 層級 | 身分驗證 | 配額 | 速率 | 价格 |
|---|---|---|---|---|
| 免費(瀏覽器演示) | 無 | 每頁最多1000 | 本地 | $0 |
| PAID 標准 | API 金鑰 | 10万 / 月 | 10 req/s | $19 / 月 |
| PAID 高級 | API 金鑰 | 100万 / 月 | 50 req/s | $49 / 月 |
| PAID 企業 | API 金鑰 + SSO | 自定義 | 自定義 | 聯絡銷售 |
註解意。 示例請求中所示的託管端點域名(
api.us-address.example)仅為示意——註冊後請在帳戶儀表板將端點URL替换為正式的端點URL。
Frequently Asked Questions
免費層級包含哪些?
本頁面按鈕執行仅瀏覽器的免費演示。每次頁面加载可返回最多1000條記錄,無需API金鑰。
免費和付費有何區别?
付費提供託管的端點,带API金鑰鉴权、更高的速率限制、月度配額和SLA。非常適合CI管道、伺服器端 Seeder和生產容量測試。
免費層級需要帳戶吗?
不需要。本演示完全在瀏覽器中執行,無需註冊,無需API金鑰。
回應是真實地址吗?
不是。它們均為隨機合成,仅用于測試、夹具和演示。