Autentifikacija

Saznajte kako autentificirati svoje API zahtjeve koristeći API ključeve.

Pregled #

FireCustos API koristi autentifikaciju putem API ključeva. Svaki zahtjev mora sadržavati važeći API ključ u Authorization zaglavlju.

Kreiranje API ključeva #

API ključevi se kreiraju u FireCustos administratorskom panelu:

1. Prijavite se u FireCustos kao Admin ili Zapovjednik
2. Idite na Postavke → API ključevi
3. Kliknite "Kreiraj API ključ" i dajte mu opisni naziv
4. Odmah kopirajte ključ — prikazuje se samo jednom

Korištenje API ključeva #

Uključite API ključ u Authorization zaglavlje kao Bearer token:

curl -X GET https://app.firecustos.com/api/v1/firefighters \
  -H "Authorization: Bearer fc_your_api_key_here"

Sigurnost #

API ključevi su osjetljivi podaci. Pridržavajte se ovih najboljih praksi:

• Nikada ne dijelite API ključeve u javnim repozitorijima ili klijentskom kodu
• Koristite varijable okruženja za pohranu ključeva
• Periodično rotirajte ključeve — opozovite stare i kreirajte nove
• Svaki ključ se SHA-256 hashira prije pohrane — FireCustos nikada ne pohranjuje vaš ključ u čistom tekstu
• Postavite datum isteka na ključeve kad je moguće

Greške autentifikacije #

Kada autentifikacija ne uspije, API vraća 401 Unauthorized odgovor:

API ključ nije naveden

{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Missing or invalid Authorization header."
}

API ključ je nevažeći

{
  "status": 401,
  "title": "Unauthorized",
  "detail": "Invalid API key."
}

API ključ je opozvan

{
  "status": 401,
  "title": "Unauthorized",
  "detail": "API key has been revoked."
}

API ključ je istekao

{
  "status": 401,
  "title": "Unauthorized",
  "detail": "API key has expired."
}