跳转到生成器
地址指南

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

地址生成器 →