Klucz API
Klucz API to tajny ciąg znaków, który potwierdza, że inny system ma prawo odczytywać Twoje dane. Działa jak hasło — z tą różnicą, że podaje go program, a nie człowiek, i pozostaje ważny, dopóki go nie unieważnisz.
Warto wiedzieć: edytor Gatherino i konto są dostępne po angielsku lub czesku. Formularze wypełniane przez respondentów mogą być wyświetlane w 18 językach, w tym po polsku.
Klucz tworzy się w ustawieniach i wyświetla dokładnie raz. Zapisz go od razu w zmiennej środowiskowej lub w menedżerze sekretów na serwerze. Później nie da się go odczytać, ponieważ jest przechowywany w postaci, z której nie można odtworzyć pierwotnej wartości.
Najczęstszy błąd to umieszczanie klucza w kodzie JavaScript po stronie przeglądarki. Kod źródłowy strony jest publiczny — każdy może skopiować klucz i pobrać każdą odpowiedź z każdego z Twoich formularzy. Wywołania API powinny więc trafiać na serwer, który przechowuje klucz i zwraca wyłącznie dane przeznaczone do publicznego wglądu.
Jeśli klucz wycieknie, nie sprawdzaj, czy ktoś go użył. Unieważnij go i wygeneruj nowy. Unieważnienie działa natychmiast, a stary klucz przestaje obowiązywać.
W praktyce
- Klucz powinien znajdować się w zmiennej środowiskowej po stronie serwera, a nie w repozytorium ani na froncie.
- Stosuj osobny klucz dla każdej integracji, abyś mógł unieważnić tylko jedną z nich.
- Wymień klucz, gdy osoba, która go znała, opuści zespół.
FAQ
Gdzie utworzyć klucz API?
W sekcji Ustawienia → Klucze API. Jest wyświetlany tylko raz.
Jak przesyłany jest klucz?
W nagłówku Authorization: Bearer <klucz> lub w nagłówku x-api-key.
Co się stanie, gdy unieważnię klucz?
Przestaje działać natychmiast, a integracje, które go używają, otrzymują błąd 401.
Powiązane
Wypróbuj Gatherino za darmo
Plan darmowy: 3 formularze i 100 odpowiedzi miesięcznie. Bez karty kredytowej, dane hostowane w UE.
Zacznij za darmo →