使用种子与版本复现地址 API 样本

记录所有影响样本的输入

在测试中保存国家、地区、数量、种子和生成器数据版本。若算法或来源目录可能变化，仅保存种子并不足够。

按文档使用项目 API

fakeloc 接口接受国家、可选地区、数量和必填种子；文档上限为 100 条。接口返回合成样本，未接入账户或 API 密钥系统。不要提交个人数据。

curl "https://fakeloc.tech/api/addresses?country=us&count=2&seed=checkout-42&profile=false"

返回结构示意：{ "data": [/* 两条记录 */], "count": 2, "synthetic": true }
每条记录包含 generatorVersion 与 dataVersion；与请求参数一起保存。

地址 API 参数与限制 →

仅在需要固定值时锁定输出

表单契约测试应检查必需字段和类型，而非整个记录快照。特定边界值需要固定时再使用精确样本；数据版本变化后有意更新它。

Faker 种子与可复现性说明 ↗

让失败原因清楚可查

记录不含敏感信息的参数和响应版本。结果不同的时候，先检查种子编码、国家别名和版本，再判断是否为回归。