Choisissez la connexion Pabbly Connect 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.
Le catalogue public de Pabbly contient une application nommée Gender API, mais l’entrée examinée n’indique ni le domaine du fournisseur, ni la version de l’endpoint, ni le schéma de réponse complet. Ce nom ne prouve pas à lui seul qu’il s’agit de GenderAPI.io. Vérifiez le fournisseur et les champs réels avant de choisir une action native.
Pour un endpoint V2 explicite, utilisez la fonction de requête API personnalisée d’API by Pabbly. Cette recette décrit cette requête HTTP ; elle n’affirme pas qu’un connecteur natif a été migré vers V2.
Préparez le compte et l’enregistrement source
Cet exemple enrichit des enregistrements Shopify à 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 Pabbly Connect
- Choisissez le déclencheur Shopify correspondant à l’événement client voulu et capturez un enregistrement de test représentatif. Conservez l’identifiant du client et associez un champ de prénom disponible. Ignorez un prénom vide au lieu de le remplacer par l’enregistrement client complet.
- Ajoutez API by Pabbly et sélectionnez Custom Request. Choisissez POST et l’URL V2 ci-dessous. Configurez l’authentification Bearer token avec votre clé GenderAPI, ou un en-tête Authorization dont la valeur complète est Bearer YOUR_API_KEY ; ne configurez pas les deux mécanismes.
- Définissez Content-Type sur application/json. Custom Request propose un champ Data pour le corps JSON. Construisez un objet avec type = name, value = le prénom associé et un objet options contenant ai_mode = off. L’en-tête Content-Type décrit le corps annoncé ; il ne transforme pas à lui seul des champs de formulaire en objet JSON.
- Gardez options imbriqué. Si l’action choisie n’accepte que du JSON brut, assurez-vous que les guillemets, barres obliques inverses et sauts de ligne des valeurs associées sont correctement échappés ; utilisez une étape de construction JSON prise en charge plutôt que d’insérer du texte client non échappé.
| 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
Examinez le corps de réponse capturé et vérifiez que l’étape suivante lit le corps V2, et non les champs d’état du transport. Pabbly peut exposer des clés de réponse pour les mappages ultérieurs ; vérifiez leur chemin réel dans votre workflow.
Pendant la configuration, n’exécutez que l’action de test choisie. Un test qui envoie la requête peut consommer des crédits GenderAPI et des tâches de la plateforme avant même l’activation du workflow.
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 Shopify visé
Conservez l’identifiant client Shopify fourni par le déclencheur. Dirigez les résultats identifiés confirmés vers le champ client ou la politique d’étiquettes prévus, conservez les résultats inconnus comme inconnus et ne modifiez pas le prénom fourni par le client. Enregistrez source et confidence_kind avec toute estimation acceptée.
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
Pabbly documente Auto Re-execution et des options manuelles pour réexécuter les étapes en échec ou ignorées, ou le workflow entier. Vérifiez ce qui sera exécuté avant d’utiliser l’une ou l’autre option. Réexécuter tout le workflow peut répéter une requête GenderAPI déjà aboutie ; lorsque c’est possible, corrigez un échec Shopify ultérieur à partir de la réponse enregistrée.
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 utiliser un champ de formulaire plat options.ai_mode dans Pabbly ?
Le corps POST V2 exige un objet JSON options. Un point dans le libellé d’un champ ne prouve pas à lui seul que la plateforme crée un objet imbriqué. Examinez le corps sérialisé et vérifiez qu’il correspond à l’exemple avant d’envoyer la requête.
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.