# Zarządzanie kluczami API

> URL: https://foura.ai/pl/docs/dashboard/api-keys
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

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](https://foura.ai/docs/dashboard/quota) właściciela zlicza te klucze obok jego kluczy osobistych i rozdziela obie te kategorie.

## Powiązane

- [Uwierzytelnianie](https://foura.ai/docs/getting-started/authentication): Jak działają klucze API z API
- [Organizacje](https://foura.ai/docs/dashboard/teams-and-orgs): Role, członkowie i współdzielony dostęp
- [Użycie i limity](https://foura.ai/docs/dashboard/quota): Które klucze wliczają się do Twojego planu
- [Przegląd panelu](https://foura.ai/docs/dashboard/overview): Wszystkie sekcje panelu
