Choisissez la connexion Integrately adaptée à votre contrat
La recette HTTP de ce guide appelle GenderAPI.io V2 à l’adresse https://api.genderapi.io/api/v2/gender. Envoyez type et value dans le corps JSON ; lisez l’estimation dans data et les informations de requête et de facturation dans meta. Les connecteurs natifs ont leurs propres contrats, décrits ci-dessous.
La fiche GenderAPI.io d’Integrately renvoie vers genderapi.io et propose des actions pour les prénoms, les adresses e-mail et l’extraction d’un prénom à partir d’une adresse e-mail. Elle n’indique ni la version d’API sous-jacente ni le schéma de sortie complet ; les noms des actions ne suffisent pas à établir la compatibilité avec V2.
Integrately documente Webhook/API comme une action POST sortante. Ses contrôles actuels d’en-têtes et d’éditeur JSON n’ont pas été vérifiés de manière indépendante pour ce guide. N’appliquez le contrat HTTP V2 ci-dessous qu’après avoir confirmé que votre action peut envoyer un en-tête Authorization et un corps JSON imbriqué. Les actions natives existantes conservent leur propre contrat de champs.
Préparez le compte et l’enregistrement source
Cet exemple enrichit des enregistrements Mailchimp à partir d’un prénom. Vous avez besoin d’un accès aux applications source et destination, d’une clé de compte GenderAPI.io et des fonctions de la plateforme utilisées par l’action HTTP. Ce guide ne fournit ni identifiants opérationnels ni comptes connectés.
V1 et V2 utilisent la même clé de compte et le même solde. Avant de configurer une requête facturable, vérifiez la clé avec GET /api/v2/usage et contrôlez que meta.access.mode vaut api_key dans la réponse de cet endpoint. Une clé absente ou non reconnue peut basculer vers l’essai partagé par adresse IP ; une automatisation de production ne doit pas en dépendre à votre insu.
Laissez le workflow désactivé pendant la configuration. Une prédiction de test consomme des crédits normaux. Ces instructions ont été vérifiées à partir de la documentation publique et du contrat V2 ; aucun workflow authentifié n’a été exécuté de bout en bout sur une plateforme pour cette publication.
Configurez la requête GenderAPI.io V2 dans Integrately
- Choisissez le déclencheur d’abonné Mailchimp et examinez un enregistrement de test. Conservez les identifiants d’audience et d’abonné pour la mise à jour, sélectionnez le champ de prénom réel et ignorez les enregistrements sans prénom.
- Recherchez Webhook/API et son action d’envoi de données vers une URL. Avant de continuer, examinez la configuration disponible : le contrat suivant exige des en-têtes authentifiés et un corps JSON imbriqué, dont les contrôles actuels dans l’éditeur n’ont pas été vérifiés ici.
- Si l’action répond à ces exigences, sélectionnez POST et l’endpoint V2 ci-dessous. Faites en sorte que la requête sortante inclue Authorization: Bearer YOUR_API_KEY et Content-Type: application/json, à l’aide des contrôles disponibles dans votre compte.
- Construisez un corps JSON avec type = name, value = le prénom associé et options contenant ai_mode = off. Vérifiez l’aperçu de la requête de l’action choisie : une charge utile de formulaire plate n’est pas le corps JSON V2, même si l’en-tête Content-Type est défini.
- Utilisez les contrôles de mappage ou de sérialisation JSON de la plateforme pour les prénoms dynamiques. Si l’action choisie ne peut pas conserver le JSON imbriqué ou les en-têtes authentifiés, utilisez une étape compatible HTTP plutôt que de placer la clé ou le JSON dans des paramètres de requête.
| Paramètre HTTP | Valeur | Rôle |
|---|---|---|
Method | POST | Envoie une requête de prédiction unitaire. |
URL | https://api.genderapi.io/api/v2/gender | Endpoint V2 de prédiction unitaire de GenderAPI.io. |
Authorization | Bearer YOUR_API_KEY | Remplacez l’espace réservé à l’aide des contrôles d’authentification ou d’en-têtes de la plateforme. |
Content-Type | application/json | Envoie un objet contenant un objet options imbriqué, et non des champs de formulaire. |
options.ai_mode | off | Premier test délibéré limité au jeu de données : débit normal de 1 crédit, même si le résultat est unknown. |
Vérifiez le corps JSON avant l’envoi
Cet exemple illustre une entrée fixe ; ce n’est pas un résultat prédit. Vérifiez d’abord la structure de la requête, puis remplacez value par le champ source associé en utilisant une sérialisation JSON adaptée. N’envoyez pas à l’API des expressions de mappage de la plateforme sous forme de texte littéral.
Pour une autre entrée, indiquez name, email ou username dans type et fournissez la valeur correspondante dans value. N’ajoutez country que si vous disposez d’un contexte fiable : ce champ est facultatif et ne sert pas à déterminer le pays de résidence.
{
"type": "name",
"value": "Alice",
"options": {
"ai_mode": "off"
}
}Examinez l’étape HTTP avant d’activer les mises à jour
Testez délibérément une action et examinez le corps renvoyé avant de sélectionner les champs en aval. Les étapes natives GenderAPI.io et Webhook/API peuvent afficher des libellés de champs différents, même pour le même client source.
Conservez la clé dans les contrôles de connexion ou d’authentification de requête prévus et limitez les personnes qui peuvent voir ou partager l’automatisation. Ce guide public ne fournit ni clé opérationnelle, ni connexion exportée, ni mise à jour client préconfigurée.
Séparez les résultats identifiés, inconnus et les échecs
Analysez le corps de la réponse avant de choisir la mise à jour de destination. Les chemins JSON ci-dessous désignent le corps V2 ; votre plateforme peut l’encapsuler ou l’aplatir. Confirmez la structure réellement renvoyée par un test délibéré et conservez le résultat avec l’identifiant de l’enregistrement source.
Une estimation n’établit ni l’identité d’une personne ni le genre qu’elle déclare. Stockez-la séparément des informations fournies par la personne. Définissez vos critères d’acceptation à partir de données représentatives de votre propre usage et évaluez séparément la confiance issue du jeu de données et celle de l’IA.
| Contrôle | Valeur ou type attendu | Décision du workflow |
|---|---|---|
meta.access.mode | api_key pour ce workflow de compte | Arrêtez le workflow si la valeur est ip_trial et corrigez la clé. Une réponse d’essai réussie ne prouve pas l’authentification du compte et peut déjà avoir consommé des crédits d’essai. |
meta.usage.billing_status | confirmed ou unconfirmed | Si la valeur est unconfirmed, conservez l’identifiant de requête et faites rapprocher la facturation avant de relancer ou de poursuivre. |
data.result_status / data.gender | identified avec male ou female ; unknown avec null | Enregistrez les résultats identifiés acceptés dans un champ d’inférence distinct. Conservez unknown sans attribuer de catégorie par défaut. |
data.confidence / data.confidence_kind | nombre de 0 à 1 ou null ; type de preuve ou null | Interprétez observed_frequency et model_reported séparément ; aucun des deux ne garantit une exactitude universelle. |
data.source / data.sample_count | dataset, ai ou none / entier ou null | Conservez l’origine de l’estimation. L’IA n’a pas de nombre d’échantillons enregistré ; un effectif du jeu de données n’est pas un score d’exactitude du produit. |
meta.request_id / meta.usage | référence de requête / objet de consommation | Enregistrez-les avec l’enregistrement du workflow et le résultat. Tenez les clés API et les données personnelles superflues à l’écart des journaux courants. |
Échec HTTP / réponse absente | Problem Details ou absence de réponse complète | Suspendez la mise à jour et examinez l’erreur et l’état de facturation. Un délai d’attente dépassé ne prouve pas que le serveur n’a rien traité. |
Mettez à jour uniquement l’enregistrement Mailchimp visé
Utilisez les identifiants d’audience et d’abonné Mailchimp enregistrés pour sélectionner l’enregistrement de destination. Ajoutez des conditions sur l’état du résultat et sur les contrôles d’accès et de facturation ci-dessus avant d’écrire dans un champ d’inférence distinct ou une étiquette approuvée. Ne transformez jamais un genre absent ou null en catégorie de contact par défaut.
Testez les branches identifiée, inconnue et d’erreur avant d’activer les mises à jour. Des réponses d’exemple fictives permettent d’exercer les conditions de branchement sans envoyer de nouvelle prédiction. La mise à jour de destination doit dépendre des contrôles ci-dessus et ne doit pas écraser de champs ou d’étiquettes sans rapport.
Maîtrisez les relances et les débits répétés
Integrately documente un comportement de nouvelle tentative automatique, y compris des réglages qui s’appliquent à toute l’entreprise. Examinez la politique et l’historique des tâches avant d’activer cette automatisation, et évaluez les autres workflows avant de modifier un réglage partagé. Chaque requête HTTP répétée est une requête facturable indépendante ; conservez les sorties réussies afin de corriger un échec Mailchimp ultérieur sans nouvelle requête.
Chaque nouvelle requête GenderAPI est une opération indépendante. Dédupliquez les événements source répétés dans votre propre workflow avant l’envoi, à l’aide d’un identifiant source enregistré et d’un état de traitement. L’identifiant d’un enregistrement source n’est pas une clé de protection contre les relances côté serveur.
Un résultat unknown réussi est un résultat complet et facturable. En cas de délai dépassé ou de réponse incomplète, le résultat et le débit peuvent être inconnus : conservez la référence de requête lorsqu’elle est disponible et rapprochez la facturation avant de renvoyer la requête. Respectez Retry-After lorsqu’il accompagne une réponse de limitation de débit.
Choisissez quand utiliser l’IA
forceToGenderize est facultatif pour les noms, les adresses e-mail et les noms d’utilisateur. Lorsqu’il est activé, omettez ai_mode ou utilisez fallback : la combinaison avec off ou always renvoie une erreur 422. Un solde de départ positif suffit pour lancer une requête, même si le débit final fait passer le solde en dessous de zéro.
L’analyse des pseudonymes peut renvoyer un genre avec name: null. Elle peut aussi renvoyer unknown. Ni le repli IA standard ni l’analyse des pseudonymes ne garantissent une réponse correcte ou non nulle.
| Option de la requête | Comportement | Crédits par requête aboutie |
|---|---|---|
| options.ai_mode: off | Interroge uniquement le jeu de données. | 1 crédit, unknown compris |
| options.ai_mode: fallback | Interroge d’abord le jeu de données, puis l’IA standard si aucun genre n’est trouvé. C’est le mode par défaut des requêtes individuelles. | 1 crédit au total, repli IA compris |
| options.ai_mode: always | Interroge directement l’IA. | 2 crédits |
| forceToGenderize: true | Interroge d’abord le jeu de données ; si aucun genre n’est trouvé, autorise l’IA à interpréter le sens d’un surnom ou d’un pseudonyme personnel, même sans prénom réel. | 1 crédit si le jeu de données résout la requête ; 2 au total si l’IA est utilisée |
Validez le workflow avant d’augmenter le volume
- Lors d’un test délibéré, vérifiez le JSON réellement sérialisé, les chemins de sortie analysés, l’accès par clé API et la confirmation de la facturation. Testez le routage des résultats inconnus et des échecs avec des réponses fictives lorsque c’est possible.
- Identifiez les étapes du workflow qui sont relancées et les champs client qui changent. Conservez l’identifiant de l’enregistrement source, la réponse obtenue et la référence de requête : un échec ultérieur à destination ne doit pas exiger une nouvelle requête.
- Activez d’abord une exécution restreinte et contrôlée, puis examinez ses enregistrements et ses crédits avant d’augmenter la concurrence. Les crédits GenderAPI et les tâches ou opérations facturées par la plateforme d’automatisation sont des coûts distincts.
- Pour un lot, utilisez POST /api/v2/gender/batch avec jusqu’à 50 éléments en accès par clé API, ou 10 avec l’essai par IP. Le tableau items peut mélanger prénoms, adresses e-mail et noms d’utilisateur, avec des options explicites et un identifiant unique par élément. Examinez chaque résultat : une réponse HTTP 200 peut contenir des échecs partiels. La prise en charge des lots par un connecteur natif doit être vérifiée séparément.
Questions fréquentes
Puis-je associer le champ probability d’une ancienne action native au champ confidence de V2 ?
Examinez d’abord le contrat de réponse. Une requête V2 directe renvoie data.confidence avec data.confidence_kind, sur une échelle de 0 à 1, ou null. Rien ne permet de supposer que les libellés et l’échelle des champs d’un connecteur natif correspondent à ces chemins.
L’exemple HTTP direct autorise-t-il l’IA ?
Le corps de la première requête définit options.ai_mode sur off. Passez délibérément à fallback pour un repli IA ordinaire, pour 1 crédit au total, ou à always pour utiliser directement l’IA, pour 2 crédits. forceToGenderize interroge d’abord le jeu de données : 1 crédit si la requête y est résolue, 2 au total lorsque l’IA est utilisée.
Un résultat inconnu est-il gratuit, ou peut-on le relancer automatiquement sans risque ?
Non. Un résultat unknown réussi est complet et facturable. Une relance est une nouvelle opération. En cas d’erreur de transport ou de facturation non confirmée, examinez la consommation et la référence de requête renvoyées avant de décider de renvoyer la requête.
Ce workflow a-t-il été exécuté dans un compte connecté ?
Non. Les instructions de configuration des plateformes ont été vérifiées le 26 septembre 2026 à partir de leur documentation publique. Les explications sur la requête et la réponse GenderAPI.io V2 ont été vérifiées le 27 septembre 2026. La révision de cette version française, le 28 septembre 2026, porte sur la traduction et ne constitue pas un nouveau test de compte. Testez les champs actuels de l’action choisie, l’authentification, le corps, la réponse et les nouvelles tentatives dans votre propre compte avant d’activer les mises à jour en production.
Documentation de référence
Dernière révision de la version française : . Les consignes propres aux plateformes reposent sur leur documentation publique examinée le 26 septembre 2026 ; cette révision ne constitue pas un nouveau test dans un compte connecté. Consultez la documentation officielle des plateformes pour vérifier la configuration et la disponibilité actuelles.