Mover una integración de v1 a v2
GenderAPI.io V1 sigue disponible. Migra cada integración con la misma clave de API y el mismo saldo. Actualiza conjuntamente las rutas, los campos y el procesamiento de respuestas: V2 utiliza data para resultados y meta para solicitud, acceso y cobro.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender; utiliza type: name, email o username y value. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch; items admite varios tipos de entrada en un mismo lote. |
| /api/phone; number y address | POST /api/v2/phone/validate; envía number y country, y consulta data.valid y data.possible. |
| askToAI | options.ai_mode: fallback; es el valor predeterminado de las consultas individuales. |
| 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 |
| Porcentaje probability | confidence entre 0 y 1 junto con confidence_kind; las puntuaciones de IA no son probabilidades calibradas |
| total_names | data.sample_count; admite null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Formato de error heredado | Estado de HTTP más Problem Details code y action |
| Reintentos POST | Cada reintento es una nueva operación con facturación normal |
Actualiza y verifica tu cliente
Utiliza el contrato de solicitud y respuesta V2 para la integración que estés migrando. Comprueba meta.access.mode, conserva JSON null, revisa cada error de lote y verifica el cobro antes de reintentar. Mantén las integraciones V1 en sus rutas actuales hasta actualizar sus clientes.