Oversigt over godkendelse
Vælg, hvordan din API-nøgle skal sendes
Alle godkendte forespørgsler kræver en gyldig GenderAPI-nøgle. Authorization-headeren er den anbefalede standard, fordi den holder adgangsoplysninger adskilt fra forespørgslens data.
Anbefalet
Authorization-header
Angiv Authorization: Bearer YOUR_API_KEY, og send kun inputparametrene i JSON-bodyen.
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-nøgle i JSON-bodyen
Medtag nøglen som egenskaben key sammen med forespørgslens data. Brug kun denne metode fra betroet kode på serversiden.
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())Sikkerhed for adgangsoplysninger
Beskyt din API-nøgle
- Gem nøgler i miljøvariabler på serversiden eller i en secrets manager.
- Commit aldrig en nøgle til versionsstyring, og eksponér den ikke i browser-JavaScript.
- Fjern adgangsoplysninger fra applikations-, proxy- og analyselogs.
- Brug HTTPS til alle forespørgsler, og udskift nøglen, hvis den kan være lækket.
Hurtig sammenligning
Hvilken metode skal du bruge?
| Metode | Bedst til | Placering af adgangsoplysninger |
|---|---|---|
| Bearer-tokenAnbefalet | De fleste serverintegrationer | Authorization-header |
| JSON-body | Eksisterende POST-integrationer | Egenskaben key |
Indholdstype til POST: Angiv
Content-Type: application/json, når du sender en JSON-body.Næste vejledning