Integra GenderAPI.io V2 con Pipedream

Prepara la cuenta y el registro de origen

Necesitas acceso a las aplicaciones de origen y destino, una clave de cuenta de GenderAPI y las funciones HTTP de la plataforma. Esta guía no incluye credenciales ni cuentas conectadas. Conserva el identificador del registro y filtra los correos vacíos antes de consultar.

V1 y V2 comparten la clave de cuenta y el saldo. Antes de enviar consultas con coste, comprueba la clave con GET /api/v2/usage y verifica que meta.access.mode sea api_key. Una clave ausente o no reconocida puede activar la prueba compartida por IP; una automatización de producción no debe depender de ella sin advertirlo.

Mantén el flujo desactivado durante la configuración. Una consulta de prueba también consume créditos. Estas instrucciones se revisaron con la documentación pública y el contrato V2; no se ejecutaron de principio a fin en una cuenta conectada.

• Autenticación y comprobación del acceso →

Configura la solicitud HTTP V2 en Pipedream

• Elige el evento o la programación de Twilio SendGrid que corresponda a tu cuenta. Conserva el identificador del contacto y filtra los correos vacíos. El intervalo del disparador depende de la plataforma, no de una garantía de GenderAPI.
• Añade Send any HTTP Request, elige POST y la URL V2 de la tabla. Construye un cuerpo JSON con type: email, value: correo del contacto y options.ai_mode: off.
• Guarda la clave mediante credenciales o variables de entorno de Pipedream. Authorization debe contener Bearer seguido del secreto; Content-Type debe ser application/json. No reutilices la clave en parámetros de consulta ni la escribas en los registros.
• Crea el cuerpo como objeto JSON con los controles de asignación disponibles. No concatenes datos del contacto sin escapar en una cadena JSON. Inspecciona la vista previa antes de ejecutar una prueba deliberada.

Revisa el cuerpo JSON antes de enviarlo

Este es un ejemplo fijo de entrada, no una predicción. Comprueba su estructura y asigna a value el campo de origen mediante las herramientas de serialización JSON. No envíes expresiones de asignación de la plataforma como texto literal.

Para otra entrada, elige name, email o username en type y envía el value correspondiente. country es opcional: inclúyelo solo si dispones de ese contexto. No sirve para averiguar el país de residencia de la persona.

{
  "type": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}

• Parámetros, tipos y valores predeterminados →

Revisa el paso HTTP antes de activar las actualizaciones

Localiza el cuerpo analizado en la salida del paso HTTP. Si la acción devuelve texto, conviértelo una vez a JSON antes de leer data y meta. Un campo data del contenedor de transporte puede ser distinto del campo data del cuerpo V2.

Si necesitas controlar explícitamente los tiempos de espera, las redirecciones y los reintentos mediante código, consulta la guía de Node.js enlazada. La acción HTTP genérica y la aplicación nativa pueden tener valores predeterminados distintos.

• Documentación de Pipedream: genderapi-io →
• Documentación de Pipedream: genderapi_io.app.mjs →
• Documentación de Pipedream: http →
• Documentación de Pipedream: environment-variables →
• Documentación de Pipedream: settings →

Separa los resultados identificados, desconocidos y los errores

Analiza el cuerpo de la respuesta antes de actualizar el registro. Las rutas siguientes pertenecen al cuerpo V2; la plataforma puede anidarlo en otro campo o aplanar sus etiquetas. Inspecciona la estructura en una prueba controlada y guarda el resultado junto al identificador de origen.

Una predicción no verifica la identidad ni la declaración de la persona. Guarda la inferencia por separado de la información que esta haya proporcionado. Evalúa el umbral de aceptación con tus datos y distingue las puntuaciones del conjunto de datos de las de IA.

• Campos de respuesta V2 →
• Errores y reintentos →

Actualiza únicamente el registro correcto de Twilio SendGrid

Guarda el identificador de contacto del disparador junto al cuerpo V2. Aplica las comprobaciones de resultados antes de actualizar únicamente los campos personalizados previstos de SendGrid. Conserva el nombre proporcionado por el contacto: data.name obtenido de un correo es un candidato inferido, no un reemplazo verificado.

Prueba las ramas de resultados identificados, desconocidos y errores antes de activar las actualizaciones. Puedes usar respuestas simuladas sin enviar nuevas predicciones. La actualización debe depender de esas comprobaciones y conservar los campos y etiquetas ajenos al flujo.

• Campos de respuesta →

Controla los reintentos y los cargos adicionales

Pipedream documenta reintentos automáticos desde el paso fallido, sujetos al plan. Revisa la configuración del flujo y el comportamiento de la acción HTTP elegida. Repetir la consulta puede generar otro cargo; corrige un fallo posterior en el destino reutilizando la respuesta guardada.

Cada nueva solicitud a GenderAPI es una operación independiente. Deduplica los eventos en tu flujo antes de enviarlos, usando el identificador de origen y el estado del trabajo. Ese identificador no evita por sí solo nuevos cargos en el servidor.

Un resultado unknown correcto es una consulta completada con coste. Si se agota el tiempo de espera o falta la respuesta, el resultado y el cargo pueden ser inciertos. Conserva la referencia de solicitud disponible y aclara el estado antes de reenviar. Respeta Retry-After cuando se incluya en una respuesta de límite de solicitudes.

• Créditos y estado del cargo →

Elige cuándo utilizar la IA

forceToGenderize es opcional para nombres, correos electrónicos y nombres de usuario. Si lo activas, omite ai_mode o utiliza fallback; combinarlo con off o always devuelve un error 422. Basta con un saldo inicial positivo para iniciar la consulta, aunque el cargo final deje el saldo por debajo de cero.

El análisis de alias puede devolver un género con name: null. También puede devolver unknown. Ni el respaldo estándar de IA ni el análisis de alias garantizan una respuesta correcta o distinta de null.

• Opciones de IA y análisis de alias →
• Créditos y uso →

Valida el flujo antes de aumentar el volumen

• En una prueba deliberada, comprueba el JSON enviado, las rutas de los campos, el acceso de cuenta y la confirmación del cargo. Prueba las ramas de resultados desconocidos y errores con respuestas simuladas cuando sea posible.
• Comprueba qué pasos se repiten y qué campos del cliente cambian. Guarda el identificador de origen, la respuesta completada y la referencia de solicitud para poder corregir una actualización posterior sin repetir la predicción.
• Empieza con una ejecución pequeña y controlada. Revisa los registros y créditos antes de aumentar la concurrencia. Los créditos de GenderAPI y las tareas u operaciones de la plataforma son costes distintos.
• Para lotes, usa POST /api/v2/gender/batch: hasta 50 elementos con clave de cuenta y 10 en la prueba por IP. items puede combinar nombres, correos y usuarios; asigna opciones explícitas e identificadores únicos. HTTP 200 puede contener fallos parciales: revisa cada elemento. Verifica por separado el soporte de lotes del conector nativo.

• Lotes y fallos parciales →
• Guía de Python →
• Guía de Node.js →

Preguntas frecuentes