Перейти к содержимому
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.