地址指南
地址生成 API
使用相同的确定性生成器创建最多 100 条 JSON 记录。
GET /api/addresses
country 使用两位国家代码(英国为 uk),可选 region、city、postal 必须同时匹配目录中的地区、城市和邮编;没有匹配时返回 400,不会扩大范围。seed 为必填,count 默认为 1,最大为 100。
curl "http://localhost:3000/api/addresses?country=us&count=2&seed=demo"
可复现的结果
使用相同参数会返回相同记录。不接收真实个人信息。此 API 未配置账户、API 密钥或计费,公开部署前需按流量要求配置网关限流。
错误处理
无效国家、地区、数量或缺失种子返回 HTTP 400。成功结果包含 data 数组、count 和 synthetic 标记。