Authentification

Toutes les requêtes API vers GenderAPI nécessitent une authentification. Vous pouvez authentifier vos requêtes de deux manières :

  1. API Key dans le corps du POST en tant que paramètre key
  2. API Key dans l’en-tête Authorization en utilisant un Bearer token

1. API Key dans le corps du POST

La méthode la plus simple pour s’authentifier est d’inclure votre clé API sous forme de champ nommé key dans le corps JSON de votre requête POST.

Par exemple, pour déterminer le genre du prénom « Alice » :


Exemple avec cURL

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -d '{"name": "Alice", "key": "YOUR_API_KEY"}'

Exemple avec JavaScript fetch

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Alice",
    key: "YOUR_API_KEY"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Exemple avec Python requests

import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice",
    "key": "YOUR_API_KEY"
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

2. API Key dans l’en-tête Authorization (Bearer Token)

Pour plus de sécurité et des requêtes plus propres, vous pouvez envoyer votre clé API dans l’en-tête Authorization en utilisant le schéma Bearer. Avec cette méthode, vous ne devez pas inclure la clé API dans le corps JSON.

À la place, seul vos paramètres d’entrée (comme name) figurent dans le corps du POST.

Par exemple, pour déterminer le genre du prénom « Alice » :


Exemple avec cURL

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"name": "Alice"}'

Exemple avec JavaScript fetch

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "Alice"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Exemple avec Python requests

import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Choisir entre les deux méthodes

Les deux méthodes d’authentification sont prises en charge sur tous les endpoints de l’API. Cependant, utiliser l’en-tête Authorization est plus sécurisé car cela permet de garder votre clé API hors du corps de la requête et évite qu’elle soit enregistrée accidentellement dans des logs.

Quelle que soit la méthode choisie, assurez-vous toujours de définir l’en-tête Content-Type sur application/json lorsque vous envoyez des requêtes POST.