三步完成一次生成
设定数据范围
按需要选择州和城市，不设置条件时将使用随机地区
刷新样例记录
点击随机生成，页面会更新本次使用的整组测试字段
复制或下载结果
选择单字段、完整记录或JSON格式带入后续流程
网页端操作说明
控制地区范围
筛选条件决定下一条记录从哪个数据范围中选取：
- 先选择州，可以将随机范围限制到目标州
- 选择城市后，可进一步缩小地址的地理范围
- 接口请求加入has_number=1，可只返回带门牌号的街道字段
取用页面结果
根据使用方式选择合适的输出形式：
- 点击字段旁的复制按钮，只获取当前一项内容
- 使用复制全部，将页面上的主要字段整理为一组文本
- 使用导出JSON，下载便于脚本和测试环境读取的结构化文件
查看位置关系
地图用于辅助理解城市与地址的大致位置关系，不应作为邮寄或导航准确性的证明。
让测试过程更顺手
先固定筛选条件
调试地区相关逻辑时，先选定州和城市，再连续生成多组记录
移动端也可操作
在手机上可以完成筛选、刷新和复制，控制项会自动适配窄屏
按用途选择输出
临时粘贴用复制，自动化测试或批处理场景优先使用JSON或API
切换显示语言
顶部语言菜单可切换中英文内容，数据字段结构保持一致
通过API获取数据
需要在脚本或服务中读取样例记录时，可以调用生成接口。请求必须携带有效的API Key，并可按州、城市、门牌号或免征州级一般销售税州进行筛选。
# 限定州和城市
curl --get "/api/generate.php" -H "Authorization: Bearer YOUR_API_KEY" --data-urlencode "state=CA" --data-urlencode "city=Los Angeles"# 只返回包含门牌号的街道
curl --get "/api/generate.php" -H "Authorization: Bearer YOUR_API_KEY" --data-urlencode "has_number=1"# 不传筛选条件，随机生成
curl "/api/generate.php" -H "Authorization: Bearer YOUR_API_KEY"# 使用 JSON POST
curl "/api/generate.php" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" --data '{"state":"CA","city":"Los Angeles","has_number":1}'# 查询指定州的城市（无需密钥）
curl --get "/api/get-cities.php" --data-urlencode "state=CA"# 查询城市所属的州（无需密钥）
curl --get "/api/get-state-by-city.php" --data-urlencode "city=Los Angeles"生成接口支持 GET、JSON POST 和表单 POST；城市查询接口仅支持 GET，且无需密钥。所有接口支持 OPTIONS 预检。生成接口必须提供 Bearer 密钥；本站网页使用与会话绑定的专用令牌。
state：可选，两位州代码，忽略大小写。city：可选，完整城市名，忽略大小写；空格与连字符等价。has_number：可选，0 或 1，默认 0；1 要求街道以门牌号开头。tax_free：可选，0 或 1；1 表示从不征收州级一般销售税的 AK、DE、MT、NH、OR 中随机生成，不能与 state 或 city 同时使用。其他多个条件必须同时满足；无匹配记录返回 404。get-state-by-city 的 city 必填；查无城市时返回空 states 和 null primary_state。
错误返回包含 success: false、error 和 code。400：参数或 JSON 不正确；401：密钥或网页令牌无效、过期或缺失；404：无匹配地址；405：方法不支持；413：请求体超过 4096 字节；415：POST 内容类型不支持；500：服务异常。同一参数不能同时放在 URL 和 POST 请求体中。
调用前请确认：将 YOUR_API_KEY 替换为有效密钥，通过 Authorization: Bearer 请求头发送，不要放入 URL。示例地址自动跟随当前网页的协议、域名和端口。到期后请联系管理员续期。
以下仅展示部分字段。实际 data 还包含职业、账户和信用卡等信息。cardNumber 和 cvv 是字符串，expiry 为 MM/YY；这些均为虚构样例。
返回结构示意
{
"success": true,
"data": {
"fullName": "John Doe",
"street": "123 Main St",
"city": "Los Angeles",
"state": "CA",
"zipCode": "90001"
}
}