Oversikt over autentisering
Velg hvordan API-nøkkelen skal sendes
Alle autentiserte forespørsler krever en gyldig GenderAPI-nøkkel. Authorization-headeren anbefales som standard fordi den skiller tilgangsopplysninger fra forespørselsdataene.
Anbefalt
Authorization-header
Angi Authorization: Bearer YOUR_API_KEY, og send bare inndataparameterne 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økkel i JSON-bodyen
Legg til nøkkelen som egenskapen key sammen med forespørselsdataene. Bruk bare denne metoden fra betrodd kode på serveren.
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())Sikkerhet for tilgangsopplysninger
Beskytt API-nøkkelen din
- Lagre nøkler i miljøvariabler på serveren eller i en tjeneste for hemmeligheter.
- Aldri legg en nøkkel i versjonskontroll eller eksponer den i JavaScript i nettleseren.
- Fjern tilgangsopplysninger fra applikasjons-, proxy- og analyselogger.
- Bruk HTTPS for alle forespørsler, og erstatt nøkkelen hvis den kan ha blitt lekket.
Rask sammenligning
Hvilken metode bør du bruke?
| Metode | Passer best for | Plassering av tilgangsopplysninger |
|---|---|---|
| Bearer-tokenAnbefalt | De fleste serverintegrasjoner | Authorization header |
| JSON-body | Eksisterende POST-integrasjoner | key-egenskap |
Innholdstype for POST: Angi
Content-Type: application/json når du sender en JSON-body.Neste veiledning