Tokeny API i REST API

Właściciel i Administrator firmy otwierają Administrator firmy → Sprzedaż i integracje → Integracje → API i webhooki. Połącz witrynę, ERP lub inne narzędzia: odczytuj i zapisuj kontakty, leady i szanse sprzedaży przez REST API oraz otrzymuj zdarzenia przesyłane do swoich systemów.

#Tworzenie tokenu

1. W sekcji Tokeny API proszę wybrać Nowy token.
2. Proszę wpisać Nazwa, na przykład system, który będzie go używał.
3. W polu Działa jako proszę wybrać, w czyim imieniu są wprowadzane zmiany: - Firma: Zmiany nie wskazują osoby. Działa nadal po odejściu pracowników. - Ja: Zmiany są oznaczane moim nazwiskiem. Przestaje działać po utracie uprawnień administratora.
4. W sekcji Uprawnienia proszę zaznaczyć to, czego potrzebuje drugi system, np. Kontakty · odczyt lub Kontakty · zapis. Zapis obejmuje odczyt. Należy przyznać tylko to, czego potrzebuje drugi system.
5. Proszę wybrać, kiedy Wygasa, i wybrać Utwórz token.
6. Proszę skopiować token i wybrać Zapisałem(-am) go. Token jest wyświetlany tylko ten jeden raz. Należy zapisać go w ustawieniach poufnych drugiego systemu. Przesyłaj go jako: Authorization: Bearer <token>

Dla każdego systemu warto utworzyć osobny token, aby można je było odbierać oddzielnie.

#Korzystanie z API

Proszę wybrać Dokumentacja API, aby zobaczyć endpointy, pola i przykłady. API obejmuje kontakty, leady, szanse sprzedaży i firmy: listowanie, odczyt, tworzenie i zmianę. Nie można nim usuwać rekordów.

• Listy zwracają do 50 pozycji na stronę (maksymalnie 100 z limit) oraz nextCursor dla następnej strony.
• Każdy token może wysłać 120 żądań na minutę. Powyżej API odpowiada 429 z nagłówkiem Retry-After.
• Każda zmiana wykonana tokenem jest zapisywana w dzienniku audytu z nazwą tokenu.

#Odbieranie tokenu

Proszę wybrać Odbierz obok tokenu. Systemy korzystające z tego tokenu natychmiast przestaną działać. Przy każdym tokenie widać, kiedy był ostatnio użyty, więc łatwo znaleźć niepotrzebne.