Cheie API
Cheia API este un șir secret care dovedește că un alt sistem are voie să citească datele dvs. Funcționează ca o parolă, cu deosebirea că este furnizată de un program, nu de o persoană, și rămâne valabilă până o revocați.
De reținut: editorul Gatherino și contul sunt disponibile în engleză sau cehă. Formularele completate de respondenți pot fi afișate în 18 limbi, inclusiv în română.
Cheia se creează în setări și este afișată o singură dată. Stocați-o imediat într-o variabilă de mediu sau într-un manager de secrete de pe server; nu o mai puteți citi ulterior, deoarece este salvată într-o formă din care valoarea originală nu poate fi reconstituită.
Cea mai frecventă greșeală este plasarea cheii în codul JavaScript al paginii. Codul sursă din browser este public — oricine poate copia cheia și descărca fiecare răspuns de la oricare dintre formularele dvs. Apelurile API trebuie, așadar, făcute pe un server care păstrează cheia și returnează doar ceea ce este destinat publicului.
Dacă o cheie se scurge, nu investigați dacă a fost folosită — revocați-o și emiteți una nouă. Revocarea este imediată, iar cheia veche încetează să mai funcționeze.
În practică
- Cheia trebuie stocată într-o variabilă de mediu de pe server, nu într-un depozit de cod și nu în interfața front-end.
- Preferați o cheie separată pentru fiecare integrare, ca să puteți revoca doar una.
- Schimbați cheia atunci când pleacă o persoană care o cunoștea.
Întrebări frecvente
Unde creez o cheie API?
În Setări → Chei API. Este afișată o singură dată.
Cum este trimisă cheia?
Într-un antet Authorization: Bearer <cheie> sau într-un antet x-api-key.
Ce se întâmplă când revoc o cheie?
Încetează să mai funcționeze imediat, iar integrările care o folosesc primesc un cod 401.
Similare
Încearcă Gatherino gratuit
Plan gratuit: 3 formulare și 100 de răspunsuri pe lună. Fără card de credit, date găzduite în UE.
Începe gratuit →