Översikt över autentisering
Välj hur API-nyckeln ska skickas
Alla autentiserade förfrågningar kräver en giltig GenderAPI-nyckel. Authorization-headern rekommenderas som standard eftersom den skiljer autentiseringsuppgifterna från förfrågningsdatan.
Rekommenderas
Authorization-header
Ange Authorization: Bearer YOUR_API_KEY och skicka endast inmatningsparametrarna i JSON-body.
Authorization
Bearer YOUR_API_KEYcURL
curl -X POST "https://api.genderapi.io/api" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"name":"Alice"}'JavaScript
fetch("https://api.genderapi.io/api", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
body: JSON.stringify({ name: "Alice" })
});Alternativ
API-nyckel i JSON-body
Inkludera nyckeln som egenskapen key tillsammans med förfrågningsdatan. Använd metoden endast från betrodd kod på servern.
cURL
curl -X POST "https://api.genderapi.io/api" \
-H "Content-Type: application/json" \
-d '{"name":"Alice","key":"YOUR_API_KEY"}'Python
import requests
response = requests.post(
"https://api.genderapi.io/api",
json={
"name": "Alice",
"key": "YOUR_API_KEY"
}
)
print(response.json())Skydda autentiseringsuppgifterna
Skydda din API-nyckel
- Lagra nycklar i miljövariabler på servern eller i en hemlighetshanterare.
- Lägg aldrig in en nyckel i versionshantering och exponera den inte i JavaScript i webbläsaren.
- Ta bort autentiseringsuppgifter från applikations-, proxy- och analysloggar.
- Använd HTTPS för varje förfrågan och ersätt nyckeln om den kan ha läckt.
Snabb jämförelse
Vilken metod bör du använda?
| Metod | Passar bäst för | Nyckelns placering |
|---|---|---|
| Bearer-tokenRekommenderas | De flesta serverintegrationer | Authorization-header |
| JSON-body | Befintliga POST-integrationer | Egenskapen key |
Content type för POST: Ange
Content-Type: application/json när du skickar en JSON-body.Nästa guide