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 |
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.