随机生成自洽的真实格式地址 —— 区号 / 城市 / 州 / 邮编互相匹配,基于 faker.js 与自建美国地理数据集。
所有接口均为 GET,返回 JSON,支持跨域 (CORS *)。示例中的域名会自动替换为你当前访问的域名(本地开发即 127.0.0.1:8787,部署后即你的 workers.dev 地址)。
| 端点 | 参数 | 说明 |
|---|---|---|
/api/health | — | 服务状态 |
/api/states | — | 支持的州列表(★免税州带 taxFree:true) |
/api/locales | — | 支持的 27 个国家 / 语言 |
/api/addresses | count(1-50,默认6) locale state city zip seed | 批量生成地址 |
/api/address | 同上(count 固定为 1) | 生成单条地址,直接返回 address 对象 |
curl "__ORIGIN__/api/addresses?count=3&state=CA" curl "__ORIGIN__/api/address?locale=ja&seed=42"
const r = await fetch("__ORIGIN__/api/addresses?count=6&state=NY&city=brooklyn");
const data = await r.json();
console.log(data.addresses[0]);
state 接受两位缩写(CA)、全名(california)或 random;city 双向包含匹配;zip 需落在所选州/城市内,否则自动回退并在 fallbacks 里说明;seed 为 0-4294967295 整数,相同 seed 结果可复现。非美国 locale 忽略 state/city/zip。