Klucze API
Utwórz klucz API tylko z potrzebnymi uprawnieniami, skopiuj go jeden raz, wstrzymaj lub usuń oraz podłącz asystentów AI przez MCP i narzędzie wiersza poleceń zanfia.
Klucz API pozwala skryptowi, narzędziu do automatyzacji lub asystentowi AI działać na Twoim koncie bez Twojego hasła. Po wykonaniu tych kroków masz klucz z ograniczonym zestawem uprawnień, zapisany w bezpiecznym miejscu, i wiesz, jak go wstrzymać lub usunąć. Jak wywoływać API z użyciem klucza, opisuje dokumentacja dla deweloperów: Uwierzytelnianie i klucze API.
Otwórz API, MCP i CLI
W menu otwórz Integracje i wybierz API, MCP i CLI w grupie Zintegruj Zanfię
(/integrations/api-mcp-cli). Strona ma trzy zakładki: API, MCP i CLI. W zakładce
API sekcja Klucze API zawiera listę Twoich kluczy albo napis Brak kluczy API.
Zacznij nowy klucz
Kliknij Dodaj nowy klucz API. Pole Nazwa jest wypełnione wartością Mój klucz API (albo Mój klucz API #2, gdy ta nazwa jest zajęta); zmień ją na taką, która mówi, do czego klucz służy. Nazwa, która już istnieje, zostaje odrzucona z komunikatem Klucz o tej nazwie już istnieje.
Wybierz okres ważności
Pole Ważny przez ma na początku wartość 365 dni. Do wyboru są 1 dzień, 7 dni, 30 dni, 365 dni i Bezterminowo. Klucz po terminie przestaje działać i ma status Wygasł.
Nadaj tylko potrzebne uprawnienia
W sekcji Uprawnienia każdy obszar ma pola wyboru Odczyt i Zapis, na początku wszystkie zaznaczone. „Klucz może wykonywać tylko operacje włączone poniżej. Przyznaj jak najmniejszy zakres, jakiego potrzebuje integracja.” Co najmniej jedno musi pozostać zaznaczone (Zaznacz co najmniej jedno uprawnienie). Obszary wymienia tabela poniżej.
Zapisz i skopiuj klucz
Kliknij Zapisz. Okno Klucz API został utworzony ostrzega: „Ten klucz jest widoczny tylko raz i nie będzie można go później odczytać. Skopiuj go teraz i zapisz w bezpiecznym miejscu.” Klucz jest zasłonięty kropkami; ikona oka go odsłania, a przycisk kopiowania kopiuje pełny klucz także wtedy, gdy jest zasłonięty. Kliknij Gotowe.
Warto wiedzieć
Po zamknięciu okna nic na stronie nie pokaże klucza ponownie. Jeśli go zgubisz, usuń klucz i utwórz nowy. Traktuj klucz jak hasło: każdy, kto go ma, może zrobić wszystko, na co pozwalają jego uprawnienia.
Uprawnienia
| Obszar | Co obejmuje |
|---|---|
| Produkty | „Produkty, ceny, zamówienia, klienci i statystyki.” |
| Społeczności | „Kanały społeczności, posty i komentarze.” |
| Strony | „Hostowane strony niestandardowe i ich treść.” |
| Social media | „Połączone konta społecznościowe, szkice postów, planowanie i publikacja.” |
| Integracje | Klienci mailingowi, Meta Conversions API i płatność manualna, czyli połączenia z danymi dostępowymi. |
Na liście klucz ze wszystkimi uprawnieniami ma jedną etykietę Pełny dostęp; w pozostałych przypadkach ma etykietę dla każdego obszaru, na przykład Produkty: Odczyt lub Społeczności: Odczyt + Zapis.
Zarządzaj kluczami
Każdy wiersz pokazuje nazwę klucza, napis Ważny do z datą (albo Bezterminowo), uprawnienia i Status.
| Akcja | Jak | Efekt |
|---|---|---|
| Zobacz szczegóły | Kliknij wiersz | Okno z polami Status, Utworzony, Ważny do, Uprawnienia, Źródło i kopiowalnym ID klucza. Sam tajny klucz nigdy nie jest pokazywany. |
| Wstrzymaj | Ikona pauzy na końcu wiersza | „Klucz API został wstrzymany - żądania z tym kluczem będą odrzucane do czasu wznowienia”. Status zmienia się na Wstrzymany. |
| Wznów | Ten sam przycisk, teraz z ikoną odtwarzania | „Klucz API został wznowiony”. Status wraca do Aktywny. |
| Usuń | Ikona kosza, potem potwierdzenie „Czy na pewno chcesz usunąć ten klucz API?” | „Klucz API został usunięty”. Klucz przestaje działać na stałe. |
Wstrzymanie to bezpieczny pierwszy ruch, gdy podejrzewasz wyciek klucza albo integracja zachowuje się źle: działa natychmiast i da się je cofnąć.
Klucze, które nie powstały ręcznie
Niektóre wiersze powstają automatycznie i mają etykietę:
| Etykieta | Skąd się bierze | Co z nią zrobić |
|---|---|---|
| CLI | Tworzony przez zanfia login na komputerze. Powstaje ponownie przy każdym logowaniu z tego urządzenia. | Nic; nie trzeba nim zarządzać ręcznie. |
| Konektor | Tworzony przy podłączaniu aplikacji takiej jak claude.ai lub ChatGPT przez logowanie w przeglądarce (OAuth). | Usuń wiersz, aby odłączyć tę aplikację. |
Podłącz asystenta AI lub CLI
- Zakładka MCP. Zanfię można dodać jako serwer MCP w claude.ai, ChatGPT, Claude Code, Codex, Cursor lub VS Code, a asystent będzie mógł czytać dane Twojego konta i nim zarządzać. Aplikacje-konektory logują się przez przeglądarkę, bez klucza; pozostałe klienty używają klucza API z tej strony, a jego uprawnienia decydują, co asystent może zrobić. Zakładka zawiera adresy i fragmenty konfiguracji do skopiowania dla każdego klienta. Szczegóły: Podłącz klientów AI.
- Zakładka CLI. Dwa polecenia do skopiowania,
npm install -g @zanfia/cliizanfia login, instalują narzędzie wiersza poleceń i logują Cię przez przeglądarkę, bez klucza. Szczegóły: Szybki start z CLI.
Link Dokumentacja API pod tabelą kluczy otwiera dokumentację dla deweloperów.
Gdy strona informuje, że API jest wyłączone
Jeśli zakładka pokazuje komunikat „Integracja API jest wyłączona dla Twojego konta”, Twój plan nie obejmuje dostępu do API. Jest on częścią każdego aktualnego planu Zanfii; na starszym planie napisz na support@zanfia.com.
Czy ten artykuł był pomocny?