API для вашей CRM

Подключите CRM или инструменты отчётности к TixFlow и получайте свои мероприятия, заказы, посетителей и покупателей.

Что даёт API

REST API только для чтения ваших собственных данных: мероприятия, заказы (с билетами), посетители (билеты с именами гостей и отметками о проходе) и покупатели (все, кто у вас покупал, одна запись на email). Полный справочник — на странице /developers/api.

Создание ключа

Портал → Настройки → Интеграции → API-ключи → Создать ключ.

Назовите ключ (например, «синхронизация с HubSpot») и выберите, что он может читать.
Подтвердите, что ваша организация — контролёр (оператор) выгружаемых данных покупателей.
Сразу скопируйте ключ — он показывается только один раз. Если потеряли, отзовите его и создайте новый.

Создавать и отзывать ключи может только владелец профиля организатора. Ключ читает только данные того организатора, для которого создан.

Вызов API

Передавайте ключ в заголовке Authorization:

curl https://tixflow.org/api/v1/orders?createdFrom=2026-10-01T00:00:00Z \
  -H "Authorization: Bearer tf_live_…"

Списки возвращают data, nextCursor и hasMore. Пока hasMore равно true, вызывайте снова с cursor=<nextCursor>.

Синхронизация CRM

Сортируйте по updatedAt и сохраняйте последний nextCursor. В следующий раз передайте его обратно — и получите только изменения: новые заказы, возвраты, проходы.

# first run: everything, oldest change first
GET /api/v1/orders?sort=updatedAt
# store nextCursor; next run, only what changed since:
GET /api/v1/orders?sort=updatedAt&cursor=<stored nextCursor>

Одна и та же запись может прийти дважды — обновляйте по id, а не вставляйте заново.
Изменения последних секунд появятся при следующем вызове.
Удаления не передаются.

Согласие на рассылку

При каждой онлайн-покупке покупатель может отметить необязательную галочку о получении ваших новостей. API отдаёт его ответ в поле marketingConsent: true, false или null, если его не спрашивали (продажи на месте, старые заказы). API выгружает всех покупателей независимо от ответа — что он позволяет, решаете вы как контролёр данных.

Лимиты

120 запросов в минуту на ключ. В каждом ответе есть X-RateLimit-Remaining; при достижении лимита подождите Retry-After секунд.