GenderAPI-authenticatie met API-sleutel en Bearer-token

Authenticatieoverzicht

Kies hoe u de API-sleutel verstuurt

Iedere geauthenticeerde aanvraag vereist een geldige GenderAPI-sleutel. De Authorization-header is standaard aanbevolen, omdat referenties gescheiden blijven van de aanvraaggegevens.

Bearer-token

Verstuur de sleutel in de Authorization-header.

JSON-body

Verstuur de sleutel als server-side POST-veld.

Aanbevolen

Authorization-header

Bearer-token

Stel Authorization: Bearer YOUR_API_KEY in en verstuur uitsluitend de invoerparameters in de JSON-body.

AuthorizationBearer YOUR_API_KEY

cURL

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

JavaScript

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({ name: "Sophie" })
});

Alternatief

API-sleutel in de JSON-body

POST-body

Voeg de sleutel als eigenschap key toe naast de aanvraaggegevens. Gebruik deze methode uitsluitend vanuit vertrouwde server-side code.

cURL

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

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api",
  json={
    "name": "Sophie",
    "key": "YOUR_API_KEY"
  }
)
print(response.json())

Bescherming van referenties

Bescherm uw API-sleutel

Bewaar sleutels in server-side omgevingsvariabelen of een secrets manager.
Commit een sleutel nooit naar versiebeheer en toon deze niet in JavaScript in de browser.
Verwijder referenties uit logs van applicaties, proxy's en analytics.
Gebruik HTTPS voor iedere aanvraag en vervang een sleutel die mogelijk is gelekt.

Snelle vergelijking

Welke methode moet u gebruiken?

Methode	Geschikt voor	Locatie van referentie
Bearer-tokenAanbevolen	De meeste serverintegraties	`Authorization`-header
JSON-body	Bestaande POST-integraties	Eigenschap `key`

POST-contenttype: stel Content-Type: application/json in wanneer u een JSON-body verstuurt.

Volgende handleiding

Verstuur een aanvraag voor één naam

Gender uit een naamParameters en respons van een enkele aanvraag →ClientbibliothekenTerug naar de officiële SDK's →