API 文档 V2

从 GenderAPI v1 迁移到 v2

使用相同的 API 密钥和余额将 GenderAPI 集成从 v1 移动到 v2。映射请求字段、批处理路由、响应、错误和重试行为。

将集成从 v1 移至 v2

V1 仍然可用。准备好后使用相同的密钥和信用余额迁移各个集成。 V2 是不同的请求和响应合约,因此仅更改 URL 是不够的。

V1概念V2 等效
单独的姓名、电子邮件和用户名端点POST /api/v2/gender 与 type 和 value
分离多个端点POST /api/v2/gender/batch 与 items
askToAIoptions.ai_mode: fallback;单个请求已默认为 fallback
forceToGenderize所有三种类型的可选字段相同;首先是数据集,然后是昵称感知人工智能
平坦响应字段data 为结果; meta 用于访问和计费
probability 百分比confidence(0-1 等级)加上 confidence_kind; AI 分数不是校准概率
total_namesdata.sample_count,可为空
used_credits / remaining_creditsmeta.usage.charged_credits / remaining_credits
旧版错误格式HTTP 状态加上 Problem Details code 和 action
POST 重试每次重试都是一次新操作,计费正常

更新并验证您的客户端

对您要迁移的集成使用 v2 请求和响应协定。验证 meta.access.mode、保留 JSON null 结果、检查每个项目的批次错误并在重试之前检查计费。将 v1 集成保留在现有路径上,直到更新客户端为止。