Перейти до вмісту
TicketingHub Help

Як створити та використовувати токен API

Токени API дають змогу іншій системі підключатися до вашого облікового запису TicketingHub. Для керування ними у вас має бути доступ адміністратора.

Для чого можна використовувати токен API?

  • Надсилати дані TicketingHub до програмного забезпечення для створення звітів або сховища даних.
  • Надавати власній партнерській платформі доступ для перегляду продуктів і цін.
  • Створювати серверний процес бронювання, який перевіряє актуальну доступність.

Токен API не створює вбудоване підключення до Google Sheets. Перегляньте статтю Як експортувати дані TicketingHub і підключити інші інструменти, щоб вибрати між експортом у форматі CSV, Zapier, вебхуками та доступом через API.

Увімкнення доступу до API

  1. Перейдіть до Налаштування → Функції.
  2. Увімкніть Доступ до API.

Це налаштування доступне самостійно. Після його ввімкнення в розділі «Налаштування» з’явиться пункт Токени API.

Створення токена

  1. Перейдіть до Налаштування → Токени API.
  2. Виберіть Створити токен API.
  3. Введіть назву, яка дасть змогу ідентифікувати систему, що використовує токен.
  4. Виберіть Supplier API (V2) для керування постачальником, Widget API для перевірки доступності та бронювання або OCTO API для підключення систем, які підтримують стандарт OCTO.
  5. Якщо ви вибрали Supplier API (V2) або OCTO API, можна вибрати режим Лише для читання, якщо інтеграції потрібен лише перегляд даних. Цей параметр не застосовується до токенів Widget API.
  6. За потреби додайте дату завершення дії, а потім створіть токен.
  7. Негайно скопіюйте токен і зберігайте його в безпечному місці. Повний токен відображається лише один раз.

Використання токена

Надсилайте токен у заголовку Authorization кожного запиту API:

Authorization: Bearer YOUR_TOKEN

Використовуйте токени API лише в захищених серверних системах. Не розміщуйте токен у коді вебсайту, електронних листах, повідомленнях у чатах або спільних документах.

Відкликання токена

Перейдіть до Налаштування → Токени API і виберіть Відкликати поруч із потрібним токеном. Відкликання набуває чинності негайно, тому підключена система припинить працювати, доки не почне використовувати токен на заміну.

Створюйте окремий токен для кожної інтеграції, надавайте лише потрібний їй доступ і відкликайте токени, які більше не використовуються. Для оновлень на основі подій можна використовувати вебхуки або інтеграцію із Zapier.