API и Webhook Radario
Как получать данные о событиях, билетах и заказах в свою систему
Как получать данные о событиях, билетах и заказах в свою систему
API и Webhook - в чем разница
API - ваша система сама обращается к Radario и запрашивает необходимые данные.
Webhook - Radario автоматически передает данные во внешнюю систему после продажи или возврата.
Проще говоря: API отвечает на вопрос «что есть в Radario сейчас?», а webhook сообщает
«в Radario только что произошло событие».
Webhook - Radario автоматически передает данные во внешнюю систему после продажи или возврата.
Проще говоря: API отвечает на вопрос «что есть в Radario сейчас?», а webhook сообщает
«в Radario только что произошло событие».
Что использовать для вашей задачи
Задача | Что использовать |
Автоматически выводить события на своём сайте | API — GET /events |
Получать данные о событиях и билетах | API |
Проверять наличие билетов | API — GET /events или GET /events/{eventId}/ticket_types |
Получать данные о заказах и покупателях | API |
Передавать заказы в CRM | API + Webhook |
Получать данные сразу после продажи/возврата | Webhook |
Запускать действие во внешней системе после покупки | Webhook |
Как работает API
Через API внешняя система может получать из Radario данные о событиях, местах проведения, типах билетов и тарифах, местах на схеме зала, количестве билетов, заказах и покупателях - в зависимости от используемого метода и уровня доступа.
API-документация
Собственная афиша на сайте. Через GET /events можно автоматически получать данные мероприятий и использовать их на своем сайте без ручного добавления каждого события.
Остатки билетов. В GET /events доступны TicketCount (общее количество) и SoldTicketCount (продано). GET /events кэшируется примерно на 3 минуты. Если нужна более оперативная информация, можно использовать GET /events/{eventId}/ticket_types - для него такого кэширования нет.
Заказы и CRM. Через API можно получать данные заказов. Для расширенной информации о конкретном заказе организатора, включая дополнительные данные покупателя, предусмотрен GET /host/orders/{orderId}.
Рекламные коммуникации. Если полученные данные используются для email-, SMS- или других рекламных рассылок, необходимо учитывать передаваемый Radario признак согласия пользователя на рекламные коммуникации (isAgreeAds).
Продажа через билетного агента. API позволяет агенту получать события, типы билетов, тарифы и данные по местам. При создании заказа Radario повторно проверяет доступность места, поэтому уже занятое место повторно оформить нельзя.
API-документация
Примеры
Собственная афиша на сайте. Через GET /events можно автоматически получать данные мероприятий и использовать их на своем сайте без ручного добавления каждого события.
Остатки билетов. В GET /events доступны TicketCount (общее количество) и SoldTicketCount (продано). GET /events кэшируется примерно на 3 минуты. Если нужна более оперативная информация, можно использовать GET /events/{eventId}/ticket_types - для него такого кэширования нет.
Заказы и CRM. Через API можно получать данные заказов. Для расширенной информации о конкретном заказе организатора, включая дополнительные данные покупателя, предусмотрен GET /host/orders/{orderId}.
Рекламные коммуникации. Если полученные данные используются для email-, SMS- или других рекламных рассылок, необходимо учитывать передаваемый Radario признак согласия пользователя на рекламные коммуникации (isAgreeAds).
Продажа через билетного агента. API позволяет агенту получать события, типы билетов, тарифы и данные по местам. При создании заказа Radario повторно проверяет доступность места, поэтому уже занятое место повторно оформить нельзя.
API-ключи
Связка api-id + api-key фактически является логином и паролем для подключения.
Важно: Это чувствительная информация, которую нельзя передавать третьим лицам. Для создания такого подключения напишите напишите на help@radario.ru или в чат в личном кабинете.
Связка api-id + api-key фактически является логином и паролем для подключения.
Важно: Это чувствительная информация, которую нельзя передавать третьим лицам. Для создания такого подключения напишите напишите на help@radario.ru или в чат в личном кабинете.
Как работает Webhook
Webhook используется, когда данные должны поступить во внешнюю систему автоматически. После продажи или возврата Radario отправляет на заданный URL структурированные данные, которые система организатора может обработать.
Webhook может содержать, в частности:
– данные заказа и его статус;
– информацию о событии и билетах;
– данные покупателя;
– сумму заказа, промокод и канал продажи;
– UTM-метки и информацию о возврате;
– признак согласия на рекламные коммуникации (isAgreeAds).
Webhook может содержать, в частности:
– данные заказа и его статус;
– информацию о событии и билетах;
– данные покупателя;
– сумму заказа, промокод и канал продажи;
– UTM-метки и информацию о возврате;
– признак согласия на рекламные коммуникации (isAgreeAds).
Примеры
namespace Radario.Middleware.Notifications.Models {
public class OrderPurchaseNM {
public int Id { get; set; } — номер заказа
public string Email { get; set; } — имейл покупателя
public OrderPurchaseStatus Status { get; set; } — статус заказа
public PaymentSystemStatus PaymentSystemStatus { get; set; } — статус платежной системы
public string PaymentSystemStatusDescription { get; set; } — описание статуса ПС (платежной системы)
public string CreationDate { get; set; } — дата создания
public string PaymentDate { get; set; } — дата оплаты
public string UpdateDate { get; set; } — дата обновления
public decimal Amount { get; set; } — сумма заказа (включая все комиссии - сервисный сбор и т.д.)
public decimal HostProfit { get; set; } — размер вознаграждения за вычетом комиссии
public string PaymentType { get; set; } — тип оплаты
public string PaymentSystemOrderId { get; set; } — номер заказа из платежной системы
public string Promocode { get; set; } — промокод (если был применен)
public string DistributionType { get; set; } — канал продажи
public string Currency { get; set; } — валюта
public EventNM Event { get; set; } — событие
public UserNM User { get; set; } — пользователь
public IEnumerable<TicketNM> Tickets { get; set; } — массив билетов
public UtmDataNM UtmData { get; set; } — данные по utm меткам
public string CustomData { get; set; } — дополнительная информация
public RefundDetailsNM RefundDetails { get; set; } — детали возврата
public string RoistatVisitId { get; set; } — Id roistatvisit
public bool IsAgreeAds { get; set; } — согласие с рекламной рассылкой
}
}
public class OrderPurchaseNM {
public int Id { get; set; } — номер заказа
public string Email { get; set; } — имейл покупателя
public OrderPurchaseStatus Status { get; set; } — статус заказа
public PaymentSystemStatus PaymentSystemStatus { get; set; } — статус платежной системы
public string PaymentSystemStatusDescription { get; set; } — описание статуса ПС (платежной системы)
public string CreationDate { get; set; } — дата создания
public string PaymentDate { get; set; } — дата оплаты
public string UpdateDate { get; set; } — дата обновления
public decimal Amount { get; set; } — сумма заказа (включая все комиссии - сервисный сбор и т.д.)
public decimal HostProfit { get; set; } — размер вознаграждения за вычетом комиссии
public string PaymentType { get; set; } — тип оплаты
public string PaymentSystemOrderId { get; set; } — номер заказа из платежной системы
public string Promocode { get; set; } — промокод (если был применен)
public string DistributionType { get; set; } — канал продажи
public string Currency { get; set; } — валюта
public EventNM Event { get; set; } — событие
public UserNM User { get; set; } — пользователь
public IEnumerable<TicketNM> Tickets { get; set; } — массив билетов
public UtmDataNM UtmData { get; set; } — данные по utm меткам
public string CustomData { get; set; } — дополнительная информация
public RefundDetailsNM RefundDetails { get; set; } — детали возврата
public string RoistatVisitId { get; set; } — Id roistatvisit
public bool IsAgreeAds { get; set; } — согласие с рекламной рассылкой
}
}
{
"notification": {
"type": "OrderPurchaseNM",
"salt": "salt",
"timestamp": "2025-07-30T07:10:48.837+00:00",
"checksum": "6d47c45edd67e3d0bf9123cad36d253b83cd5eaa",
"model": {
"id": 18936747,
"email": "ellabelykh@mail.ru",
"status": "Paid",
"paymentSystemStatus": "Paid",
"paymentSystemStatusDescription": "Paid",
"creationDate": "2025-07-30T06:59:54.220+00:00",
"paymentDate": "2025-07-30T07:10:48.587+00:00",
"updateDate": null,
"amount": 40000.0000,
"hostProfit": 37400.0,
"paymentType": "AlfaBank",
"paymentSystemOrderId": "6ecfced4-7014-77e8-a040-6446996857c0",
"promocode": null,
"distributionType": "WIDGET",
"currency": "RUB",
"event": {
"id": 2482435,
"title": "МОСКВА СЛЕЗАМ НЕ ВЕРИТ",
"beginDate": "2025-08-24T15:00:00.000+00:00",
"endDate": "2025-08-24T18:00:00.000+00:00",
"imageUrl": null,
"place": {
"id": 31167,
"title": "Театр ОДЕОН",
"address": "3-я ул. Ямского Поля, 15",
"lat": 0.0,
"lng": 0.0,
"city": {
"id": 2,
"name": "Москва",
"lat": 55.7522222,
"lng": 37.6155548,
"gmtOffset": 3.0
}
},
"company": {
"id": 747340,
"title": "ОДЕОН"
},
"groupId": 30943
},
"user": {
"id": 10164714,
"name": "test",
"gender": null,
"creationDate": "2025-07-30T06:59:53.400+00:00",
"email": "test@test.ru",
"vkontakteId": null,
"facebookId": null,
"phone": "79999999999",
"unsubscribed": false
},
"tickets": [
{
"id": 45133224,
"number": "36834681",
"barcode": "112959270243",
"price": 10000.0000,
"discount": 0.0000,
"type": {
"id": 16503847,
"title": "Балкон",
"tariffTitle": "Мясное меню",
"tariffId": 2426680
},
"status": null,
"participantName": "---",
"seatInfo": "{\"rowName\":\"1\",\"colName\":\"2\",\"zoneName\":\"Стол 139\"}"
},
{
"id": 45133225,
"number": "3575854392",
"barcode": "114182254920",
"price": 10000.0000,
"discount": 0.0000,
"type": {
"id": 16504044,
"title": "Балкон",
"tariffTitle": "Рыбное меню",
"tariffId": 2426681
},
"status": null,
"participantName": "---",
"seatInfo": "{\"rowName\":\"1\",\"colName\":\"3\",\"zoneName\":\"Стол 139\"}"
},
{
"id": 45133226,
"number": "3155717158",
"barcode": "113499803191",
"price": 10000.0000,
"discount": 0.0000,
"type": {
"id": 16504044,
"title": "Балкон",
"tariffTitle": "Рыбное меню",
"tariffId": 2426681
},
"status": null,
"participantName": "---",
"seatInfo": "{\"rowName\":\"1\",\"colName\":\"4\",\"zoneName\":\"Стол 139\"}"
},
{
"id": 45133227,
"number": "2844791243",
"barcode": "112505120911",
"price": 10000.0000,
"discount": 0.0000,
"type": {
"id": 16504045,
"title": "Балкон",
"tariffTitle": "Рыбное меню",
"tariffId": 2426681
},
"status": null,
"participantName": "---",
"seatInfo": "{\"rowName\":\"1\",\"colName\":\"1\",\"zoneName\":\"Стол 139\"}"
}
],
"utmData": {
"source": "master",
"medium": "keys_odeon",
"term": null,
"content": null,
"campaign": null
},
"customData": "{}",
"refundDetails": null
}
},
"notificationType": "OrderPurchaseNM",
"recipients": [
"https://crm.by/radario/endpoint/radario.hook.php"
],
"deliveryType": "WebHook"
}
"notification": {
"type": "OrderPurchaseNM",
"salt": "salt",
"timestamp": "2025-07-30T07:10:48.837+00:00",
"checksum": "6d47c45edd67e3d0bf9123cad36d253b83cd5eaa",
"model": {
"id": 18936747,
"email": "ellabelykh@mail.ru",
"status": "Paid",
"paymentSystemStatus": "Paid",
"paymentSystemStatusDescription": "Paid",
"creationDate": "2025-07-30T06:59:54.220+00:00",
"paymentDate": "2025-07-30T07:10:48.587+00:00",
"updateDate": null,
"amount": 40000.0000,
"hostProfit": 37400.0,
"paymentType": "AlfaBank",
"paymentSystemOrderId": "6ecfced4-7014-77e8-a040-6446996857c0",
"promocode": null,
"distributionType": "WIDGET",
"currency": "RUB",
"event": {
"id": 2482435,
"title": "МОСКВА СЛЕЗАМ НЕ ВЕРИТ",
"beginDate": "2025-08-24T15:00:00.000+00:00",
"endDate": "2025-08-24T18:00:00.000+00:00",
"imageUrl": null,
"place": {
"id": 31167,
"title": "Театр ОДЕОН",
"address": "3-я ул. Ямского Поля, 15",
"lat": 0.0,
"lng": 0.0,
"city": {
"id": 2,
"name": "Москва",
"lat": 55.7522222,
"lng": 37.6155548,
"gmtOffset": 3.0
}
},
"company": {
"id": 747340,
"title": "ОДЕОН"
},
"groupId": 30943
},
"user": {
"id": 10164714,
"name": "test",
"gender": null,
"creationDate": "2025-07-30T06:59:53.400+00:00",
"email": "test@test.ru",
"vkontakteId": null,
"facebookId": null,
"phone": "79999999999",
"unsubscribed": false
},
"tickets": [
{
"id": 45133224,
"number": "36834681",
"barcode": "112959270243",
"price": 10000.0000,
"discount": 0.0000,
"type": {
"id": 16503847,
"title": "Балкон",
"tariffTitle": "Мясное меню",
"tariffId": 2426680
},
"status": null,
"participantName": "---",
"seatInfo": "{\"rowName\":\"1\",\"colName\":\"2\",\"zoneName\":\"Стол 139\"}"
},
{
"id": 45133225,
"number": "3575854392",
"barcode": "114182254920",
"price": 10000.0000,
"discount": 0.0000,
"type": {
"id": 16504044,
"title": "Балкон",
"tariffTitle": "Рыбное меню",
"tariffId": 2426681
},
"status": null,
"participantName": "---",
"seatInfo": "{\"rowName\":\"1\",\"colName\":\"3\",\"zoneName\":\"Стол 139\"}"
},
{
"id": 45133226,
"number": "3155717158",
"barcode": "113499803191",
"price": 10000.0000,
"discount": 0.0000,
"type": {
"id": 16504044,
"title": "Балкон",
"tariffTitle": "Рыбное меню",
"tariffId": 2426681
},
"status": null,
"participantName": "---",
"seatInfo": "{\"rowName\":\"1\",\"colName\":\"4\",\"zoneName\":\"Стол 139\"}"
},
{
"id": 45133227,
"number": "2844791243",
"barcode": "112505120911",
"price": 10000.0000,
"discount": 0.0000,
"type": {
"id": 16504045,
"title": "Балкон",
"tariffTitle": "Рыбное меню",
"tariffId": 2426681
},
"status": null,
"participantName": "---",
"seatInfo": "{\"rowName\":\"1\",\"colName\":\"1\",\"zoneName\":\"Стол 139\"}"
}
],
"utmData": {
"source": "master",
"medium": "keys_odeon",
"term": null,
"content": null,
"campaign": null
},
"customData": "{}",
"refundDetails": null
}
},
"notificationType": "OrderPurchaseNM",
"recipients": [
"https://crm.by/radario/endpoint/radario.hook.php"
],
"deliveryType": "WebHook"
}
CRM. После продажи или возврата данные автоматически поступают во внешнюю CRM систему без постоянного опроса API.
Уведомления. Внешняя истема может принять webhook и, например, отправить сотруднику уведомление о новом заказе.
Онлайн-контент. После подтверждения покупки внешняя система может автоматически предоставить покупателю доступ к аудио-, видео- или другому цифровому контенту.
Что важно учитывать
Для приема webhook нужен URL/endpoint внешней системы. Email-адрес для этого не подходит.
Webhook для организатора направляется на один URL. Если данные нужны нескольким системам, их можно распределить дальше на стороне организатора.
Отдельного webhook на изменение остатка билетов нет. Для получения актуальных данных об остатках используется API.
Для получения доступа к webhook напишите на help@radario.ru или в чат в личном кабинете.
Webhook для организатора направляется на один URL. Если данные нужны нескольким системам, их можно распределить дальше на стороне организатора.
Отдельного webhook на изменение остатка билетов нет. Для получения актуальных данных об остатках используется API.
Для получения доступа к webhook напишите на help@radario.ru или в чат в личном кабинете.
Что потребуется для интеграции
Техническую реализацию на стороне сайта, CRM, приложения или другой внешней системы выполняют разработчики организатора. Перед началом интеграции определите:
– какие данные необходимо получать из Radario;
– куда они должны передаваться - на сайт, в CRM, приложение или другую систему;
– как данные должны поступать: по запросу вашей системы (API) или автоматически после продажи/возврата (Webhook).
– какие данные необходимо получать из Radario;
– куда они должны передаваться - на сайт, в CRM, приложение или другую систему;
– как данные должны поступать: по запросу вашей системы (API) или автоматически после продажи/возврата (Webhook).
Если вы не уверены, какой вариант подходит под вашу задачу, опишите желаемый сценарий на help@radario.ru или в чат в личном кабинете.