API ključ
API ključ je tajni niz znakova koji dokazuje da drugi sustav smije čitati vaše podatke. Funkcionira kao lozinka, osim što ga umjesto osobe koristi program, a vrijedi sve dok ga ne opozovete.
Dobro je znati: uređivač i račun u Gatherinu dostupni su na engleskom ili češkom. Obrasci koje ispunjavaju vaši korisnici mogu se prikazati na 18 jezika, uključujući hrvatski.
Ključ se stvara u postavkama i prikazuje se samo jednom. Odmah ga spremite u varijablu okruženja ili upravitelj tajnih podataka na svom poslužitelju. Kasnije ga ne možete pročitati jer je pohranjen u obliku iz kojeg se izvorna vrijednost ne može izvesti.
Najčešća greška je stavljanje ključa u JavaScript na stranici. Izvorni kod preglednika je javno dostupan: svatko može kopirati ključ i preuzeti svaki odgovor iz svakog vašeg obrasca. Zato API pozive treba izvršavati na poslužitelju koji čuva ključ i vraća samo ono što je namijenjeno javnosti.
Ako ključ procuri, nemojte istraživati je li ga netko iskoristio. Opozovite ga i izdajte novi. Opoziv je trenutačan, a stari ključ prestaje raditi.
U praksi
- Ključ treba biti u varijabli okruženja na poslužitelju, a ne u repozitoriju ni u kodu na strani preglednika.
- Preporučujemo zaseban ključ za svaku integraciju kako biste mogli opozvati samo onu jednu.
- Zamijenite ključ kada osoba koja ga je poznavala više ne radi s vama.
Česta pitanja
Gdje mogu izraditi API ključ?
U Postavke → API ključevi. Prikazuje se samo jednom.
Kako se ključ šalje?
U zaglavlju Authorization: Bearer <ključ> ili u zaglavlju x-api-key.
Što se događa kada opozovem ključ?
Prestaje raditi odmah, a integracije koje ga koriste dobivaju odgovor 401.
Povezano
Isprobajte Gatherino besplatno
Besplatni paket: 3 obrasca i 100 odgovora mjesečno. Bez kreditne kartice, podaci pohranjeni u EU.
Počnite besplatno →