Publiczne klucze API
Settings → Developers → API: twórz klucze API przypisane do workspace’u dla zewnętrznych integracji i zarządzaj nimi.
Klucza API używasz wtedy, gdy integracja nie jest klientem MCP: most do Zapiera, wewnętrzna usługa, zadanie raportowe.
PRO access required: zanim wydasz publiczne klucze API, przejdź w tym workspace na plan Pro. Admin access required: tylko właściciele i administratorzy workspace’u mogą tworzyć klucze i nimi zarządzać.
Tworzenie klucza
Dział zatytułowany „Tworzenie klucza”Create key: wydaj klucz przypisany do workspace’u, z jawnymi zakresami i stałą datą wygaśnięcia.
| Pole | Uwagi |
|---|---|
| Key name | np. Zapier CRM bridge. Wymagane |
| Scopes | Przyznaj tylko minimalny dostęp potrzebny tej integracji. Co najmniej jeden |
| Expiry date | Każdy klucz musi wygasać. Zalecany okres: od 30 do 90 dni |
| IP allowlist | Opcjonalne. Jeden adres IP lub CIDR w wierszu albo rozdzielone przecinkami, np. 203.0.113.10, 198.51.100.0/24 |
Dostępne zakresy
Dział zatytułowany „Dostępne zakresy”Workspace access · Members access · Accounts access · Contacts access · Chats access / Chats write · Custom fields read / write · Messages read / Messages write · Tickets read / Tickets write.
Messages write wysyła wiadomości w Telegramie jako Twoje konta. Przyznaj go tylko wtedy, gdy integracja naprawdę musi wysyłać wiadomości.
Przechowywanie klucza
Dział zatytułowany „Przechowywanie klucza”Klucz w postaci jawnej jest pokazywany tylko raz:
Store this API key now: klucz w postaci jawnej jest widoczny tylko raz. Po zamknięciu tego okna widoczny pozostanie tylko prefiks. Zapisz ten klucz w menedżerze haseł lub menedżerze sekretów, zanim zamkniesz okno.
Entergram przechowuje tylko hash klucza. Nie ma opcji „pokaż klucz ponownie”.
Zarządzanie kluczami
Dział zatytułowany „Zarządzanie kluczami”Lista pokazuje Active keys i Total keys, ze statusem Active, Expired lub
Revoked. Show archived ({n}) wyświetla wycofane klucze.
Dla każdego klucza:
| Pole | |
|---|---|
| Scopes | Co klucz może robić |
| Created / Created by | Pochodzenie |
| Expires | Ostateczny termin |
| Last used | Never do pierwszego użycia |
| Usage | Aktywność żądań |
| Source IP | Skąd przyszły wywołania |
| User agent | No requests yet do pierwszego użycia |
| IP allowlist | Lub No IP restrictions configured for this key |
| Akcja | Efekt |
|---|---|
| Copy key | Tylko gdy jednorazowe okno jest otwarte |
| Rotate | „The current key will be revoked and replaced with a newly generated key.” (Obecny klucz zostanie unieważniony i zastąpiony nowo wygenerowanym.) |
| Revoke | „This key will stop working immediately for all clients using it.” (Klucz natychmiast przestanie działać dla wszystkich klientów, którzy go używają.) |
| Docs | Otwiera dokumentację API |
Zdarzenia z cyklu życia kluczy są audytowane: Public API key created / rotated / revoked pojawiają się w historii logów.
Rotacja bez przestojów
Dział zatytułowany „Rotacja bez przestojów”Rotacja unieważnia stary klucz w chwili wydania nowego, więc zaplanuj ją:
- Utwórz drugi klucz z tymi samymi zakresami.
- Wdróż nowy klucz w swojej integracji.
- Sprawdź ruch na nowym kluczu w Last used / Usage.
- Revoke (Revoke) stary klucz.
Dwa klucze i unieważnienie starego to lepsze rozwiązanie niż rotacja działającego klucza i wyścig z wdrożeniem.
Dobre praktyki
Dział zatytułowany „Dobre praktyki”- Jeden klucz na integrację. Przy współdzielonych kluczach nie unieważnisz jednej rzeczy, nie psując przy tym trzech innych.
- Ważność 30-90 dni, tak jak zaleca aplikacja. Chodzi właśnie o wymuszoną rotację.
- Zawsze ustawiaj listę dozwolonych IP, gdy wywołujący ma stały adres IP. Dzięki temu wyciek klucza to drobna niedogodność, a nie katastrofa.
- Nazywaj klucze od systemów, nie od ludzi.
- Sprawdź Last used przed odnowieniem. Klucz, którego nikt nie używa, to czyste ryzyko.
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”| Komunikat | Znaczenie |
|---|---|
| PRO access required | Przejdź w workspace na plan Pro |
| Admin access required | Nie jesteś właścicielem ani administratorem |
| Public API key management is temporarily unavailable | Chwilowy problem, spróbuj ponownie za moment |
| Public API hashing not configured | Problem z konfiguracją po stronie serwera, skontaktuj się z pomocą techniczną |
| Public API storage not ready | Oczekuje migracja bazy danych, skontaktuj się z pomocą techniczną |
Powiązane
Dział zatytułowany „Powiązane”- Konektory MCP, dla klientów AI
- Lista kontrolna prywatności
Preferencje plików cookie
Szanujemy Państwa prawo do prywatności. Prosimy wybrać, na które pliki cookie wyrażają Państwo zgodę. Wybór obowiązuje w całej witrynie. Polityka plików cookie
Wymagane do działania witryny, w tym do zapamiętania Państwa wyborów dotyczących prywatności. Zawsze włączone.
Pomagają nam zrozumieć korzystanie z witryny i przypisać rejestracje do partnerów polecających. Opcjonalne.