# Migrar de GenderAPI v1 para v2

> Mova uma integração GenderAPI de v1 para v2 usando a mesma chave e equilíbrio API. Mapeie campos de solicitação, rotas em lote, respostas, erros e comportamento de novas tentativas.

Canonical HTML: https://www.genderapi.io/pt/docs/v2/migration

Last reviewed: 2026-09-26

## Mover uma integração de v1 para v2

V1 permanece disponível. Migre integrações individuais quando estiver pronto usando a mesma chave e saldo de crédito. V2 é um contrato de solicitação e resposta diferente, portanto, alterar apenas a URL não é suficiente.

| Conceito V1 | Equivalente a V2 |
| --- | --- |
| Separar endpoints de nome, e-mail e nome de usuário | POST /api/v2/gender com type e value |
| Separar vários endpoints | POST /api/v2/gender/batch com items |
| askToAI | options.ai_mode: fallback; solicitações únicas já são padronizadas como fallback |
| forceToGenderize | Mesmo campo opcional para todos os três tipos; primeiro o conjunto de dados e depois a IA com reconhecimento de apelido |
| Campos de resposta simples | data para o resultado; meta para acesso e cobrança |
| Porcentagem probability | confidence em uma escala de 0–1 mais confidence_kind; As pontuações de IA não são probabilidades calibradas |
| total_names | data.sample_count, anulável |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Formato de erro legado | Status HTTP mais Problem Details code e action |
| POST tenta novamente | Cada nova tentativa é uma nova operação com faturamento normal |

- [Leia a referência v1](https://www.genderapi.io/pt/api-documentation/v1)
- [Use o contrato v2 OpenAPI](https://api.genderapi.io/api/v2/openapi.json)

## Atualize e verifique seu cliente

Use o contrato de solicitação e resposta v2 para a integração que você está migrando. Verifique meta.access.mode, preserve os resultados de JSON null, inspecione erros de lote por item e verifique o faturamento antes de tentar novamente. Mantenha as integrações v1 em seus caminhos existentes até que seus clientes sejam atualizados.

- [Comece com autenticação](https://www.genderapi.io/pt/docs/v2/authentication)
- [Leia uma resposta v2](https://www.genderapi.io/pt/docs/v2/responses)
- [Lidar com novas tentativas](https://www.genderapi.io/pt/docs/v2/errors-and-retries)