Integra GenderAPI.io V2 con Pabbly Connect

Distingue la versión de API de tu conexión de Pabbly Connect

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.

El catálogo de Pabbly contiene una aplicación llamada Gender API, pero la ficha revisada no permite confirmar el dominio del proveedor, la versión del endpoint ni el esquema completo de respuesta. El nombre por sí solo no demuestra que sea GenderAPI.io. La configuración siguiente utiliza API by Pabbly para enviar una solicitud HTTP directa a V2; no implica que el conector nativo se haya actualizado.

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 nombres 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 Pabbly Connect

Elige el disparador de clientes de Shopify que necesites. Conserva el identificador del cliente y asigna un campo de nombre disponible. Omite los nombres vacíos en lugar de enviar el registro completo del cliente.
Añade API by Pabbly > Custom Request. Selecciona POST y la URL V2. Configura Bearer token con la clave de GenderAPI o el encabezado Authorization con Bearer YOUR_API_KEY; no uses los dos mecanismos a la vez.
Define Content-Type como application/json. En Data, construye un objeto con type: name, value: nombre asignado y un objeto options que contenga ai_mode: off.
Mantén options como objeto anidado. Si la acción solo acepta JSON sin procesar, usa un paso de construcción JSON que escape correctamente comillas, barras inversas y saltos de línea. No insertes texto del cliente sin serializar.

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": "name",
  "value": "Alice",
  "options": {
    "ai_mode": "off"
  }
}

Parámetros, tipos y valores predeterminados

Revisa el paso HTTP antes de activar las actualizaciones

Inspecciona el cuerpo de respuesta y comprueba que el paso siguiente lea el cuerpo V2, no los campos de estado del transporte. Verifica las rutas reales de los campos que Pabbly expone para asignaciones posteriores.

Durante la configuración, ejecuta solo la acción de prueba elegida. Una prueba que envía la solicitud puede consumir créditos de GenderAPI y tareas de la plataforma aunque el flujo todavía esté desactivado.

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

Conserva el identificador de cliente de Shopify. Dirige las predicciones identified confirmadas al campo o la política de etiquetas prevista y conserva unknown como desconocido. No sobrescribas el nombre proporcionado por el cliente. Guarda source y confidence_kind junto con la estimación aceptada.

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

Pabbly ofrece Auto Re-execution y opciones manuales para repetir pasos fallidos u omitidos o el flujo completo. Comprueba qué pasos volverán a ejecutarse. Repetir todo el flujo puede volver a cobrar una consulta completada; cuando sea posible, corrige un fallo posterior de Shopify a partir de 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.

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

¿Puedo usar un campo de formulario plano options.ai_mode en Pabbly?

El cuerpo POST de V2 requiere el objeto JSON options. Un punto en la etiqueta del campo no demuestra que la plataforma cree un objeto anidado. Inspecciona el cuerpo serializado y compáralo con el ejemplo antes de enviarlo.

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