Mover una integración de v1 a v2
V1 permanece disponible. Migre integraciones individuales cuando esté listo usando la misma clave y saldo de crédito. V2 es un contrato de solicitud y respuesta diferente, por lo que cambiar solo la URL no es suficiente.
| Concepto V1 | Equivalente V2 |
|---|---|
| Puntos finales separados de nombre, correo electrónico y nombre de usuario | POST /api/v2/gender con type y value |
| Separar múltiples puntos finales | POST /api/v2/gender/batch con items |
| askToAI | options.ai_mode: fallback; Las solicitudes únicas ya están predeterminadas en fallback. |
| forceToGenderize | Mismo campo opcional para los tres tipos; primero el conjunto de datos, luego la IA con reconocimiento de apodos |
| Campos de respuesta planos | data para el resultado; meta para acceso y facturación |
| probability porcentaje | confidence en una escala de 0 a 1 más confidence_kind; Las puntuaciones de IA no son probabilidades calibradas |
| total_names | data.sample_count, nullable |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Formato de error heredado | Estado de HTTP más Problem Details code y action |
| POST reintentos | Cada reintento es una nueva operación con facturación normal |
Actualiza y verifica tu cliente
Utilice el contrato de solicitud y respuesta v2 para la integración que está migrando. Verifique meta.access.mode, conserve los resultados de JSON null, inspeccione los errores de lote por elemento y verifique la facturación antes de volver a intentarlo. Mantenga las integraciones v1 en sus rutas existentes hasta que sus clientes hayan sido actualizados.