Autentizace GenderAPI – API klíč a Bearer token

Přehled autentizace

Zvolte způsob odeslání API klíče

Všechny autentizované požadavky vyžadují platný klíč GenderAPI. Doporučenou výchozí metodou je hlavička Authorization, protože odděluje přihlašovací údaj od dat požadavku.

Bearer token

Odešlete klíč v hlavičce Authorization.

Tělo JSON

Odešlete klíč jako pole serverového POST požadavku.

Doporučeno

Hlavička Authorization

Bearer token

Nastavte Authorization: Bearer YOUR_API_KEY a v těle JSON odesílejte pouze vstupní parametry.

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":"Tereza"}'

JavaScript

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

Alternativa

API klíč v těle JSON

POST body

Klíč vložte jako vlastnost key vedle dat požadavku. Tuto metodu používejte pouze v důvěryhodném serverovém kódu.

cURL

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

Python

import requests

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

Bezpečnost přihlašovacích údajů

Chraňte svůj API klíč

Klíče ukládejte do serverových proměnných prostředí nebo správce tajných údajů.
Nikdy klíč neukládejte do správy verzí ani jej nezveřejňujte v JavaScriptu prohlížeče.
Odstraňte přihlašovací údaje z aplikačních, proxy a analytických protokolů.
Pro každý požadavek používejte HTTPS a klíč vyměňte, pokud mohl uniknout.

Rychlé porovnání

Kterou metodu zvolit?

Metoda	Nejvhodnější pro	Umístění přihlašovacího údaje
Bearer tokenDoporučeno	Většinu serverových integrací	Hlavička `Authorization`
Tělo JSON	Stávající integrace POST	Vlastnost `key`

Typ obsahu POST: Při odesílání těla JSON nastavte Content-Type: application/json.

Další průvodce

Odešlete požadavek s jedním jménem

Pohlaví podle jménaParametry a odpověď jednotlivého požadavku →Klientské knihovnyZpět k oficiálním SDK →