Jak utworzyć i używać tokenu API

Tokeny API umożliwiają innemu systemowi połączenie z Państwa kontem TicketingHub. Do zarządzania nimi wymagany jest dostęp administratora.

Do czego można używać tokenu API?

• Przesyłania danych z TicketingHub do oprogramowania raportowego lub hurtowni danych.
• Umożliwienia niestandardowej platformie partnera odczytu produktów i cen.
• Tworzenia obsługi rezerwacji po stronie serwera, która sprawdza dostępność na żywo.

Token API nie tworzy wbudowanego połączenia z Arkuszami Google. Zobacz artykuł Jak eksportować dane z TicketingHub i łączyć inne narzędzia, aby wybrać między eksportami CSV, Zapierem, webhookami i dostępem przez API.

Włącz dostęp do API

1. Przejdź do Ustawienia → Funkcje.
2. Włącz Dostęp do API.

To ustawienie jest dostępne samodzielnie. Po jego włączeniu w Ustawieniach pojawi się sekcja Tokeny API.

Utwórz token

1. Przejdź do Ustawienia → Tokeny API.
2. Wybierz Wygeneruj token API.
3. Wprowadź nazwę identyfikującą system, który będzie używać tokenu.
4. Wybierz Supplier API (V2) do zarządzania ofertą dostawcy, Widget API do sprawdzania dostępności i obsługi rezerwacji lub OCTO API do łączenia systemów korzystających ze standardu OCTO.
5. Jeśli wybrano Supplier API (V2) lub OCTO API, można wybrać opcję Tylko do odczytu, gdy integracja musi jedynie wyświetlać dane. Ta opcja nie dotyczy tokenów Widget API.
6. W razie potrzeby dodaj datę wygaśnięcia, a następnie wygeneruj token.
7. Skopiuj token od razu i przechowuj go w bezpiecznym miejscu. Pełny token jest wyświetlany tylko raz.

Używaj tokenu

Przesyłaj token w nagłówku Authorization każdego żądania API:

Authorization: Bearer YOUR_TOKEN

Tokenów API używaj wyłącznie w bezpiecznych systemach działających po stronie serwera. Nie umieszczaj tokenu w kodzie witryny, wiadomościach e-mail, wiadomościach na czacie ani udostępnianych dokumentach.

Unieważnij token

Przejdź do Ustawienia → Tokeny API i wybierz Unieważnij obok tokenu. Unieważnienie zaczyna obowiązywać natychmiast, dlatego połączony system przestanie działać do czasu użycia zastępczego tokenu.

Utwórz osobny token dla każdej integracji, przyznawaj wyłącznie wymagany zakres dostępu i unieważniaj tokeny, które nie są już używane. W przypadku aktualizacji opartych na zdarzeniach możesz preferować webhooki lub integrację z Zapierem.