# Connecter GenderAPI.io V2 à Pipedream

> Connectez Pipedream à GenderAPI.io V2 pour vos enregistrements Twilio SendGrid. Choisissez le bon connecteur, envoyez type et value, puis exploitez data, meta, les crédits et les échecs.

Canonical HTML: https://www.genderapi.io/fr/blog/pipedream-gender-api-integration

Last reviewed: 2026-09-28

## Choisissez la connexion Pipedream 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 composant public GenderAPI.io de Pipedream examiné le 26 septembre 2026 utilise l’ancienne base https://api.genderapi.io/api et envoie name ou email, country facultatif et la clé API comme paramètres de requête. Cette implémentation publiée est un connecteur V1, et non l’endpoint JSON V2.

Vous pouvez conserver une action native existante avec son propre contrat ou ajouter une étape HTTP générique pour V2. Ne supposez pas que l’authentification automatique du compte natif connecté convient à cette requête V2 distincte : la recette utilise explicitement un en-tête Bearer.

- [Application GenderAPI.io sur Pipedream](https://pipedream.com/apps/genderapi-io)
- [Référence V1 existante](https://www.genderapi.io/fr/api-documentation/v1)

## Préparez le compte et l’enregistrement source

Cet exemple enrichit des enregistrements Twilio SendGrid à partir d’une adresse e-mail. 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.

- [Authentification et vérification gratuite de la consommation](https://www.genderapi.io/fr/docs/v2/authentication#environment-setup)

## Configurez la requête GenderAPI.io V2 dans Pipedream

- Choisissez l’événement ou la planification Twilio SendGrid adaptés à votre compte et à votre workflow. Examinez un contact de test, conservez son identifiant stable et ignorez les adresses e-mail vides avant l’étape d’enrichissement. L’intervalle disponible pour le déclencheur est un réglage de la plateforme, et non une garantie de GenderAPI.
- Ajoutez l’action Send any HTTP Request, sélectionnez POST et indiquez l’URL ci-dessous. Configurez un corps JSON avec type = email, value = l’adresse e-mail du contact et options.ai_mode = off.
- Enregistrez la clé avec les contrôles d’identifiants ou de variables d’environnement de Pipedream. Définissez Authorization sur Bearer suivi de ce secret et Content-Type sur application/json. Ne réutilisez pas l’authentification native par clé dans la chaîne de requête et n’affichez pas la clé dans une étape.
- Construisez le corps comme un objet JSON avec les contrôles de mappage pris en charge par l’action. N’assemblez pas de JSON brut en concaténant des valeurs de contact non échappées. Examinez l’aperçu de la requête avant de lancer délibérément un test.

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

**Requête JSON V2 pour Pipedream**

```json
{
  "type": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}
```

- [Champs de requête, types et valeurs par défaut](https://www.genderapi.io/fr/docs/v2/request-parameters)

## Examinez l’étape HTTP avant d’activer les mises à jour

Examinez la réponse exportée par l’étape HTTP et repérez le corps analysé. Si l’action choisie renvoie le corps sous forme de texte, analysez-le une seule fois avant de lire data et meta. Le champ data d’une enveloppe de transport est distinct du champ data du corps V2.

Pour un workflow en code avec un contrôle explicite des délais d’attente, des redirections et des nouvelles tentatives, utilisez le guide Node.js testé indiqué ci-dessous. L’action générique et l’application native peuvent avoir des comportements de transport par défaut différents.

- [Composant public GenderAPI.io de Pipedream](https://github.com/PipedreamHQ/pipedream/blob/master/components/genderapi_io/genderapi_io.app.mjs)
- [Actions de requête HTTP de Pipedream](https://pipedream.com/docs/workflows/building-workflows/http)
- [Variables d’environnement secrètes de Pipedream](https://pipedream.com/docs/workflows/environment-variables)
- [Paramètres de workflow et nouvelles tentatives de Pipedream](https://pipedream.com/docs/workflows/building-workflows/settings)

## 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é. |

- [Référence complète des réponses V2](https://www.genderapi.io/fr/docs/v2/responses)
- [Erreurs et décisions de nouvelle tentative](https://www.genderapi.io/fr/docs/v2/errors-and-retries)

## Mettez à jour uniquement l’enregistrement Twilio SendGrid visé

Conservez l’identifiant de contact renvoyé par le déclencheur avec le corps V2 analysé. Après les contrôles de résultat ci-dessus, mettez à jour uniquement les champs personnalisés SendGrid prévus. Préservez le prénom fourni par le contact : un data.name déduit d’une adresse e-mail est un candidat inféré, et non un remplacement vérifié.

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.

- [Champs de réponse et résultats inconnus](https://www.genderapi.io/fr/docs/v2/responses)
- [Exactitude et confiance](https://www.genderapi.io/fr/accuracy-methodology)
- [Sources des données et profil du jeu de données](https://www.genderapi.io/fr/data-provenance)

## Maîtrisez les relances et les débits répétés

Pipedream documente des nouvelles tentatives automatiques à partir de l’étape en échec, selon le forfait. Examinez ces paramètres et le comportement de relance de l’action HTTP choisie. Relancer une étape d’enrichissement en échec peut entraîner un nouveau débit ; un échec ultérieur à destination doit être corrigé à partir de la sortie d’enrichissement 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.

- [Crédits et états de facturation](https://www.genderapi.io/fr/docs/v2/credits-and-usage)

## 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 |

- [Options d’IA et analyse des pseudonymes](https://www.genderapi.io/fr/docs/v2/ai-options)
- [Crédits et consommation](https://www.genderapi.io/fr/docs/v2/credits-and-usage)

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

- [Lots et échecs partiels](https://www.genderapi.io/fr/docs/v2/batch)
- [Guide d’implémentation Python](https://www.genderapi.io/fr/integrations/python)
- [Guide d’implémentation Node.js](https://www.genderapi.io/fr/integrations/javascript)

## L’action native GenderAPI.io de Pipedream utilise-t-elle V2 ?

Le composant public examiné le 26 septembre 2026 utilise les anciens endpoints V1 et une authentification par clé dans la chaîne de requête. Pour une requête V2, utilisez la recette HTTP V2 explicite et revérifiez le composant publié si sa version change.

## 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

- [Application GenderAPI.io sur Pipedream](https://pipedream.com/apps/genderapi-io)
- [Composant public GenderAPI.io de Pipedream](https://github.com/PipedreamHQ/pipedream/blob/master/components/genderapi_io/genderapi_io.app.mjs)
- [Actions de requête HTTP de Pipedream](https://pipedream.com/docs/workflows/building-workflows/http)
- [Variables d’environnement secrètes de Pipedream](https://pipedream.com/docs/workflows/environment-variables)
- [Paramètres de workflow et nouvelles tentatives de Pipedream](https://pipedream.com/docs/workflows/building-workflows/settings)
- [Contrat de requête GenderAPI.io V2](https://www.genderapi.io/fr/docs/v2/request-parameters)
- [Contrat de réponse GenderAPI.io V2](https://www.genderapi.io/fr/docs/v2/responses)
- [Facturation et crédits GenderAPI.io V2](https://www.genderapi.io/fr/docs/v2/credits-and-usage)