Distingue la versión de API de tu conexión de Integrately
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.
La ficha de GenderAPI.io en Integrately enlaza con genderapi.io y ofrece acciones para nombres, correos y extracción del nombre a partir de un correo. No muestra la versión de API ni el esquema de salida completo. Webhook/API permite enviar datos mediante POST, pero los controles actuales de encabezados y JSON del editor no se verificaron de forma independiente. Aplica el contrato V2 siguiente solo tras confirmar que tu acción admite Authorization y un cuerpo JSON anidado.
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.
Configura la solicitud HTTP V2 en Integrately
- Elige el disparador de suscriptores de Mailchimp. Conserva los identificadores de audiencia y suscriptor, selecciona el campo de nombre real y omite los registros sin nombre.
- Busca en Webhook/API la acción para enviar datos a una URL. Antes de continuar, comprueba en tu cuenta que admite encabezados de autenticación y JSON anidado; esta guía no verifica los controles actuales del editor.
- Si la acción permite esa configuración, elige POST y la URL V2. Envía Authorization: Bearer YOUR_API_KEY y Content-Type: application/json mediante los controles disponibles.
- Crea un objeto JSON con type: name, value: nombre asignado y options con ai_mode: off. Inspecciona la vista previa: un formulario plano no equivale al cuerpo JSON de V2.
- Usa los controles de asignación o serialización JSON para los nombres dinámicos. Si la acción no conserva los encabezados o el JSON anidado, utiliza un paso compatible con HTTP. No traslades la clave ni el JSON a parámetros de URL.
| 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"
}
}Revisa el paso HTTP antes de activar las actualizaciones
Prueba deliberadamente una acción e inspecciona su respuesta antes de seleccionar campos posteriores. La acción nativa de GenderAPI.io y Webhook/API pueden mostrar etiquetas diferentes.
Mantén la clave en los controles de conexión o autenticación de solicitudes y limita quién puede ver o compartir el flujo. Esta guía no incluye una clave operativa, una conexión exportada ni una actualización de clientes ya configurada.
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 Mailchimp
Selecciona el destino con los identificadores de audiencia y suscriptor de Mailchimp guardados. Comprueba el estado del resultado, el acceso y el cargo antes de escribir en un campo de inferencia separado o una etiqueta aprobada. No conviertas un género ausente o null en una categoría predeterminada.
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.
Controla los reintentos y los cargos adicionales
Integrately documenta reintentos automáticos, incluidos controles que afectan a toda la empresa. Revisa la política y el historial de tareas antes de activar el flujo; evalúa el efecto en otras automatizaciones antes de modificar un ajuste compartido. Cada repetición de la consulta HTTP es una operación independiente con coste. Conserva las respuestas correctas para reparar fallos posteriores de Mailchimp sin consultar de nuevo.
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.
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 asignar probability de una acción nativa antigua a confidence de V2?
Revisa primero el contrato de respuesta. V2 devuelve data.confidence entre 0 y 1, o null, acompañado de data.confidence_kind. No se debe asumir que las etiquetas o la escala del conector nativo coinciden con esos campos.
¿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: . Consulta la documentación oficial de las plataformas para comprobar la configuración y disponibilidad actuales.