🏠 Random Address Generator

随机生成自洽的真实格式地址 —— 区号 / 城市 / 州 / 邮编互相匹配,基于 faker.js 与自建美国地理数据集。

Addresses

REST API 文档

所有接口均为 GET,返回 JSON,支持跨域 (CORS *)。示例中的域名会自动替换为你当前访问的域名(本地开发即 127.0.0.1:8787,部署后即你的 workers.dev 地址)。

端点参数说明
/api/health—服务状态
/api/states—支持的州列表(★免税州带 taxFree:true)
/api/locales—支持的 27 个国家 / 语言
/api/addressescount(1-50,默认6) locale state city zip seed批量生成地址
/api/address同上(count 固定为 1)生成单条地址,直接返回 address 对象

curl 示例

curl "__ORIGIN__/api/addresses?count=3&state=CA"
curl "__ORIGIN__/api/address?locale=ja&seed=42"

fetch 示例

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。