Migrar uma integração da V1 para a V2
A V1 continua disponível. Migre cada integração quando estiver pronto, usando a mesma chave e o mesmo saldo de créditos. A V2 tem um contrato de requisição e resposta diferente; por isso, alterar apenas a URL não basta.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender com type: name, email ou username e value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch com items; os tipos de entrada podem ser combinados. |
| /api/phone com number e address | POST /api/v2/phone/validate com number e country; leia data.valid e data.possible. |
| askToAI | options.ai_mode: fallback; requisições individuais já usam fallback por padrão |
| forceToGenderize | O mesmo campo opcional para os três tipos; primeiro o conjunto de dados, depois a IA com interpretação de apelidos |
| Campos de resposta planos | data para o resultado; meta para acesso e cobrança |
| Porcentagem em probability | confidence em uma escala de 0 a 1 mais confidence_kind; os valores da IA não são probabilidades calibradas |
| total_names | data.sample_count, pode ser null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Formato de erro legado | Status HTTP mais code e action de Problem Details |
| Novas tentativas de POST | Cada nova tentativa é uma nova operação com cobrança normal |
Atualize e verifique seu cliente
Use o contrato de requisição e resposta da V2 na integração que você está migrando. Verifique meta.access.mode, preserve resultados JSON null, verifique erros por item nos lotes e confira a cobrança antes de fazer uma nova tentativa. Mantenha as integrações da V1 nos caminhos atuais até que os clientes delas tenham sido atualizados.