---
title: "Ticket Fairy API, вебхуки, CLI и MCP-сервер - Ticket Fairy"
description: "Каждый оплаченный заказ попадает в ваши собственные системы за секунды. У каждого инструмента свой токен доступа, повторяющуюся настройку можно автоматизировать скриптами, а ИИ-ассистенты помогают в пределах вашей роли."
canonical: "https://www.ticketfairy.com/ru/features/api-and-developers"
---

API и разработчики

# Отправляйте каждый заказ в свои системы за секунды

Вы получаете каждый заказ на свой адрес через секунды после оплаты. Повторяющуюся настройку можно автоматизировать скриптами или поручить ИИ-ассистенту, в пределах ваших прав доступа.

  [Начать бесплатно](https://manage.ticketfairy.com/registration) [Заказать демо](https://www.ticketfairy.com/ru/event-ticketing/book-a-demo)    ![Карточка «Персональные токены доступа» в Ticket Fairy со списком токенов и датами создания, последнего использования и окончания срока](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--personal-access-tokens.png)

- Каждая продажа в ваших системах за секунды
- Никаких паролей от панели управления для инструментов
- Вы один раз описываете скриптом повторяющиеся настройку и отчёты

- **25 000+** мероприятий
- **10M+** выпущенных билетов
- **10+** стран
- **20%** больше билетов благодаря реферальным наградам

## Подключайте свои инструменты, не делясь паролем

Если ваше агентство или промоутерская компания использует собственную CRM, отчётность или сайт, вы можете подключить их к Ticket Fairy напрямую.

В настройках аккаунта вы создаёте персональный токен доступа для каждого ноутбука, сервера, скрипта или агента, называете его по инструменту, который его использует, и задаёте подходящий срок действия. Каждый токен несёт вашу собственную роль, поэтому открывает только доступные вам бренды и мероприятия, а если ноутбук пропал, его токен можно сразу отозвать. Ваши скрипты используют API Ticket Fairy, чтобы создавать мероприятия и получать их продажи, а если скрипт повторит запрос после сетевой ошибки, мероприятие всё равно будет одно, а не два.

- **Персональные токены доступа**: по одному на каждый инструмент, со своим сроком действия и мгновенным отзывом
- **API Ticket Fairy**: создавайте мероприятия и получайте их продажи из своих скриптов
- **Клиент для Python**: публичные мероприятия без аккаунта, ваши собственные с токеном

## Получайте каждый заказ в своих системах через секунды после оплаты

Ваша CRM и отчётность остаются актуальными, и никому не нужно выгружать файлы. С вебхуком для бренда, тура или мероприятия вы получаете каждый заказ на свой адрес через секунды после оплаты, с билетами, дополнениями, суммами и данными владельцев билетов.

Когда заказ меняют, передают или по нему делают возврат, вы снова получаете его целиком. Вебхуки бренда и тура также могут сообщать о новых, изменённых и опубликованных мероприятиях. Вы можете выбрать полный заказ или формат, которого ждёт Zapier, Iterable или Symmetry, и подключить Zapier с помощью API-ключа вебхука. Тест со страницы «Вебхуки» проверяет, что ваш адрес его принимает.

- **Вебхуки заказов**: для бренда, тура или одного мероприятия
- **Zapier**: подключается с помощью API-ключа вебхука
- **Отправить тест**: пример данных, который проверяет ваш адрес до первого заказа

    ![Карточки «API-ключ» и «API-ключ вебхука» в Ticket Fairy, каждая с ключом, кнопкой копирования и кнопкой создания нового ключа](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--api-keys.png)

## Продавайте билеты на своём сайте или в своём приложении

Покупатели выбирают билеты и платят, не покидая ваш сайт. Код Event Embed встраивает оформление заказа в вашу страницу мероприятия.

React SDK для оформления заказа даёт вам оформление заказа без брендинга Ticket Fairy на вашем собственном сайте на React, а React Native SDK для оформления заказа продаёт билеты в вашем собственном приложении для iPhone или Android. Ваш сайт также может показывать ваши текущие публичные мероприятия через публичный API мероприятий, ключ не нужен.

- **Виджет мероприятия**: оформление заказа на вашей собственной странице мероприятия
- **React SDK для оформления заказа**: оформление заказа в вашем стиле на вашем сайте на React
- **React Native SDK для оформления заказа**: продажа билетов в вашем собственном приложении для iOS или Android

    ![Страница безопасности виджета мероприятия в Ticket Fairy с адресами сайтов, на которых разрешено оформление заказа](https://www.ticketfairy.com/embeds/posters/marketing-event-embeds--allowed-sites.png)

## Поручите собственному ИИ-ассистенту рутинную работу с мероприятиями

Установив инструмент командной строки Ticket Fairy (CLI) и один раз войдя в него, вы можете автоматизировать скриптами повторяющуюся настройку и отчёты, например копирование мероприятия или сохранение сводки продаж каждую ночь.

CLI также запускает MCP-сервер на вашем компьютере, поэтому Claude Code, Cursor и другие ассистенты могут видеть ваши продажи в реальном времени и выполнять за вас рутинную настройку, при желании только в режиме чтения. Перед удалением или отменой ваш ИИ-клиент просит вас это одобрить. ИИ-агент, который просит действовать от вашего имени, получает доступ только после вашего одобрения, а прекратить этот доступ можно в «Настройках аккаунта».

- **Ticket Fairy CLI**: мероприятия, билеты, заказы и отчёты из терминала
- **MCP-сервер**: ваш ассистент действует от вашего имени, с вашей ролью
- **ИИ-агенты, которых вы одобряете**: прекращайте доступ агента в любой момент

[Начать бесплатно](https://manage.ticketfairy.com/registration) [Заказать демо-звонок](https://www.ticketfairy.com/ru/event-ticketing/book-a-demo)

## Стройте на Ticket Fairy со всем, что нужно вашему разработчику

- ### Персональные токены доступа

  Каждый инструмент получает именной токен с собственным сроком действия. Его можно заменить с перекрытием, чтобы работающая задача не остановилась, и отозвать мгновенно.
- ### API-ключ бренда

  Вы можете создать ключ, который требуют API мероприятий, например рейтинг рефералов, и создать его заново, когда нужен новый.
- ### API Ticket Fairy

  Ваши собственные скрипты могут создавать мероприятия и получать их продажи, а ваш разработчик работает по описанию OpenAPI.

  [Подробнее](https://www.ticketfairy.com/developers)
- ### Публичный API мероприятий

  Текущие публичные мероприятия, включая ваши, доступны без аккаунта, а о предстоящих мероприятиях можно спросить простым языком.

  [Подробнее](https://www.ticketfairy.com/developers)
- ### Вебхуки заказов

  Вы получаете каждый заказ на свой адрес после оплаты и снова каждый раз, когда его меняют, передают или по нему делают возврат.

  [Подробнее](https://www.ticketfairy.com/developers)
- ### Вебхуки мероприятий

  Вебхуки бренда или тура сообщают о новых, изменённых и опубликованных мероприятиях.

- ### Zapier, Iterable и Symmetry

  Каждый из этих инструментов получает формат вебхука, которого ждёт, а вы подключаете Zapier с помощью API-ключа вебхука.
- ### Ticket Fairy CLI

  Мероприятиями, билетами, заказами, клиентами и командой можно управлять из командной строки или задачи по расписанию.

  [Подробнее](https://www.ticketfairy.com/cli)
- ### MCP-сервер

  Claude Code, Cursor или другой MCP-клиент может подключиться к вашим мероприятиям, при желании начав с режима только для чтения.

  [Подробнее](https://www.ticketfairy.com/mcp-server)
- ### Одобрение ИИ-агентов

  Каждому ИИ-агенту, который просит действовать от вашего имени, нужно ваше одобрение, а прекратить его доступ можно в «Настройках аккаунта».
- ### Виджет мероприятия

  Оформление заказа может стоять на вашей странице мероприятия, чтобы покупатели платили, не покидая ваш сайт.

  [Подробнее](https://www.ticketfairy.com/ru/features/event-pages-and-website)
- ### SDK для оформления заказа

  Вы можете создать своё оформление заказа на сайте на React или в своём приложении для iPhone или Android.

  [Подробнее](https://www.ticketfairy.com/developers)
- ### Маркетинговые интеграции

  Покупатели попадают в Klaviyo, Mailchimp, Laylo и Hive без единой строки кода.

  [Подробнее](https://www.ticketfairy.com/ru/features/integrations)
- ### Fai и ваши вебхуки

  Fai, the AI teammate in your dashboard, can list, add, change, test or delete your webhooks, and asks you to approve each change.

  [Подробнее](https://www.ticketfairy.com/ru/features/fai)
- ### Мероприятия, созданные вашим ИИ-ассистентом

  ИИ-ассистент может создать мероприятие по названию, датам, площадке и описанию. Ссылка, которую он даёт, открывает регистрацию или вход, и мероприятие появляется в вашем бренде как черновик для проверки.
- ### Схемы зала и проверка документов в вашем оформлении заказа

  С React SDK для оформления заказа покупатели выбирают места на схеме зала и платят картой через Stripe или Xendit, а в вашем приложении SDK проверяет документы покупателей и сохраняет вход для вошедших покупателей.
- ### Оформление заказа в ваших цветах

  Вы задаёте акцентный цвет, фоны, цвета текста, скругления и шрифты в светлой или тёмной теме или располагаете разделы оформления заказа по-своему.
- ### Промокоды и реферальные бонусы в вашем приложении

  Оформление заказа может открываться с уже применённым промокодом, засчитывать продажу тому, кто привёл покупателя, и показывать покупателям их награды за рекомендации после оплаты.
- ### Кто настроил каждый вебхук

  Вы видите, кто и когда добавил каждый вебхук, можете выключить и снова включить его, не теряя адрес, и отправить тестовый запрос, который покажет, получил ли его ваш адрес.
- ### Токены, которыми больше не пользуется ни один инструмент

  Вы видите, когда каждый персональный токен доступа использовался в последний раз, и можете отозвать те, которые не нужны ни одному инструменту.

## Как это выглядит в панели управления

- ![Страница установки виджета мероприятия в Ticket Fairy с кодом оформления заказа, готовым к вставке](https://www.ticketfairy.com/embeds/posters/marketing-event-embeds--install.png)
  *С кодом виджета мероприятия на странице мероприятия покупатели платят, не уходя с вашего сайта.*
- ![Карточка Laylo на странице «Интеграции» в Ticket Fairy с полем URL вебхука Laylo и кнопками «Показать» и «Сохранить»](https://www.ticketfairy.com/embeds/posters/marketing-brand-integrations--laylo.png)
  *Одна вставленная ссылка отправляет каждый оплаченный заказ в Laylo, без всякого кода.*

## Подключите свои инструменты шаг за шагом

Руководства доступны на английском языке.

- [Create an API key so your own tools can read your ticket sales](https://www.ticketfairy.com/guides/create-an-api-key-for-your-own-app)
- [Get a webhook each time you take a ticket order](https://www.ticketfairy.com/guides/get-a-webhook-when-a-ticket-sells)
- [Sell tickets on your own website](https://www.ticketfairy.com/guides/sell-tickets-on-your-own-website)

## Частые вопросы: API и разработчики

### API и разработчики

#### Что использовать: персональный токен доступа или API-ключ?

Используйте персональный токен доступа для командной строки, MCP-сервера, своих скриптов и агентов. Используйте API-ключ бренда для API мероприятий, например рейтинга рефералов. Создание нового API-ключа останавливает каждое приложение, которое использует старый ключ, пока вы его не обновите.

#### Сколько действует персональный токен доступа?

По умолчанию год, и это также максимальный срок. Для разового скрипта выберите срок короче. Токен показывается один раз, поэтому скопируйте его, прежде чем закрыть окно. Когда вы меняете токен, старый продолжает работать до семи дней, пока вы его заменяете.

#### Сколько токенов можно создать?

Десять в час, считая замены, и нельзя создать новый, пока действуют пятьдесят. Отзывать можно сколько угодно.

#### Что происходит, когда адрес моего вебхука не работает?

Эта доставка не проходит и повторно не отправляется, а следующий заказ приходит как обычно. Если ваш адрес отвечает 410 Gone, мы удаляем вебхук. Адреса вебхуков должны начинаться с https://.

#### Можно ли проверить, что запрос вебхука пришёл от Ticket Fairy?

Да. Добавьте к вебхуку секрет подписи, и тогда каждый запрос будет содержать заголовок X-Signature, который ваша система проверяет тем же секретом. Как это сделать, описано в документации по вебхукам.

#### Может ли один и тот же заказ прийти на мой вебхук несколько раз?

Да. Заказ целиком отправляется снова каждый раз, когда он меняется, а вебхук бренда и вебхук мероприятия, отправляющие на один адрес, оба его отправят. Сверяйте по номеру заказа, а не считайте каждую доставку новой продажей.

#### Как покупатели платят в моём собственном приложении?

Через Stripe. React Native SDK для оформления заказа принимает платежи через Stripe React Native SDK, а в его документации описана настройка для iOS и Android.

#### Стоят ли что-нибудь CLI и MCP-сервер?

Нет. Оба бесплатны с вашим аккаунтом Ticket Fairy и требуют Node 20 или новее. MCP-сервер поставляется вместе с CLI. Команды и инструменты Vault предназначены для брендов с доступом к Vault и работают только на чтение.

#### Может ли ИИ-ассистент или токен сделать больше, чем я?

Нет. Каждый из них действует от вашего имени, с вашей ролью и вашими брендами, поэтому не может открыть данные другого бренда или выдать себе новые права.

#### Как долго действует ссылка от моего ИИ-ассистента?

Три дня или до тех пор, пока вы не зарегистрируетесь или не войдёте по ней. Мероприятие закрепляется за первым браузером, который откроет ссылку, и после этого ассистент не может менять мероприятие.

#### Что нужно для SDK оформления заказа в приложении?

React Native 0.81 или новее с New Architecture, React 19.1 или новее, iOS 15.1 или новее и Android API 24 или новее. Нужна development build, потому что Expo Go не может его загрузить. Установите tf-checkout-react для сайта и tf-checkout-react-native для приложения, оба из npm.

#### Какой срок действия можно задать персональному токену доступа?

Час, 7 дней, 30 дней, 90 дней или год в разделе «Задать свой срок действия». Каждый член команды создаёт свои токены, а отзыв одного токена не затрагивает ваш пароль и другие токены.

#### Можно ли протестировать вебхук со своего компьютера?

Да, через туннельный сервис, который даёт вашему компьютеру адрес https. Неудачный тест показывает код ответа, который вернул ваш адрес.

#### How do I get a client ID for the checkout SDK?

Open your brand in the dashboard, select Checkout apps and add an app. Enter each website that sells tickets, or none for a mobile app, then copy the client ID and setup code. There is no client secret to keep, and an app sells only your brand's events.

## Ещё о Ticket Fairy

- ### [Добавляйте каждого покупателя билетов в свои маркетинговые инструменты](https://www.ticketfairy.com/ru/features/integrations)

  Покупатели билетов попадают в Klaviyo, Mailchimp, Laylo и Hive без выгрузки списков, а каждый инструмент вы подключаете один раз для всего бренда.
- ### [Превращайте больше посетителей в покупателей билетов](https://www.ticketfairy.com/ru/features/event-pages-and-website)

  Вы можете создавать страницы мероприятий, которые отвечают на вопросы покупателей, давать каждой кампании свою страницу, проверять, какая версия продаёт больше, и продавать билеты на своём сайте.
- ### [Выполняйте работу с билетами, просто попросив Fai](https://www.ticketfairy.com/ru/features/fai)

  Вы получаете ответы о продажах за секунды, Fai берёт на себя настройку мероприятий, акции и письма и готовит финансовую работу. Каждое изменение вы сначала одобряете.
- ### [Дайте каждому в команде тот доступ, который нужен для его работы](https://www.ticketfairy.com/ru/features/teams-and-security)

  Вы можете пригласить команду с доступом, нужным для каждой работы, и защитить свой вход. Вся ваша команда работает на любом платном тарифе без оплаты за каждого пользователя. С первого дня «Главная» показывает, с чего начать.

      [Назад **Интеграции**](https://www.ticketfairy.com/ru/features/integrations) [Возможности **Все возможности**](https://www.ticketfairy.com/ru/features)

Узнайте, как [билетная платформа для организаторов](https://www.ticketfairy.com/event-ticketing/) Ticket Fairy помогает продавать больше билетов, и посмотрите все возможности, цены и поддержку, которые вы получаете.

## Начните продавать билеты онлайн

Зарегистрируйтесь без банковской карты и создайте тестовое мероприятие, прежде чем принимать решение. Когда будете готовы, запустите продажи за минуты.

Неограниченное число мероприятий без ежемесячной платы

Начните продавать билеты немедленно

Инструменты для билетов, входа и сайта на любом тарифе, включая Free

   [Начать](https://manage.ticketfairy.com/welcome)

Кредитная карта не требуется

The Ticket Fairy, Inc. является финтех-компанией и технологической платформой. The Ticket Fairy, Inc. не является банком, финансовым учреждением или регулируемым поставщиком финансовых услуг. Банковские услуги Vault предоставляются через регулируемых банковских партнёров.
