← 返回美国地址生成器
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密钥。
响应是真实地址吗?
不是。它们均为随机合成,仅用于测试、夹具和演示。