跳转到生成器
地址指南

地址生成 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 标记。

地址API请求上限与错误处理

公开接口要求提供随机种子,每次接受1–100条记录。国家和筛选参数必须一致,参数不合法时返回HTTP400。浏览器工具可生成更大的批次,最多1,000条。输出符合格式并不代表地址可用于配送或身份核验。