将集成从 V1 迁移到 V2
V1 仍然可用。准备就绪后，您可以使用同一个密钥和积分余额逐个迁移集成。V2 的请求和响应契约与 V1 不同，因此仅修改 URL 是不够的。
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender，将 type 设为 name、email 或 username，并提供 value。 |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch，使用 items；可以混合不同的输入类型。 |
| /api/phone，使用 number 和 address | POST /api/v2/phone/validate，使用 number 和 country；请读取 data.valid 和 data.possible。 |
| askToAI | options.ai_mode: fallback；单个请求已默认使用 fallback |
| forceToGenderize | 三种类型共用同一个可选字段；先查询数据集，再使用可识别昵称的 AI |
| 扁平的响应字段 | data 存放结果；meta 存放访问和计费信息 |
| probability 百分比 | 0–1 刻度的 confidence 加上 confidence_kind；AI 给出的值不是经过校准的概率 |
| total_names | data.sample_count，可为 null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| 旧版错误格式 | HTTP 状态加上 Problem Details 的 code 和 action |
| POST 重试 | 每次重试都是一次按正常规则计费的新操作 |
更新并验证您的客户端
对要迁移的集成使用 V2 的请求和响应契约。请确认 meta.access.mode，保留 JSON null 结果，检查批量请求中每个条目的错误，并在重试前检查计费。在客户端更新完成之前，V1 集成请继续使用现有路径。