Envoyez votre première requête
Utilisez GenderAPI.io V2 pour estimer le genre à partir d'un prénom, d'un nom complet, d'une adresse e-mail ou d'un nom d'utilisateur. L'origine de l'API est https://api.genderapi.io et le chemin de base de la V2 est /api/v2. Essayez l'exemple GET ci-dessous dans votre navigateur, puis choisissez un guide pour connecter votre application.
L'essai gratuit comprend 10 crédits par adresse IP toutes les 24 heures, partagés avec la V1. Cet exemple, limité au jeu de données, consomme 1 crédit à chaque requête, y compris à chaque actualisation de la page. Lorsque vous utilisez votre clé API existante, la V1 et la V2 débitent le même solde de compte.
https://api.genderapi.io/api/v2/gender?type=name&value=Léa&country=FR&ai_mode=offQue souhaitez-vous faire ?
Choisissez votre type d'entrée pour obtenir des exemples fonctionnels en cURL, JavaScript, Python, PHP, Java, C# et Go. Consultez les guides sur les résultats et la facturation lorsque vous êtes prêt à traiter des réponses réelles.
Premiers pas
Envoyer des requêtes
- Genre à partir d'un nom Recherchez un prénom ou un nom complet.
- Genre à partir d'une adresse e-mail Repérez un indice de nom dans une adresse e-mail.
- Genre à partir d'un nom d'utilisateur Utilisez un nom d'utilisateur ou un surnom comme entrée.
- Requêtes par lots Traitez jusqu'à 50 éléments avec une clé API, ou 10 avec l'essai par IP.
- Validation de numéros de téléphone Vérifiez et formatez un numéro de téléphone.
Résultats et coûts
- Lire une réponse Lisez les prédictions, les scores de confiance et les résultats inconnus.
- IA et surnoms Choisissez quand utiliser l'IA et comment gérer les surnoms.
- Crédits et solde Consultez votre solde et le coût de chaque requête.
- Erreurs et nouvelles tentatives Résolvez les erreurs et décidez quand réessayer.
Référence des points de terminaison
Combinez https://api.genderapi.io avec les chemins absolus de ce tableau, par exemple https://api.genderapi.io/api/v2/gender. Les paramètres de requête ne sont pris en charge que sur GET /gender. Utilisez des corps JSON pour les routes POST ; n'envoyez pas de champs V1 tels que name, email, username ou askToAI dans une requête V2.
| Méthode | Chemin | Rôle |
|---|---|---|
| GET | /api/v2 | Capacités publiques et limites actuelles ; gratuit. |
| GET | /api/v2/openapi.json | Contrat canonique OpenAPI ; gratuit. |
| GET | /api/v2/errors | Catalogue d'erreurs lisible par machine ; gratuit. |
| GET | /api/v2/usage | Solde actuel du compte ou de l'essai par IP ; gratuit. |
| GET / POST | /api/v2/gender | Un nom, une adresse e-mail ou un nom d'utilisateur. |
| POST | /api/v2/gender/batch | Un lot ordonné de noms, d'adresses e-mail et/ou de noms d'utilisateur. |
| POST | /api/v2/phone/validate | Valider et formater un numéro de téléphone. |