Question 1

Que se passe-t-il si un prénom peut être à la fois masculin et féminin ?

Accepted Answer

Selon la version de ton API ou l'intégration que tu utilises, nos endpoints renverront soit une précision soit une valeur de probabilité dans la réponse. Le paramètre de précision indique à quel point nous sommes sûrs que ce nom est soit masculin soit féminin. 
          La valeur est calculée par le nombre d'enregistrements dans notre base de données. Par exemple, si nous avons 100 échantillons d'un nom, 96 sont féminins, et 4 sont masculin, 
 la précision est de 96 % (ou une probabilité de 0,96). Une faible précision indique que ce nom est probablement utilisé par plusieurs genres et ne peut être 
 conjugué à un genre spécifique.

Question 2

Peut-il y avoir des différences pour le même nom par pays ?

Accepted Answer

Alors qu’Andrea est un prénom masculin en Italie, c’est un prénom féminin en Allemagne, et il peut même être les deux aux États-Unis. Dans ce cas, nous fournissons dans le résultat une valeur de précision comprise entre 0 et 100 (ou une probabilité entre 0 et 1). Elle t’indique à quel point nous sommes certains d’avoir détecté le bon genre. Tu peux augmenter nettement la qualité des résultats de l’API en fournissant une information géographique avec ta requête : un code pays, la locale du navigateur ou une adresse IP. Tu peux en savoir plus sur la localisation d’une requête dans notre documentation API.

Question 3

Comment recueilles-tu les données ?

Accepted Answer

Pour fournir la plus grande précision possible, nous combinons les données de plusieurs sources. Les principales sources de nouveaux enregistrements sont les données publiques, 
 les données gouvernementales et les ajouts/corrections manuels. En fonction de la source d'un nouveau nom, il se peut que le nom doive être vérifié par une seconde source avant d'être ajouté à notre liste. 
        Par exemple, si nous ajoutons un nom à partir de données accessibles au public, ce nom peut nécessiter une deuxième vérification, comme une confirmation manuelle, avant qu'il soit finalement ajouté à notre base de données.
Tu peux trouver une liste des pays supportés ici.

Question 4

À quelle fréquence mets-tu à jour les enregistrements de noms ?

Accepted Answer

Nous mettons régulièrement à jour nos données en fonction du pays et des données publiques disponibles. La plupart des pays occidentaux sont mis à jour une fois par an. La répartition des prénoms entre les genres peut aussi changer au fil des ans : un prénom porté exclusivement par des femmes dans les années 1970 peut être porté majoritairement par des hommes des décennies plus tard. C’est pourquoi nous utilisons également des données de naissance pour plusieurs pays, comme les États-Unis, afin d’enrichir les résultats. Nos modèles tentent de prendre en compte tous ces facteurs au mieux. La valeur de précision renvoyée est régulièrement ajustée pour refléter l’usage réel dans la population aussi fidèlement que possible. Elle est censée fournir une évaluation raisonnable basée sur les dernières décennies et peut exprimer une fluctuation possible. Nous regardons environ les quatre dernières décennies. Si tu exécutes une requête et que tu la répètes un an plus tard, tu peux obtenir un résultat différent, parce que notre système a peut-être écarté d’anciennes données et que de nouvelles données ont pu être ajoutées. Chaque fois que de nouvelles données sont ajoutées, nous réalisons ensuite des tests d’intégration : notre API est testée contre un jeu de données validé au préalable, pour en garantir la qualité. Ce jeu de données est enrichi en continu de prénoms et de cas de test, afin d’obtenir la couverture la plus large possible.

Question 5

Comment utilisez-vous l’IA ?

Accepted Answer

L’intelligence artificielle (IA) est utilisée quotidiennement pour améliorer la qualité de notre base de données et de nos résultats API. Grâce à l’IA, nous pouvons ajouter de nouvelles entrées à notre base de données de manière efficace et précise, en veillant à ce que nos informations soient toujours à jour.

De plus, l’IA joue également un rôle crucial dans l’amélioration globale de la qualité de nos résultats API. En exploitant des algorithmes d’apprentissage automatique, nous pouvons analyser les données de manière plus efficace, identifier des modèles et fournir des résultats plus précis et pertinents à nos utilisateurs.

Question 6

Fournis-tu une assistance dans la mise en œuvre de l’API ?

Accepted Answer

Oui, nous fournissons une assistance par e-mail à tous nos clients. Tu peux nous envoyer un e-mail à
                        contact gender-api.com. Nous te répondrons dans les plus brefs délais. Tu peux également trouver des exemples de codage ici.
                        Merci de noter que nous ne pouvons pas t'aider pour tous les langages de programmation et tous les cas d'utilisation. 
                        Dans la plupart des cas, tu peux utiliser un client de repos standard dans ton application pour interroger notre API.
                        De nombreuses bibliothèques prennent également en charge l'importation d'un fichier de définition OpenAPI. Tu peux télécharger notre fichier de définition openapi.yml ici.

Question 7

Et si nous avons besoin d'un haut niveau de précision ?

Accepted Answer

Les langues et les prénoms évoluent avec le temps. La qualité, l’étendue et l’origine des jeux de données varient aussi beaucoup d’un client à l’autre. Nous ne pouvons donc pas garantir que tous les résultats que tu reçois de notre API soient corrects à 100% et correspondent à ton propre jeu de données. Mais nous pouvons te promettre que nous nous engageons toujours à te fournir les meilleurs résultats possibles, que nous améliorons et mettons à jour nos algorithmes régulièrement, et que nous ajoutons de nouvelles données très régulièrement. Tu peux en savoir plus sur nos mises à jour ici. Dans le cas peu probable où notre service ne répondrait pas à tes attentes, nous t’offrons une garantie de remboursement de 14 jours sans condition.
Bien sûr, tu peux aussi tester notre service entièrement gratuitement. Si tu t’inscris ici, tu reçois 100 requêtes gratuites chaque mois.
Lorsque tu interroges un prénom, nos endpoints renvoient dans la réponse une valeur de précision ou de probabilité, selon la version de l’API que tu utilises.
Le paramètre de précision indique notre degré de certitude quant au fait que ce prénom soit masculin ou féminin.
La valeur est calculée à partir du nombre d’enregistrements correspondants dans notre base de données.
Comme les cas d’usage diffèrent beaucoup, nous ne donnons pas de recommandation sur le niveau de précision. Selon ton cas d’usage, c’est à toi de décider quels résultats et quels niveaux de précision accepter.
Même avec une précision d’au moins 99%, il reste une possibilité que le résultat soit incorrect.
Une valeur supérieure à 95% convient toutefois à la plupart des cas d’usage.

Question 8

Combien de noms sont stockés dans ta base de données ?

Accepted Answer

Notre base de données contient 6,084,389 noms validés par 191 pays. À travers le monde, nous stockons 6,450,268 noms uniques.
Nous analysons en moyenne environ 10 000 000 jeux de données par mois afin d’améliorer la qualité de nos résultats.

Question 9

Quels sont les pays pris en charge ?

Accepted Answer

L’API prend entièrement en charge 191 pays. Une prise en charge complète signifie que nous avons recueilli au moins  noms 
                      dans un pays donné. Toutefois merci de noter que dans la plupart des pays, notre ensemble de données est beaucoup plus important. Nous t’invitons à consulter le tableau ci-après 
                      afin d’en savoir davantage sur le nombre de noms que nous prenons en charge dans tel ou tel pays. Et n’oublie pas que si nous n’assurons pas nous-mêmes une prise en charge appropriée 
                     pour un pays spécifique, tu peux toujours analyser les noms en question dans l’ensemble des données dans son intégralité afin d’obtenir un résultat adéquat.

Question 10

Prenez-vous en charge les noms arabes ?

Accepted Answer

Oui, notre API prend en charge les noms arabes. Ils peuvent également être écrits dans des caractères de l’alphabet arabe.
L’arabe s’écrit de droite à gauche en style cursif et comprend 28 lettres.
À titre d’exemple, si tu interroges “عبد ال”, tu obtiendras le résultat suivant : “gender” : “homme”, “accuracy” : 100.
Le nom arabe “عبد ال” est encodé en URL dans cet exemple et l’URL de requête ressemblerait à ceci : https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY.
Vous peux trouver une liste complète des pays pris en charge ici.

Question 11

Puis-je interroger plusieurs noms en une seule requête ?

Accepted Answer

Oui, cela est tout à fait possible. Tu peux faire une demande pour un maximum de 100 noms en même temps.
Pour plus d’informations, merci de consulter nos API documents.

Question 12

J’ai entendu parler de ton API pour adresses e-mail. De quoi s’agit-il exactement ?

Accepted Answer

Notre API e-mail peut extraire des prénoms depuis des adresses e-mail et déterminer le genre correspondant. Cela te permet de personnaliser tes e-mails avec la bonne formule d’appel. Par exemple, pour l’adresse « marie.johnson@gmail.com », l’API extrait le prénom « Marie » et détermine le bon genre, à savoir « female ». Pour plus de détails, consulte notre documentation API.

Question 13

Je dispose d’une très grande quantité de données. Puis-je importer un fichier CSV en masse ?

Accepted Answer

En tant qu’utilisateur enregistré, tu peux importer n’importe quel fichier CSV comportant une colonne de prénoms. Pour un meilleur résultat, tu peux aussi ajouter une colonne de pays à ton jeu de données. Il n’est pas nécessaire de nommer les colonnes d’une manière particulière : notre assistant te guide tout au long du processus en te laissant indiquer quelle colonne contient quelle information, prénom et pays compris. La fonctionnalité se trouve dans ton compte. Les enregistrements traités sont facturés comme des requêtes, tu peux donc importer gratuitement un fichier CSV de 100 entrées par mois. L’import CSV en masse nécessite un compte Gender-API.com. Pour des raisons de protection des données, les fichiers importés sont automatiquement supprimés au bout d’un an.

Question 14

Comment faut-il formater le fichier CSV ?

Accepted Answer

Nous prenons en charge les fichiers CSV créés sous Windows, macOS ou Linux.
Nous acceptons aussi les fichiers avec des séparateurs comme « ; », « , » ou une tabulation. Le caractère d’encadrement doit être « " ».
Tu peux également importer des fichiers CSV multilignes comportant au maximum 10 000 000 lignes et 301 MB.
Pour obtenir les meilleurs résultats possibles, nous te recommandons un fichier CSV encodé en UTF-8 avec un point-virgule comme séparateur.
Le fichier CSV peut par ailleurs contenir d’autres colonnes quelconques, qui seront reprises dans le fichier de sortie.
Il doit comporter au moins une colonne de prénoms seuls ou une colonne de noms complets.
Clique ici pour télécharger un fichier d’exemple. Merci de créer un compte Gender-API.com pour importer un fichier CSV.

Question 15

Puis-je importer un fichier Excel ?

Accepted Answer

Tu peux importer des fichiers Excel comportant jusqu’à 300 000 lignes. Pour les jeux de données plus importants, utilise notre import de fichier CSV.
Nous prenons en charge les fichiers .xlsx comportant une seule feuille. Si tu importes un fichier contenant plusieurs feuilles, seule la première est traitée.
La première ligne de ta feuille doit contenir les noms de colonnes. Le fichier doit comporter au moins une colonne de prénoms ; la colonne de pays est facultative. Pour des raisons de protection des données, les fichiers importés sont automatiquement supprimés au bout d’un an. Télécharger un exemple de fichier ici. Exemple :

Question 16

J’ai trouvé un bogue. Que dois-je faire ?

Accepted Answer

Nous apprécions vraiment ton aide en la matière. Merci de nous envoyer un e-mail à contact gender-api.com et nous corrigerons ce bogue dès que possible.

Question 17

Gender-API est-il conforme au Règlement Général sur la Protection des Données (RGPD) ?

Accepted Answer

Tous les services de Gender-API.com sont pleinement conformes au RGPD.
Nous fournissons un accord de traitement des données (DPA) qui te permet de respecter tes obligations RGPD.
Tu peux demander cet accord ici dans ton compte. Un exemple d’accord peut être téléchargé ici.
Tu trouveras aussi plus d’informations sur la manière dont nous protégeons tes données ici.

Question 18

Fournis-tu des bibliothèques de langages de programmation ?

Accepted Answer

En raison de la simplicité de notre API, nous ne fournissons pas de librairie pour un quelconque langage de programmation,
                            à l'exception du plugin jQuery. La plupart des langages supportent un analyseur json prêt à l'emploi et
                            pour presque tous les autres langages, il existe déjà une bibliothèque externe que tu peux utiliser. Jètes un coup d'œil à
                            nos exemples de codage pour commencer à utiliser l'API :

Question 19

Comment les requêtes sont-elles comptabilisées ?

Accepted Answer

Chaque compte sera rechargé à 100 requêtes le premier jour de chaque mois s’il reste moins de ce nombre de requêtes.
                Une requête n’est décomptée que si un résultat est trouvé. Une recherche pour un prénom compte comme une requête.
                Si plusieurs prénoms sont demandés dans une seule requête, chaque prénom sera compté comme une requête distincte.

Question 20

Où puis-je trouver et gérer mes clés API ?

Accepted Answer

Nous générons une première clé API lors de ton inscription à un compte Gender-API.com. Tu trouves cette clé API en bas de la page d’aperçu de ton compte. Si tu veux la révoquer, clique sur le bouton « Révoquer et régénérer ». Notre système invalide alors la clé existante et en génère une nouvelle. Toutes tes applications qui utilisent l’ancien token n’ont plus accès à notre API jusqu’à ce que tu remplaces ce code par la nouvelle clé API. [apiKeyImage] Tu peux aussi créer plusieurs clés API. C’est utile, par exemple, si tu veux intégrer notre API dans plusieurs applications. Note qu’il n’y a aucune distinction entre les clés et le nombre de requêtes qu’elles ont consommées. Toutes les requêtes sont comptabilisées ensemble. Pour gérer ou créer plusieurs clés API, clique sur le bouton « Paramètres » dans le menu du compte, puis sur « Clés API ». [multipleKeysImage] En cliquant sur le bouton « Créer une nouvelle clé », tu génères une nouvelle clé API. Tu peux donner un nom à chaque token pour retrouver plus facilement où cette clé est utilisée, et tu peux changer ce nom à tout moment. Certains de nos widgets génèrent aussi une clé ici : par exemple, si tu utilises le widget « Recherche rapide » dans ton compte, notre système génère une clé à l’avance et le widget l’utilise pour interroger notre API. De même, les applications tierces créent une clé ici dès qu’elles sont connectées. Chaque token peut être révoqué à tout moment en cliquant simplement sur le « x ». Une fois révoquée, l’application connectée n’a plus accès à notre API.

Question 21

Puis-je partager mon compte avec plusieurs personnes ?

Accepted Answer

Tu peux partager ton compte avec jusqu’à 50 collègues ou autres personnes liées à ton projet. Pour gérer ton équipe, connecte-toi à ton compte et, dans le menu du compte, clique 
        sur « Paramètres » => « Gérer ton équipe ». Sur cette page, clique sur le bouton « Inviter un nouveau membre » pour inviter des personnes par e-mail. À l’invitation, tu choisis entre deux types de compte. 
        A) Les utilisateurs peuvent consulter, créer, modifier et supprimer des clés API, importer et enrichir des fichiers CSV et Excel, accéder à tous les endpoints de l’API, acheter des requêtes et connecter des applications tierces. B) Les administrateurs peuvent faire tout cela, et en plus 
        modifier les paramètres du compte et l’adresse de facturation, créer et consulter des accords de traitement des données, inviter, modifier et supprimer des membres de l’équipe.

Question 22

Puis-je protéger mon compte en activant la vérification en deux étapes ?

Accepted Answer

Tu peux protéger ton compte en activant la vérification en deux étapes. Pour activer cette mesure de sécurité supplémentaire, connecte-toi à ton compte et, dans le menu du compte, clique sur « Paramètres » => 
        « Modifier le mot de passe / 2FA ». Assure-toi qu’une application d’authentification est installée sur ton téléphone. Nous te recommandons une application comme Authy (App Store, Play Store) ou Google Authenticator (App Store, Play Store). 
        Clique ensuite sur le bouton « Activer maintenant » et suis les instructions à l’écran. Tu peux ajouter plusieurs appareils ici pour garder l’accès à ton compte même après avoir perdu un appareil.
        Une fois la fonction activée, tu devras saisir le code généré par l’application d’authentification de ton téléphone pour te connecter.

Question 23

Puis-je utiliser des applications tierces lorsque la vérification en deux étapes est activée ?

Accepted Answer

Certaines intégrations ou applications tierces fonctionnent parfaitement avec la vérification en deux étapes activée. D'autres peuvent demander 
        à se connecter sans vérification en deux étapes. Si tu rencontres des problèmes pour te connecter à une application avec tes informations d'identification Gender-API.com, connecte-toi directement à ton compte sur Gender-API 
        et clique sur "Réglages" => "Changer le mot de passe / 2FA" dans le menu du compte. Clique ensuite sur l'onglet "Vérification en deux étapes" et règle "Accès aux applications tierces" sur "Non restreint". 
       Merci de noter que tu ne peux modifier ce paramètre que si la vérification en deux étapes est activée.

Question 24

Que sont les passkeys et comment fonctionnent-elles ?

Accepted Answer

Les passkeys sont une méthode d’authentification moderne et sans mot de passe qui offre une sécurité plus élevée que les mots de passe traditionnels. Au lieu de saisir un mot de passe, tu te connectes avec les fonctions de sécurité intégrées de ton appareil : Face ID, Touch ID, Windows Hello ou un code PIN. Les passkeys reposent sur la norme WebAuthn et résistent au phishing, car elles sont liées cryptographiquement à un site web précis. Ta clé privée ne quitte jamais ton appareil, ce qui rend les passkeys plus sûres que les mots de passe. Une fois une passkey configurée pour ton compte Gender-API.com, tu te connectes d’un simple toucher ou d’un regard – aucun mot de passe requis. Les passkeys fonctionnent sur plusieurs appareils et peuvent être synchronisées via iCloud Keychain, Google Password Manager ou des services similaires.

Question 25

Comment configurer une passkey pour mon compte ?

Accepted Answer

La configuration d’une passkey se fait automatiquement pendant la connexion. Lorsque tu te connectes avec ton adresse e-mail et ton mot de passe, nous te proposons de créer une passkey pour accélérer tes prochaines connexions. Suis simplement les instructions affichées par ton appareil : ton navigateur te demande de vérifier ton identité avec Face ID, Touch ID, Windows Hello ou le code PIN de ton appareil. Une fois la vérification faite, la passkey est enregistrée automatiquement sur ton appareil et prête à l’emploi. À ta prochaine visite sur Gender-API.com, tu te connectes instantanément avec ta passkey au lieu de saisir ton mot de passe. Tu peux ignorer cette configuration si tu préfères continuer avec ton mot de passe. Remarque : les passkeys nécessitent un navigateur (Chrome, Safari, Edge, Firefox) et un système d’exploitation compatibles.

Question 26

En quoi les passkeys sont-elles différentes de l'authentification à deux facteurs (2FA) ?

Accepted Answer

Les deux renforcent la sécurité, mais fonctionnent différemment. La vérification en deux étapes (2FA) ajoute un second facteur après la saisie de ton mot de passe – en général un code fourni par une application d’authentification. Les passkeys remplacent entièrement ton mot de passe et offrent une sécurité multifacteur en une seule étape, en combinant quelque chose que tu possèdes (ton appareil) avec quelque chose que tu es (biométrie) ou que tu connais (code PIN de l’appareil). Les passkeys sont considérées comme plus sûres, car elles résistent au phishing (elles ne fonctionnent que sur le site web authentique), ne sont pas exposées aux fuites de bases de mots de passe et ne peuvent être ni devinées ni cassées. Si tu as activé à la fois les passkeys et la 2FA, une connexion par passkey ignore l’étape 2FA, car la passkey offre déjà une sécurité équivalente ou supérieure.

Question 27

Que se passe-t-il si je perds l'appareil avec ma passkey ?

Accepted Answer

Si tu perds un appareil qui contient ta passkey, pas d’inquiétude : ton compte reste sécurisé et accessible. Tu peux toujours te connecter avec ton mot de passe (et la 2FA si elle est activée). Si tes passkeys sont synchronisées via iCloud Keychain ou Google Password Manager, elles sont automatiquement disponibles sur tes autres appareils connectés au même compte. Pour une sécurité optimale, nous te recommandons de configurer des passkeys sur plusieurs appareils, de conserver ton mot de passe comme solution de secours et d’activer la 2FA comme couche de sécurité supplémentaire. Tu peux aussi gérer tes passkeys dans les paramètres de ton compte pour supprimer la passkey d’un appareil perdu et empêcher tout accès non autorisé.

Question 28

Quelle est la différence entre un compte payant et un compte gratuit ?

Accepted Answer

Les deux types de compte offrent les mêmes fonctionnalités. Tous les endpoints de l’API sont disponibles pour les deux types de compte et renvoient les mêmes résultats. 
        Les comptes gratuits sont limités à un certain nombre de requêtes par mois. Lorsque tu t'inscris, tu disposes immédiatement de 100 de crédits gratuits. Le premier jour de chaque mois, notre système réinitialisera ce nombre, 
        et les crédits gratuits seront à nouveau disponibles. Merci de ne créer qu'un seul compte. Si tu as besoin de plus de crédits, tu peux passer à l'un de nos plans payants à tout moment ici.

Question 29

Comment puis-je me déconnecter de tous les appareils ?

Accepted Answer

Si tu cliques sur le bouton de déconnexion dans ton compte, tu es déconnecté uniquement de l’appareil que tu utilises. Pour garantir la sécurité de ton compte et de tes données, il est important de te déconnecter de tous les appareils quand c’est nécessaire. Suis les instructions ci-dessous pour te déconnecter de tous les appareils sur notre plateforme API. Une fois connecté, clique ici pour te déconnecter partout. De plus, si tu changes ton mot de passe ou modifies tes paramètres d’authentification à deux facteurs, le système te déconnecte automatiquement de tous les appareils qui ne correspondent pas à ton adresse IP actuelle. Cela ajoute une couche de sécurité supplémentaire à ton compte. Nous recommandons de créer des comptes séparés pour chaque membre de l’équipe, pour renforcer la sécurité et faciliter le travail en commun. Enfin, pour renforcer encore la sécurité de ton compte, nous te conseillons vivement d’activer l’authentification à deux facteurs (2FA) : cette protection supplémentaire ajoute une étape au processus de connexion et rend l’accès beaucoup plus difficile pour des personnes non autorisées.

Question 30

Quelle est la différence entre un abonnement et un paiement unique ?

Accepted Answer

Si tu veux acheter l’un de nos forfaits, tu peux choisir entre un paiement unique et un abonnement à ce forfait. L’abonnement est recommandé si tu utilises notre service régulièrement : tu es sûr qu’il reste toujours assez de requêtes sur ton compte. Les requêtes achetées avec un abonnement sont utilisables pendant un mois. Avec un abonnement actif, notre système recharge ton compte au bout d’un mois au nombre de requêtes choisi. Par exemple, si tu es abonné à notre forfait de 25 000 requêtes et que tu en as utilisé 21 500, notre système ramène ton compte à 25 000 requêtes au bout d’un mois.
Les forfaits ponctuels s’achètent pour un besoin unique et sont utilisables pendant un an. Par exemple, si tu veux traiter un fichier Excel ou CSV, nous recommandons l’achat ponctuel. Les achats ponctuels ne se renouvellent pas : c’est à toi de veiller à ne pas tomber à zéro. Tu peux passer d’un type de forfait à l’autre sur notre page d’achat.

[difference]
Ne mélange pas les deux types d’achat sans en avoir parlé d’abord à notre support ou sans savoir exactement ce que tu fais. Acheter un forfait ponctuel alors que tu es abonné à l’un de nos forfaits peut empêcher l’abonnement de recharger tes requêtes — par exemple lorsqu’il reste plus de requêtes de l’achat ponctuel que ce que l’abonnement rechargerait.

Question 31

J'ai besoin d'un certificat de résidence. Pouvez-vous émettre ce certificat ?

Accepted Answer

Si tu as besoin d’un certificat de résidence de notre société, contacte notre support en indiquant ta demande. Le certificat doit être demandé individuellement pour chaque société. Indique dans ta demande l’adresse complète de ta société, ton pays de résidence et, si tu en as un, ton numéro fiscal. Le certificat de résidence doit être signé par notre administration fiscale. Il faut compter en général 2 à 3 semaines pour recevoir le formulaire signé, que nous pouvons ensuite fournir sous forme de scan numérique.

[certificate-of-residence]

Question 32

Comment puis-je acheter un package / plus de requêtes ?

Accepted Answer

Tu peux choisir entre un abonnement et un paiement unique ici.
Le paiement unique est recommandé si tu veux traiter un gros fichier CSV ou si tu préfères utiliser tes requêtes de manière irrégulière. Tu peux créditer ton compte du nombre de requêtes voulu à tout moment. Les requêtes achetées avec un paiement unique sont utilisables pendant un an.
Si tu préfères souscrire un abonnement, ton compte est rechargé chaque mois au nombre de requêtes choisi.
Les abonnements peuvent être modifiés ou résiliés à tout moment.

Question 33

Comment puis-je annuler mon abonnement ?

Accepted Answer

Tu peux modifier ou annuler ton abonnement à tout moment ici. Si tu veux arrêter tes paiements récurrents, clique sur le bouton "Annuler cet abonnement".

Question 34

Quel est le temps de réponse typique de l’API ?

Accepted Answer

Notre API est conçue pour offrir de hautes performances et répond généralement en 10 à 200 millisecondes.  
Les temps de réponse peuvent légèrement varier en fonction de ta localisation géographique, des conditions réseau et de la complexité de ta requête.  
Pour les requêtes groupées avec plusieurs prénoms, le temps de réponse augmente de manière linéaire. Nous utilisons un CDN mondial et une infrastructure optimisée pour garantir une faible latence dans le monde entier. Si tu constates des temps de réponse constamment lents, contacte notre équipe d’assistance.

Question 35

Y a‑t‑il des limites de débit ou des restrictions de requêtes ?

Accepted Answer

Nous appliquons des limites de débit équitables afin de garantir un service optimal pour tous les utilisateurs.  
Les comptes gratuits peuvent effectuer jusqu’à 100 requêtes par mois. Les comptes payants bénéficient de limites plus élevées :  
1500 requêtes par minute et aucune restriction quotidienne tant que tu disposes de crédits disponibles.  
Si tu as besoin de limites de débit plus élevées pour ton cas d’utilisation spécifique, merci de nous contacter afin de discuter d’une offre personnalisée.  
Les requêtes par lot (jusqu’à 100 prénoms par requête) comptent comme des requêtes individuelles mais sont plus efficaces.

Question 36

Quelle est la garantie de disponibilité de ton API ?

Accepted Answer

Nous garantissons une disponibilité de l’API de 99,9% sur tous les abonnements payants. Notre infrastructure est hébergée sur des serveurs de niveau entreprise avec basculement automatique et répartition de charge. Nous surveillons en continu nos systèmes 24h/24 et 7j/7 et disposons d’alertes automatiques pour tout problème.  

Nous fournissons également un accord de niveau de service (SLA) pour les clients entreprise. Dans le cas rare d’une panne prolongée, les clients payants reçoivent automatiquement des crédits de service basés sur les conditions de notre SLA.

Question 37

Quel format la réponse de l’API utilise-t-elle ?

Accepted Answer

Notre API renvoie par défaut des réponses au format JSON, qui est largement pris en charge par tous les langages de programmation modernes. Chaque réponse inclut le prénom demandé, le genre détecté, la valeur de précision/probabilité, ainsi que des métadonnées supplémentaires. Par exemple : {"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"}. Tu peux trouver des schémas de réponse détaillés dans notre documentation de l’API et télécharger notre spécification OpenAPI pour la génération automatique de clients.

Question 38

Comment dois‑je gérer les erreurs de l’API ?

Accepted Answer

Notre API utilise les codes d’état HTTP standard pour indiquer le succès ou l’échec.  
200 signifie succès, 401 indique une clé API invalide, 429 signifie que la limite de requêtes est dépassée et 500 indique une erreur du serveur.  
Chaque réponse d’erreur inclut un message descriptif et un code d’erreur pour faciliter le débogage.  
Nous te recommandons de mettre en place un backoff exponentiel pour les erreurs de limite de requêtes et de mettre en cache les réponses réussies lorsque c’est possible.  
En cas d’erreurs persistantes, consulte notre API documentation ou contacte le support.  
Toutes les erreurs sont journalisées à des fins de diagnostic.

Question 39

Comment gérez-vous la gestion des versions de l’API ?

Accepted Answer

Nous maintenons actuellement deux versions de l’API : V1 et V2. V2 est notre dernière version avec des fonctionnalités améliorées, notamment des valeurs de probabilité, une prise en charge étendue des pays et une précision accrue. V1 reste disponible pour assurer la rétrocompatibilité, mais nous te recommandons de migrer vers V2 pour les nouvelles intégrations. Tous les endpoints de l’API incluent la version dans le chemin de l’URL (par exemple, /v2/name). Nous garantissons que les anciennes versions de l’API continuent de fonctionner. Des guides de migration sont disponibles dans notre documentation de l’API. Les changements majeurs sont toujours communiqués bien à l’avance.

Question 40

Comment gérez-vous les variantes de prénoms et les surnoms ?

Accepted Answer

Notre base de données inclut les variantes courantes de prénoms, les diminutifs et les surnoms. Par exemple,  
« Bob » est reconnu comme une variante de « Robert », et « Liz » comme une variante de « Elizabeth ». Cependant, nous te recommandons de rechercher le prénom complet lorsqu’il est disponible, afin d’obtenir la meilleure précision possible.  

Nos systèmes d’IA apprennent en continu de nouvelles variantes de prénoms à partir de notre jeu de données. Si tu rencontres un surnom qui n’est pas reconnu, merci de let us know et nous l’ajouterons à notre base de données.  

Les variantes régionales (comme « Juan » et « John ») sont gérées via nos jeux de données spécifiques à chaque pays.

Question 41

L'API prend-elle en charge les prénoms avec des caractères spéciaux et des accents ?

Accepted Answer

Oui ! Notre API prend entièrement en charge les caractères Unicode, y compris les lettres accentuées (é, ñ, ü),  
les trémas, les signes diacritiques et les écritures non latines (arabe, cyrillique, chinois, etc.). Les prénoms doivent être encodés en UTF-8 dans tes requêtes API. Par exemple, « François », « José », « Müller » et « Søren » sont tous traités correctement.  
L’encodage d’URL est géré automatiquement par la plupart des clients HTTP, mais assure-toi d’un encodage correct pour les caractères spéciaux.  
Notre base de données contient des prénoms provenant de 191 pays couvrant tous les principaux systèmes d’écriture. Plus de détails dans notre documentation de l’API.

Question 42

Quelles sources de données utilises-tu ?

Accepted Answer

Nous combinons plusieurs sources de données faisant autorité afin de garantir une précision maximale. Celles‑ci incluent :  
        des données de recensement gouvernementales et des registres de naissance provenant de nombreux pays, des bases de données de prénoms disponibles publiquement,  
        les réseaux sociaux et professionnels (anonymisés et conformes au RGPD), des archives historiques de prénoms,  
        ainsi que des vérifications manuelles effectuées par notre équipe de données. Toutes les sources sont soigneusement évaluées et recoupées.  
        Nous privilégions les sources officielles gouvernementales lorsqu’elles sont disponibles. Nos modèles d’IA aident également à identifier des schémas  
        et à vérifier la cohérence entre les différentes sources. Une liste complète des pays pris en charge est disponible ici.  
        Nous mettons régulièrement à jour notre base de données dès que de nouvelles données officielles sont disponibles.

Question 43

Comment garantis-tu la confidentialité et la protection des données ?

Accepted Answer

Nous prenons la protection des données très au sérieux et nous respectons le RGPD, la CCPA et les autres réglementations internationales de protection des données. Nous ne conservons pas les prénoms que tu interroges au-delà de la journalisation nécessaire au fonctionnement du service. Toutes les communications avec l’API sont chiffrées via HTTPS/TLS. Nous proposons des Data Processing Agreements pour les clients entreprise. Les fichiers CSV/Excel que tu importes sont automatiquement supprimés au bout d’un an. Nous ne vendons ni ne partageons jamais les données de nos clients avec des tiers. Nos serveurs sont hébergés dans des centres de données européens sécurisés. Tu peux lire notre politique de confidentialité complète pour tous les détails. Des audits de sécurité réguliers garantissent une conformité continue.

Question 44

Puis-je obtenir des factures et des reçus pour mes paiements ?

Accepted Answer

Oui, des factures sont générées automatiquement pour tous les achats et sont disponibles dans ton tableau de bord. Tu peux télécharger les factures au format PDF à tout moment, et elles sont aussi envoyées à ton adresse e-mail enregistrée.
Les factures contiennent tous les détails nécessaires à la comptabilité, y compris les informations de TVA le cas échéant.
Tu peux mettre à jour tes informations de facturation et les données de ton entreprise à tout moment pour que les factures reflètent les bonnes informations.
Pour d’anciennes factures ou des besoins de facturation particuliers, merci de contacter le support.

Question 45

Quelle est votre politique de remboursement ?

Accepted Answer

Nous offrons une garantie simple de remboursement de 14 jours pour les premiers achats.  
Si notre service ne répond pas à tes attentes pendant les 14 premiers jours, contacte-nous pour un remboursement complet – sans aucune question.  
Pour les abonnements, tu peux les annuler à tout moment afin d’arrêter les futurs prélèvements. Les crédits inutilisés issus d’achats uniques restent valables pendant un an. Nous accordons également des remboursements en cas de problèmes techniques ou de dysfonctionnement du service, au cas par cas.  
Merci de consulter notre politique d’annulation complète pour plus de détails ou de contacter le support pour toute question.

Question 46

Quelles intégrations tierces sont disponibles ?

Accepted Answer

Nous proposons des intégrations avec des plateformes et des outils populaires, notamment Zapier, Make (anciennement Integromat), Google Sheets, Microsoft Excel, Salesforce, HubSpot et de nombreux systèmes CRM. Notre API fonctionne avec toute plateforme qui prend en charge les API REST ou les webhooks. Nous fournissons des connecteurs prêts à l’emploi et des guides d’intégration détaillés pour les principales plateformes. Tu peux aussi utiliser notre fonction de téléversement CSV pour un traitement ponctuel des données, sans aucune intégration. Pour des intégrations personnalisées ou la prise en charge d’une plateforme spécifique, consulte notre documentation ou contacte le support.

QUESTIONS FRÉQUEMMENT POSÉES

Que se passe-t-il si un prénom peut être à la fois masculin et féminin ?