Integra GenderAPI.io V2 con Make

Distingue la versión de API de tu conexión de Make

Esta guía HTTP utiliza https://api.genderapi.io/api/v2/gender. Envía type y value en JSON; la predicción está en data y la información de solicitud y uso, en meta.

Make incluye acciones de GenderAPI.io para nombres y correos. La ficha pública no confirma la versión exacta del endpoint ni el esquema completo de respuesta: revisa la salida del módulo existente. La configuración HTTP siguiente usa V2 directamente y no actualiza por sí sola un escenario existente.

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 Make

Elige el disparador de clientes de Shopify adecuado. Conserva el identificador del cliente y filtra los correos vacíos.
Añade HTTP > Make a request. Selecciona API key y crea una credencial cuyo valor sea Bearer YOUR_API_KEY, con ubicación Header y nombre de parámetro Authorization. No pongas la clave en la URL.
Usa POST y application/json. En Data structure, crea los campos de texto type y value y una colección options con el campo de texto ai_mode. Define type como email y ai_mode como off; asigna el correo del cliente a value.
Activa Parse response. La estructura de datos serializa los valores como JSON; evita concatenar texto manualmente.

Configuración HTTP	Valor	Finalidad
`Method`	`POST`	Envía una consulta individual.
`URL`	`https://api.genderapi.io/api/v2/gender`	Endpoint V2 de predicción individual.
`Authorization`	`Bearer YOUR_API_KEY`	Añade la clave real mediante los controles de credenciales o encabezados de la plataforma.
`Content-Type`	`application/json`	Envía JSON con el objeto options anidado, no datos de formulario.
`options.ai_mode`	`off`	Solo conjunto de datos por decisión explícita: 1 crédito, incluso si el resultado es unknown.

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

Mantén desactivadas las redirecciones hacia este destino HTTPS fijo. Al cambiar de versión de la aplicación HTTP, revisa de nuevo la autenticación y el cuerpo.

Inspecciona la salida analizada de una prueba controlada. Antes de actualizar clientes, crea rutas separadas para identified aceptado, unknown y errores operativos.

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.

Comprobación	Valor o tipo esperado	Decisión del flujo
`meta.access.mode`	api_key	Si aparece ip_trial, detén el flujo y corrige la clave. Una respuesta de prueba no autentica la cuenta y puede haber consumido créditos de prueba.
`meta.usage.billing_status`	confirmed o unconfirmed	Si es unconfirmed, guarda request_id y aclara el cargo antes de continuar o reenviar.
`data.result_status / data.gender`	identified con male/female; unknown con null	Guarda una predicción aceptada en un campo de inferencia separado. No asignes una categoría predeterminada a unknown.
`data.confidence / data.confidence_kind`	0–1 o null; tipo de evidencia o null	Interpreta observed_frequency y model_reported por separado. Ninguno garantiza la exactitud general.
`data.source / data.sample_count`	dataset, ai, none / entero o null	Conserva la fuente. La IA no tiene un recuento de muestras registrado; el recuento del conjunto de datos no es una medida de exactitud del producto.
`meta.request_id / meta.usage`	Referencia de solicitud / objeto de uso	Guárdalos con el registro de trabajo. Evita registrar la clave y datos personales innecesarios.
`Error HTTP / respuesta incompleta`	Problem Details o falta de respuesta completa	Detén la actualización y revisa el error y el cargo. Un tiempo de espera agotado no demuestra que el servidor no haya procesado la consulta.

Actualiza únicamente el registro correcto de Shopify

El módulo HTTP puede situar el cuerpo bajo una etiqueta de salida. Selecciona data y meta dentro de la estructura observada. Actualiza solo el cliente de Shopify cuyo identificador conservaste, mediante un campo de inferencia separado o una política de etiquetas definida.

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

Revisa los manejadores de errores y las ejecuciones incompletas de Make. Algunos errores temporales pueden reintentarse incluso sin un manejador Retry explícito. Repetir el módulo HTTP puede generar otro cargo. Si la predicción tuvo éxito y falló una actualización posterior de Shopify, reutiliza el resultado guardado.

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.

Opción de la solicitud	Comportamiento	Créditos por consulta completada
options.ai_mode: off	Consulta únicamente el conjunto de datos.	1 crédito, incluido unknown
options.ai_mode: fallback	Consulta primero el conjunto de datos y recurre a la IA estándar si no obtiene un género. Es el modo predeterminado de las consultas individuales.	1 crédito en total, incluido el respaldo de IA
options.ai_mode: always	Consulta directamente a la IA.	2 créditos
forceToGenderize: true	Consulta primero el conjunto de datos; si no encuentra un género, permite interpretar el significado de un alias personal, aunque no contenga un nombre real.	1 crédito si el conjunto de datos resuelve la consulta; 2 en total si se utiliza IA

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.

Preguntas frecuentes

¿Debo poner la clave API en la URL de Make?

No. Guarda Bearer YOUR_API_KEY como credencial API key de HTTP, con ubicación Header y nombre Authorization. El endpoint POST de V2 no acepta el parámetro key en la URL.

¿Puedo usar IA en esta conexión HTTP?

El ejemplo inicial utiliza options.ai_mode: off. fallback permite recurrir a IA con un coste total de 1 crédito; always usa IA directamente por 2 créditos. forceToGenderize consulta primero el conjunto de datos: cuesta 1 crédito si encuentra un resultado y 2 en total si utiliza IA.

¿Un resultado desconocido es gratuito o se puede repetir automáticamente?

No. Un resultado unknown correcto está completado y tiene coste. Repetirlo es una nueva operación. Ante un error de conexión o un cargo sin confirmar, revisa el uso y la referencia de solicitud antes de reenviar.

¿Se ha ejecutado este flujo en una cuenta conectada?

No. La configuración se revisó con documentación pública de las plataformas y el contrato V2. Antes de activar actualizaciones de producción, prueba los campos de la acción, la autenticación, el cuerpo, la respuesta y los reintentos en tu cuenta.

Documentación de referencia

Última revisión de la guía en español: 28 de septiembre de 2026. Consulta la documentación oficial de las plataformas para comprobar la configuración y disponibilidad actuales.