Zarządzanie kluczami API

Strona API Keys umożliwia tworzenie, przeglądanie i zarządzanie kluczami, których aplikacje używają do wywoływania FourA API.

Przeglądanie kluczy

Strona wyświetla każdy klucz, do którego masz dostęp: Twoje klucze osobiste oraz wszystkie klucze należące do organizacji, do których należysz. Dostęp wynika z członkostwa, więc zwykły członek widzi również klucze organizacji.

Kolumna Co zawiera
Name Nazwa wyświetlana oraz opis, jeśli został ustawiony
Owner Personal lub nazwa organizacji
Key Prefix Pierwsze znaki klucza, a następnie maska (pk_live_a1b2••••••••), z przyciskiem Reveal lub ikoną kłódki przy starszych kluczach
Status Active lub Inactive
Created Data utworzenia klucza
Last Used Kiedy klucz wykonał ostatni request

Wyszukuj według nazwy lub opisu, filtruj według Active lub Inactive i sortuj według Name, Owner, Status, Created lub Last Used. Kierunek sortowania przełącza się kolejno: malejąco, rosnąco, a następnie zostaje wyłączony.

Filtr Owner

Jeśli należysz do co najmniej jednej organizacji, obok pola wyszukiwania pojawia się lista rozwijana Owner: Everything, Personal lub po jednej pozycji dla każdej organizacji. Zawęża ona listę do kluczy danego właściciela, a ten sam wybór jest zachowywany na stronach Overview, Metrics, Activity oraz Proxy, dzięki czemu wszystkie pięć stron zawsze spójnie pokazuje ruch danego podmiotu.

Tworzenie klucza

Kliknij Create Key nad listą (Create API key na pustej stronie przed utworzeniem pierwszego klucza) i wypełnij pola:

Pole Wymagane Opis
Name Tak Etykieta opisowa, na przykład "production-scraper" lub "staging-test"
Description Nie Notatki dotyczące przeznaczenia tego klucza
Owner Tak, jeśli należysz do organizacji Personal lub dowolna organizacja, do której należysz. Wybór pojawia się tylko wtedy, gdy masz przynajmniej jedną.

Każdy członek organizacji może utworzyć należący do niej klucz, niezależnie od posiadanej roli. Taki jest cel tego ustawienia: użycie klucza organizacji obciąża konto jej właściciela, dzięki czemu programista nie musi korzystać z klucza osobistego, który generowałby koszty po jego stronie zamiast firmy.

Pełny klucz jest pokazywany tylko raz zaraz po utworzeniu w oknie dialogowym gotowym do skopiowania. Możesz go później wyświetlić ponownie za pomocą opcji Reveal. Klucze używają prefiksu pk_live_ i mają postać pk_live_a1b2c3d4e5f6.... Otrzymasz wiadomość e-mail potwierdzającą utworzenie klucza.

Twój plan określa, ile aktywnych kluczy możesz posiadać: sumę Twoich kluczy osobistych oraz kluczy organizacji, których jesteś właścicielem. Klucz utworzony dla organizacji wlicza się do limitu planu jej właściciela. Po osiągnięciu limitu próba utworzenia klucza zostanie odrzucona z komunikatem podającym limit Twojego planu, dlatego wyłącz lub usuń nieużywany klucz albo przejdź na wyższy plan.

Odkrywanie klucza

Kliknij ikonę oka obok zamaskowanego prefiksu klucza, aby ponownie zobaczyć jego pełną wartość. Panel poprosi o potwierdzenie, a następnie otworzy okno dialogowe z jawnym kluczem, przyciskiem kopiowania i krótkim odliczaniem. Po zakończeniu odliczania okno dialogowe usuwa klucz ze strony.

Każde odkrycie klucza jest rejestrowane w dzienniku audytu (audit log), ponieważ ujawnia aktywne dane uwierzytelniające.

Każdy, komu udostępniono klucz, może go podejrzeć: jego właściciel osobisty lub dowolny członek organizacji będącej jego właścicielem.

Starsze klucze

Klucze utworzone przed wdrożeniem funkcji podglądu wyświetlają ikonę kłódki zamiast oka i nie można ich podejrzeć. Zapisano wyłącznie ich hash, więc pierwotna wartość secret jest nie do odzyskania. Aby zaktualizować starszy klucz, otwórz menu akcji i wybierz Regenerate. Nowy secret będzie od tej pory możliwy do podejrzenia.

Uprawnienia ról

W przypadku klucza osobistego możesz zrobić wszystko. W przypadku klucza organizacji obowiązują trzy poziomy uprawnień:

Akcja Member Admin Owner
Używanie klucza i jego podgląd Tak Tak Tak
Zmiana nazwy, edycja opisu Tak Tak Tak
Włączenie lub wyłączenie Nie Tak Tak
Ponowne wygenerowanie wartości secret Nie Tak Tak
Usunięcie Nie Tak Tak
Przeniesienie poza organizację Nie Nie Tak

Opcje Disable i Edit pozostają w wierszu, lecz są wyszarzone z notatką wyjaśniającą przyczynę. Opcje Regenerate, Transfer i Delete nie pojawiają się w menu, jeśli Twoja rola nie pozwala na ich użycie. API odrzuca te same akcje, więc integracja nie może obejść interfejsu.

Podział zależy od skutków danej akcji dla osób współdzielących klucz. Zmiana nazwy jest nieszkodliwa. Ponowne wygenerowanie lub wyłączenie natychmiast zatrzymuje integracje wszystkich współpracowników. Przeniesienie klucza poza organizację odbiera go firmie i przypisuje jego zużycie do planu przejmującego, dlatego ta operacja przysługuje wyłącznie roli owner.

Edycja klucza

Kliknij Edit, aby zaktualizować nazwę i opis. W tym oknie dialogowym nie można zmienić właściciela: użyj opcji Transfer.

Opcja View Metrics w menu akcji otwiera widok Overview przefiltrowany dla tego klucza.

Aktywacja i dezaktywacja

Użyj opcji Disable lub Enable w wierszu. Dezaktywacja klucza blokuje każde żądanie API, które z niego korzysta, a ponowna aktywacja jest możliwa w dowolnym momencie. Zmiana zaczyna obowiązywać w ciągu minuty.

Ponowne generowanie klucza

Jeśli podejrzewasz, że klucz został ujawniony, otwórz menu akcji i wybierz Regenerate. Spowoduje to utworzenie nowej wartości secret dla tego samego ID klucza. Stary secret przestanie działać w ciągu minuty. Nazwa, właściciel i wszystkie pozostałe ustawienia pozostają bez zmian.

Nowy secret pozostaje dostępny do podejrzenia po zamknięciu okna dialogowego, więc nie musisz kopiować go bezbłędnie za pierwszym razem.

Przenoszenie klucza

Opcja Transfer w menu akcji przenosi klucz między kontem osobistym a organizacją bez ponownego generowania wartości secret. ID klucza, jego metryki oraz historia aktywności zostają zachowane. Zmienia się tylko właściciel, a wraz z nim podmiot, do którego jest przypisywane rozliczenie zużycia.

Przeniesienie Kto może to zrobić
Klucz osobisty do organizacji Każdy, kto należy do tej organizacji
Klucz organizacji na własne konto Właściciel (owner) organizacji
Między dwiema organizacjami Właściciel (owner) organizacji opuszczanej przez klucz

Klucz przeniesiony do organizacji trafia do jej domyślnego zespołu "Everyone", dzięki czemu staje się widoczny dla członków. Klucz przeniesiony poza organizację opuszcza każdy zespół, do którego należał.

Usuwanie klucza

Otwórz menu działań i wybierz Usuń. Usunięcie klucza, który był wcześniej używany, powoduje jego dezaktywację: klucz przestaje uwierzytelniać i pozostaje na liście jako Nieaktywny, dzięki czemu historia jego aktywności i metryk zachowuje przypisaną nazwę. Klucze, które nigdy nie były użyte, są trwale usuwane.

Po usunięciu klucza otrzymasz wiadomość e-mail.

Klucze organizacji i rozliczenia

Użycie klucza należącego do organizacji wlicza się do limitów planu właściciela organizacji, niezależnie od tego, kto wysłał żądanie. Strona Użycie i limity właściciela zlicza te klucze obok jego kluczy osobistych i rozdziela obie te kategorie.

Aktualizacja: 5 listopada 2026