Przejdź do głównej zawartości
Otwórz Entergram

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ć.


Create key: wydaj klucz przypisany do workspace’u, z jawnymi zakresami i stałą datą wygaśnięcia.

PoleUwagi
Key namenp. Zapier CRM bridge. Wymagane
ScopesPrzyznaj tylko minimalny dostęp potrzebny tej integracji. Co najmniej jeden
Expiry dateKażdy klucz musi wygasać. Zalecany okres: od 30 do 90 dni
IP allowlistOpcjonalne. Jeden adres IP lub CIDR w wierszu albo rozdzielone przecinkami, np. 203.0.113.10, 198.51.100.0/24

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.


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”.


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
ScopesCo klucz może robić
Created / Created byPochodzenie
ExpiresOstateczny termin
Last usedNever do pierwszego użycia
UsageAktywność żądań
Source IPSkąd przyszły wywołania
User agentNo requests yet do pierwszego użycia
IP allowlistLub No IP restrictions configured for this key
AkcjaEfekt
Copy keyTylko 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ą.)
DocsOtwiera dokumentację API

Zdarzenia z cyklu życia kluczy są audytowane: Public API key created / rotated / revoked pojawiają się w historii logów.


Rotacja unieważnia stary klucz w chwili wydania nowego, więc zaplanuj ją:

  1. Utwórz drugi klucz z tymi samymi zakresami.
  2. Wdróż nowy klucz w swojej integracji.
  3. Sprawdź ruch na nowym kluczu w Last used / Usage.
  4. 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.


  • 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.

KomunikatZnaczenie
PRO access requiredPrzejdź w workspace na plan Pro
Admin access requiredNie jesteś właścicielem ani administratorem
Public API key management is temporarily unavailableChwilowy problem, spróbuj ponownie za moment
Public API hashing not configuredProblem z konfiguracją po stronie serwera, skontaktuj się z pomocą techniczną
Public API storage not readyOczekuje migracja bazy danych, skontaktuj się z pomocą techniczną