API-kulcs
Az API-kulcs egy titkos karakterlánc, amely igazolja, hogy egy másik rendszer olvashatja az Ön adatait. Egy jelszóhoz hasonlóan működik, azzal a különbséggel, hogy nem személy, hanem program adja meg, és addig érvényes, amíg vissza nem vonja.
Jó tudni: a Gatherino szerkesztője és fiókja angol vagy cseh nyelven érhető el. A kitöltők által látott űrlapok 18 nyelven jeleníthetők meg, ideértve a magyart is.
A kulcsot a beállításokban hozza létre, és csak egyszer jelenik meg. Azonnal mentse el egy környezeti változóban vagy a szerver titokkezelőjében, mert később nem tudja visszaolvasni: a rendszer olyan formában tárolja, amelyből az eredeti érték nem állítható vissza.
A leggyakoribb hiba, hogy a kulcsot az oldal JavaScriptjébe teszik. A böngészőben látható forráskód nyilvános, így bárki kimásolhatja a kulcsot, és letölthet bármely űrlapja minden válaszát. Az API-hívásoknak ezért olyan szerveren kell történniük, amely tárolja a kulcsot, és csak a nyilvános adatokat adja vissza.
Ha kiszivárgott a kulcs, ne vizsgálja, hogy valaki használta-e, hanem vonja vissza, és adjon ki újat. A visszavonás azonnali, a régi kulcs pedig nem működik tovább.
Gyakorlatban
- A kulcs egy szerveroldali környezeti változóba tartozik, nem a kódtárba és nem a frontendbe.
- Inkább integrációnként külön kulcsot használjon, hogy csak az egyiket kelljen visszavonnia.
- Cserélje le a kulcsot, amikor olyan személy távozik, aki ismerte.
GYIK
Hol hozhatok létre API-kulcsot?
A Beállítások → API-kulcsok menüpontban. Csak egyszer jelenik meg.
Hogyan küldik el a kulcsot?
Authorization: Bearer <key> fejlécben vagy x-api-key fejlécben.
Mi történik, ha visszavonok egy kulcsot?
Azonnal megszűnik a működése, a kulcsot használó integrációk pedig 401-es hibakódot kapnak.
Kapcsolódó
Próbálja ki a Gatherinót ingyen
Ingyenes csomag: havi 3 űrlap és 100 válasz. Bankkártya nem szükséges, az adatok EU-ban tárolódnak.
Kezdje el ingyen →