Первый запуск
- Шаг 1
Откройте «Интеграции разработчиков» и просмотрите доступные на данный момент области действия.
- Шаг 2
Создавайте токен только для тех операций, которые вам нужны.
- Шаг 3
Используйте примеры и формат данных, показанные на информационной панели. Удерживайте курсор при чтении событий.
- Шаг 4
Обработка прерываний, повторных попыток и отсутствия новых событий. Отзовите токен, который вам больше не нужен.
Пример трансляции
Ваш собственный инструмент извлекает последующие события, не обрабатывая одну и ту же историю несколько раз. Курсор позволяет продолжить с последней позиции, а ограниченные области действия токена сужают его разрешения.
Действия и возможности
Ключи с диапазонами
В разделе «Интеграции» создайте ключ с отдельными разрешениями для состояния LIVE, событий, таймера или музыкальной очереди. Мы показываем ключ только один раз. Выберите срок действия 7, 30 или 90 дней; вы можете отозвать его в любое время.
Чтение и курсор
Передайте ключ в заголовке Authorization: Bearer. При чтении событий используется курсор after, благодаря чему автоматика не повторяет старые сообщения. Первое чтение без курсора начинается с текущего момента. Чтение ограничивается данными владельца ключа.
Пример и документация
Загрузите описание OpenAPI 3.1 и образец JavaScript на свой сервер, Node-RED или другую среду автоматизации. Отправляйте по одному запросу, рекомендуется каждые две секунды, с ограничением 60 запросов в минуту. Не размещайте ключ в общедоступном HTML или в адресе наложения.
Посмотреть интерфейс вблизи
Нажмите на иллюстрацию, чтобы увеличить ее. На скриншотах показаны различные части установки; подпись объясняет, на что следует обратить внимание.
Когда что-то не работает
Запросу запрещен доступ
Проверьте токен и необходимую область действия. Используйте актуальную документацию по конечной точке и правильный метод запроса.
Те же события повторяются
Сохраните возвращенный курсор и идентификаторы дедупликации. Не начинайте каждое чтение с начала рассказа.