Собственный сайт
Используйте данные событий и расписаний в своём интерфейсе. Продумайте обновление доступности и переход к покупке, чтобы на сайте не оставались устаревшие даты или предложения.
Управление и интеграции / API и автоматизация
Передавайте данные о событиях и заказах в свои системы.
Если команде нужен собственный сайт, CRM или внутренний отчёт, используйте API и webhooks. Определите, какие сведения должны передаваться, кто отвечает за интеграцию и как система узнает об изменении заказа.
Автоматизация под ваш рабочий процесс
Начните с одного повторяющегося действия, для которого ручная работа уже неудобна.
Внутренняя CRM
Передавайте нужные сведения о заказах и отслеживайте изменение статуса. Определите правила сопоставления записей, чтобы повторное уведомление не создавало ещё одного покупателя или сделку.
Собственная аналитика
Собирайте нужную выборку для внутреннего отчёта. Уточните смысл показателей, периоды и обработку возвратов, прежде чем объединять данные платформы с другими источниками.
В деталях
Что обсудить с разработчиком заранее
Чтение данных и изменение состояния
Это разные уровни доступа и ответственности. Для отчёта может хватить чтения, а создание или изменение событий требует отдельных методов и прав. Выдавайте доступ под выбранную задачу.
API и webhooks дополняют друг друга
API позволяет запросить данные или выполнить доступное действие. Webhook сообщает о событии, например изменении заказа. Получатель должен интерпретировать уведомление и при необходимости сверить актуальное состояние через API.
Ошибки и повторы — часть сценария
Сеть может быть недоступна, уведомление — доставлено повторно, а данные — измениться до обработки. Заложите проверку подписи при использовании секрета, защиту от дубликатов и способ сверки записей после сбоя.
От задачи к проверенной интеграции
- 01
Опишите обмен данными
Выберите одну конкретную задачу: передать оплаченный заказ в CRM, обновить список событий на сайте или собрать внутренний отчёт. Укажите нужные поля, действия и направление передачи.
- 02
Проверьте методы и доступ
Разработчик сверяет актуальные методы, схему авторизации и права для каждой операции. Подготовьте безопасное хранение учётных данных и отдельную обработку ошибок.
- 03
Проверьте полный цикл
Проверьте создание заказа, изменение статуса, повторную доставку уведомления и временную недоступность вашей системы. Сопоставьте результат интеграции с актуальными данными кабинета.
Проверьте заранее
Согласуйте критерий готовности
Поля и статусы определены
Понятно, что передаётся и какое событие запускает обработку.
Доступ проверен
Нужные методы доступны выбранному способу авторизации, секреты хранятся на сервере.
Сбои обработаны
Повторное уведомление и временная ошибка не приводят к потере или удвоению данных.
Вопросы и ответы
Вопросы и ответы
Нужен ли API для обычной продажи билетов?
Нет. Страницы событий, продажи, заказы и проверка входа доступны через интерфейсы платформы. API нужен, когда вы хотите встроить данные или действия в собственный программный процесс.
С какими данными можно работать?
В организаторском API есть операции для событий, расписаний, категорий билетов, регистрационных вопросов, заказов и участников. Конкретные методы, поля и разрешения нужно сверять с актуальной документацией для вашей задачи.
Какие уведомления о заказах доступны?
Webhooks предусмотрены для order.created и order.status_changed. Создание заказа ещё не означает оплату: получатель должен проверить тип события, статус и при необходимости запросить актуальное состояние заказа.
Может ли webhook прийти повторно?
Да, предусмотрены повторные доставки. Обработчик должен безопасно принимать повторное уведомление, не создавая дубликаты в вашей системе. При настроенном секрете используется подпись; её проверку нужно включить на стороне получателя.
Можно ли дать один API-ключ для всех действий?
Не стоит рассчитывать на это. Основная группа методов поддерживает API-ключи и пользовательскую авторизацию, но отдельные операции требуют именно пользовательского доступа. Разработчик должен проверить каждый нужный метод и не размещать секреты в публичном коде сайта.
OBLAKKARTE
Создать аккаунтНачните с процесса, который хотите автоматизировать
Подготовьте событие и обсудите с разработчиком обмен данными между Oblakkarte и вашей системой.