Podium Sports API
Добро пожаловать в API Podium Sports. Этот документ служит введением в наш API и дополнением к нашему Документация по светофорам в котором содержится техническая информация для разработчиков о том, как осуществлять интеграцию. API Racing предлагает все данные о картах, ставках и результатах скачек Podium через RESTful API. Для данных, где время имеет большое значение, мы также предлагаем возможность получать PUSH-доставку данных о конкретном дне скачек.
Продукция и услуги:
В Podium API доступны следующие сервисы.
Ипподромные карточки:Мы разместим в API любую информацию, касающуюся будущих соревнований, как только получим ее от соответствующих органов. Это может произойти за несколько недель, а для некоторых скачек - за несколько месяцев. Как правило, мы ожидаем, что данные о картах для скачек в Великобритании и Ирландии появятся за шесть дней до 48-часового объявления. Обратите внимание, что полная разбивка точек данных в API будет представлена в приложении.
API обеспечивает глобальное покрытие гонок в Великобритании, США, Франции, Южной Африке и других странах. Полный список стран и трасс, охваченных API, приведен в Приложении A.
Карточка: API предлагает полную информацию о предстоящих встречах, включая места проведения, время забегов, заезды, лошадей, жокеев, а также дополнительную информацию о тренерах, владельцах и заводчиках.
Редакционные превью: API предлагает подробные комментарии по обеим скачкам и участвующим в них лошадям (вердикты и пинстоперы), а также советы.
Прогнозная цена: Podium будет объявлять прогнозную цену заранее, до того как шоу станут доступны, вплоть до двух дней до начала гонки.
Форма Мы предлагаем информацию о форме лошадей, жокеев и тренеров, включая информацию о карьере. Мы также предлагаем подробный отчет о последних шести скачках, в которых участвовала лошадь, через специальную конечную точку.
Шелковица Podium предоставляет доступ к нашему генератору Bombyx Silks через API, используя загрузку, связанную непосредственно с бегуном. Здесь представлены высококачественные SVG-изображения жокейских шелков, используемых в забеге. Обратите внимание, что для использования этой услуги вам необходимо пройти процедуру "белого списка", поэтому нам понадобится IP-адрес (адреса) того места, откуда вы будете получать доступ к шелку, если вы находитесь не в Великобритании.
Данные за день гонки
Расовый статус: Podium будет уведомлять вас о текущем состоянии гонки - от "спускается", "отстает" и т. д. до "выбывает" и "взвешивается". Мы также сообщим вам о любых проблемах после гонки или изменениях в результатах.
Ставки: В день скачек Podium будет публиковать обновленные цены на всех участвующих в скачках лошадей, начиная с шоу открытия и заканчивая SP. Мы будем обновлять цены в преддверии старта, а после начала забега сразу же подтвердим SP для лошади. Как правило, ставки начинают появляться примерно за 15 минут до начала забега.
Результаты: По завершении забега вы сможете получить доступ к результатам. Опять же, в зависимости от разрешений и территории, они также будут включать комментарии крупным планом, как только станут доступны. Изменения в составе лошадей и жокеев: Любые изменения в составе бегунов и наездников будут опубликованы как только
по мере поступления.
Комментарий: Комментарии после гонки (крупным планом) будут доступны после заселения
Структура API
Наш API имеет полностью документированный Stoplight, который содержит подробную информацию о
структура конечных точек, формат данных и фильтры, используемые в каждом конкретном случае
конечная точка для ограничения данных. Это доступно здесь.
- Наш API построен в виде иерархической структуры, в которой конечная точка этапов списка находится на самом верху
иерархия
Я могу получить список событий (гонок) и связанные с ними данные (т.е. ход, призы),
статус) из конечной точки "Этапы (встречи) - Я могу получить список участников (лошадей) и связанные с ними данные (т.е. ставки, результаты),
форма и т.д.) из конечной точки событий (гонок) - Я могу получить список участников (тренеров, жокеев и других лошадей).
информация) от конечной точки "абитуриенты (лошади)
Однако, получив идентификатор этапа, вы также можете получить все, что относится к этапам, из
конечной точке подробной информации о сцене. Это чрезвычайно многословные ответы (более 20 тысяч строк для
встреча), поэтому их нужно разобрать, чтобы найти нужные данные. Время отклика может
Поэтому объем данных может сказаться.
(Эта структура также применима к мероприятиям, участникам и заявителям)
- Этапы : Конечная точка "Этапы" представляет собой высокоуровневую сводку всех гонок.
происходящих в определенном окне данных. Это должно быть настроено с помощью
поля 'from' и 'to' в запросе API. Мы также предлагаем возможность возвращать
конкретной страны с помощью фильтра 'countrycodes' (все коды, доступные в
страны), а также возможность поиска определенных курсов с помощью
Термин "запрос".
o Ваш ответ вернет идентификатор сцены, информацию о месте проведения и список
событий (гонок) на каждом этапе (встрече).
o Мы также включаем некоторые краткие метаданные по каждому событию.
События: Конечная точка Events предназначена для возврата конкретной информации обо всех
гонки в указанном диапазоне дат. Эти данные не включают информацию о стадиях
(т.е. место проведения), но будет включать в себя название гонки, статус гонки,
призовой фонд, доступный для гонки, и время начала гонки. Мы также проводим
информация о классе скачек, о том, как они проходят, по трамплинам или по равнине,
расстояние и тип поверхности.
o В нем содержится список участников, номер их кабинки и ткани, а также их статус.
как активный участник гонки или как не участвующий в ней.
o В нем содержится шелк для каждой лошади.
o После завершения события будут также дополнены временными метками для
изменения состояния во время гонки (например, время отбоя, время взвешивания)
Чтобы получить следующие наборы данных, необходимо опросить конечную точку DETAILS
- Дивиденды от гонок (CSF, трикасты, тотализатор, эксекта, трифекта)
- Советы
- Призовой фонд
- Дополнительный контент (комментарии к скачкам, комментарии Timeform, статистика Timeform Smart)
Мы также предлагаем просмотр обновлений гонок, чтобы пользователь мог вернуть предыдущих победителей.
- Например, Qipco Sprint Stakes в Аскоте в 2024 году имеет uuid события
291d3994-f3ca-4774-8fc2-17802505c083 .
o Это можно запросить на {{$baseURL}}/events/291d3994-f3ca-4774-8fc2-
17802505c083/winners, который возвращает Art Power в качестве победителя в 2023 году.
- Entrants: Entrants требует, чтобы вы вернули заданный uuid события, а затем будет
возвращает всех лошадей, участвующих в этом событии. Так, например, UUID
73751e7f-4edf-4226-b1bf-62c16b0a6e0d (Fairyhouse, IRE, 1 декабря 2024).
возвращает список лошадей, участвующих в этом соревновании, вспомогательную информацию и высокий уровень
информацию о жокее, тренере и владельце. Вы также получите
o Рейтинги (официальные и Timeform)
o Все коэффициенты, созданные для участника в течение гонки
o Различные метаданные об участнике, включая пройденное расстояние, форму
строка, вес, дни с момента последнего запуска
o Финишная позиция или статус, если вы не финишировали (т.е. упали, дисквалифицированы, выбыли из игры).
всадник и т.д.).
o Данные об участниках высокого уровня, такие как жокей, тренер, владелец, заводчик
o Данные участника о лошади, такие как возраст, история карьеры, пол, цвет кожи.
и призовой фонд.
o Родословная
- Анкета участника - чтобы увидеть (вплоть до) последние шесть скачек, в которых участвовала лошадь, вы можете
используйте конечную точку участника с квалификатором /form, чтобы получить предыдущие результаты.
o Так, для uuid абитуриента f5158412-7356-42a1-ac5d-763b787657a2 (End Zone) это
предыдущие заезды можно получить, отправив {{$baseURL}}/entrants/f5158412-
7356-42a1-ac5d-763b787657a2/form
- Участники Участники охватывают все организации, связанные с лошадьми. Так что в данном случае,
Участники также получат информацию о жокее, владельце и тренере, а также
а также сама лошадь. Эти данные должны быть продублированы в сведениях об участнике
конечная точка.
Пересмотр
Мы ввели концепцию конечных точек "истории" в нашу сборку, чтобы вы могли
изучить историю обновлений места, сцены, события, конкурсанта или участника. Каждый
Обновления, которые мы вносим в сущность в нашей БД, сохраняются и доступны для возврата.
- Формат любого запроса - {{базовый URL}}/ ENDPOINT / uuid / history
- Итак, для данного этапа формат: /stages/uuid/history
o Это позволит получить полную историю всех обновлений данных для собрания. Примечание
это может стать серьезным ответом. Лестер на 1 декабря 2024 года - это
165 тыс. строк JSON и 400 КБ.
- Для данного события, events/uuid/history
o Это полезно для просмотра изменений в статусе, обновления ставок или
специфическое обновление
- Для данного абитуриента, entrants/uuid/history (обратите внимание, что это отличается от формы)
o это полезно для проверки коэффициентов для конкретного абитуриента
- Для участника participants/uuid/history (это должно обновляться после каждого забега)
o Это можно использовать для создания истории карьеры лошади по скачкам.
или жокей
Малые конечные точки
Мы также имеем несколько незначительных конечных точек, раскрывающих наборы данных, используемые в других ответах. Мы делаем
Не ожидайте, что вам придется обращаться к ним регулярно.
- Страна : Список всех стран, их часовых поясов и соответствующих валют.
Обратите внимание, что появление той или иной страны в этом списке не означает, что мы осуществляем
информация о гонках. Основным вариантом использования будет получение кода
необходимые для фильтрации стран в конечной точке этапов.
- Валюта : Информация обо всех валютах, присутствующих в API
- Поверхность: Эта конечная точка предоставляет список всех типов поверхностей, присутствующих в API
- Спорт: В настоящее время это касается только скачек.
Обратите внимание, что ответ по всем конечным точкам может быть отфильтрован, чтобы вернуть только точки данных
которые вас интересуют. Более подробно это описано в Приложении D - фильтры полей
Подключение к API
У нас есть коллекция POSTMAN, чтобы упростить обращение к API. Если у вас есть
не была предоставлена, ее можно запросить. Мы также можем предоставить файл окружения
с предварительно заполненными учетными данными.
Доступ к API предоставляется через запрос 'get token', который позволяет получить доступ на 30
минуты. API работает на основе базовой авторизации (в Postman - выберите вызов, выберите
авторизация, выберите basic auth) - вам нужно будет ввести имя пользователя / пароль
учетные данные, которые вам предоставил Podium. Обратите внимание, что вы можете задать их как
по умолчанию, используя вкладку окружения для предварительного заполнения (и маскировки) учетных данных доступа
Обратите внимание, что API имеет ограничение на возврат 6 МБ. Если вы превысите это значение, то получите уведомление
внутренняя ошибка сервера. Используйте фильтр pagesize, чтобы ограничить возврат страницы до 1, и посмотрите, не произойдет ли при этом
решает эту проблему.
Кэширование
Чтобы оптимизировать работу API и снизить нагрузку на нашу инфраструктуру, мы используем
механизмы кэширования. С помощью Amazon ElastiCache мы храним часто запрашиваемые данные.
данные в памяти, что позволяет ускорить их поиск и сократить потребность в получении тех же данных
неоднократно. Эта стратегия кэширования повышает общую отзывчивость и масштабируемость.
нашего API.
Мы ожидаем, что кэшированные ответы будут возвращаться в течение 40-60 мс.
Ответы без кэша могут занимать до нескольких секунд в зависимости от размера
ответ.
Наш API поддерживает ответы размером до 6 МБ.
Техническая поддержка и документация
Как уже говорилось ранее, у нас есть Стоп-сигнал за помощь в работе с API.
В случае, если API не работает, или есть проблемы с данными, которые передаются
Получен, пожалуйста, свяжитесь с нами:
Стив Уайтхед
- Электронная почта: Steve.whitehead@podiumsports.com
и
Уильям Гибсон
- Электронная почта: Уильям. gibson@pamediagroup.com
Мы надеемся, что этот вводный документ поможет вам начать работу с Podium API. Мы
мы рады вашему появлению и с нетерпением ждем возможности поработать с вами над вашей лошадью
гоночная интеграция. В случае возникновения каких-либо проблем, не стесняйтесь связаться с нами, так как мы
Мы хотели бы узнать, как вы используете API.
Приложение A - Список стран
Страны, доступные в API
ВЕЛИКОБРИТАНИЯ
Ирландия
Япония
США
Франция
Южная Африка
Чили
Бразилия
Индия
Гонконг
Саудовская Аравия
Уругвай
Приложение B - Данные PUSH
Для критически важных по времени услуг наши данные PUSH позволяют предоставлять небольшие фрагменты данных для
клиентов для интеграции с их общим набором данных.
Следующие данные доступны через систему PUSH
Событие Условия (погодные условия для гонки, а не для встречи)
Событие Дивиденды (тотализатор, CSF, трикаст, трифекта и т.д.)
Абитуриент : Движение ставок (советы по крупным ставкам или комментарии по движению ставок,
например, "открыто по 28/1)
Участник: Крупный план (редакционный комментарий после скачек, описывающий выступление лошади)
Участник Вес жокея (вес, заявленный жокеем)
Entrant : Non-Runner (уведомление о том, что лошадь теперь не участвует в соревнованиях)
Участник Восстановить (не участвующий в забеге был восстановлен и теперь будет участвовать в забеге)
Участник Результат (финишная позиция лошади)
Участник : Выставки (обновление коэффициентов на лошадей)
Абитуриент: Стартовые цены (подтверждение цены лошади на старте)
Entrant : Withdrawn (лошадь была снята с соревнований)
Событие Вычет (уведомление о том, что доходы будут уменьшены после снятия или
изменение результата)
Событие Рынок возобновлен (рынок ставок снова открыт)
Событие Рынок приостановлен (рынок ставок был приостановлен)
Событие Коррекция времени отключения (отправлено обновленное время отключения)
Событие : Статус (изменение статуса гонки, например, из бездействующей, в падающую, в
выключить, закончить)
Событие : Стюарды (проводится расследование стюардами результатов гонки)
Событие Время победы (время, затраченное победителем гонки от старта до финиша)
Этап : Условия (условия проведения встречи - погода и состояние
земля)
Этап : Дивиденды (дивиденды, связанные с достижением уровня результатов, т.е. джекпот)
Стадия : Статус (статус встречи)
Приложение C - Настройка PUSH
Сервис PUSH призван дополнить остальной API. В Raceday пользователь может выбрать
чтобы получать обновления через нашу службу доставки AWS SNS PUSH.
Это сделано для того, чтобы максимально ускорить процесс генерации и доставки критически важной информации в день гонки.
данные.
В то время как пользователь может решить опрашивать API несколько раз в секунду, чтобы сохранить свой
PUSH предлагает возможность получать только обновления основных данных.
а не разбирать длинные строки данных.
Важно отметить, что пользователю необходимо получить данные карты из REST API.
Мы не предоставляем полные данные карты через PUSH, чтобы минимизировать полезную нагрузку данных и
задержка.
Более подробную информацию о форматах сообщений можно найти в Приложении B, но важно, чтобы
обратите внимание, что мы отправим вам обновленное (или новое) значение данных, а также достаточное количество
справочные данные, чтобы связать их с соответствующим этапом, мероприятием или участником. Мы не отправляем
предыдущее значение.
В любой момент во время Raceday клиент может повторно обратиться к REST API, чтобы обновить информацию.
свой набор данных или повторно синхронизируются с официальной версией правды Podium. Каждое обновление PUSH
отражается в наборе данных в REST API, а с помощью конечных точек ревизии он
возможность увидеть, когда было создано обновление
Настройка
Настройка сервиса PUSH автоматизирована на стороне Podium. Когда мы подключим вас к
PUSH, мы запускаем процесс создания стека AWS, в результате чего у вас появляется SNS для подключения
на который вы можете получать сообщения. В этом SNS будет отражаться ваш договор
права на данные, поэтому, например, если вы возьмете данные по Великобритании, но не по Франции, вы получите только
получать соответствующие данные о ГБ на SNS.
Нам требуется ваш AWS IAM, чтобы вы могли получить доступ к создаваемой нами среде. Это
надежно хранится в нашей базе данных прав.
PUSH data stubs example SHOWS
Наши службы PUSH отправляют минимальные элементы данных, которые предназначены для обновления
элементы полного набора данных, которые вы получаете
Ставочные шоу
"body": “[{\”correlationId\”:\”4afbeb86-4aa6-483a-937a-
41d4a1ad6ed9\”,\”features\”:[\”BETTING_SHOWS\”],\”message\”:\”{\\\”id\\\”:\\\”4afa5384-b4bc-4951-
9ad3-1d35a6742cbc\\\”,\\\”type\\\”:\\\”event\\\”,\\\”entrants\\\”:[{\\\”id\\\”:\\\”30fb7908-3208-48bb-
9b59-
f9da8b9480ed\\\”,\\\”type\\\”:\\\”entrant\\\”,\\\”betting\\\”:{\\\”shows\\\”:[{\\\”marketnumber\\\”:1,\\\”
price\\\”:{\\\”decimal\\\”:200,\\\”denominator\\\”:1,\\\”numerator\\\”:200},\\\”created\\\”:\\\”2024-12-
12T17:50:46.618Z\\\\\"}]}}]}\\"}]]В этом примере
Обратите внимание, что в элементе features тип сообщения объявлен как BETTING_SHOWS.
Первой значимой информацией в сообщении является
\”message\”:\”{\\\”id\\\”:\\\”4afa5384-b4bc-4951-9ad3-1d35a6742cbc\\\”,\\\”type\\\”:\\\”event\\\”
Это сообщит нам UUID события, на которое ссылаются, в данном случае 4afa5384-b4bc-.
4951-9ad3-1d35a6742cbc.
({{$baseURL}}/events/4afa5384-b4bc-4951-9ad3-1d35a6742cbc)
Это 18:00 в Челмсфорд Сити 12 декабря 2025 года.
Следующая важная информация
“entrants\\\”:[{\\\”id\\\”:\\\”30fb7908-3208-48bb-9b59-f9da8b9480ed\\\
({{$baseURL}}/entrants/30fb7908-3208-48bb-9b59-f9da8b9480ed)
Это говорит нам о том, что лошадь, которую возвращают, - это Pink Petunia в забеге выше.
- Обратите внимание, что обновление может касаться более чем одного участника
Последним ключевым элементом информации является фактическая полезная нагрузка на абитуриента, которая составляет
\\\”betting\\\”:{\\\”shows\\\”:[{\\\”marketnumber\\\”:1,\\\”price\\\”:{\\\”decimal\\\”:200,\\\”denominato
r\\\”:1,\\\”numerator\\\”:200}
Здесь вы можете видеть, что мы отправили обновление ставок, и новые шоу (оба десятичные
и дробные) доступны в сообщении PUSH.
Если отправляется несколько участников, данные отправляются в формате "участник / шоу / участник / шоу".
в формате, как в этом примере
"body": “[{\”correlationId\”:\”18d28297-0211-4d4b-ac3f-
ae70ab8e7b74\”,\”features\”:[\”BETTING_SHOWS\”],\”message\”:\”{\\\”id\\\”:\\\”646f1b6a-f681-4334-
b54c-c2f50b7a144f\\\”,\\\”type\\\”:\\\”event\\\”,\\\”entrants\\\”:[{\\\”id\\\”:\\\”e3304cb4-9158-4b49-
8e78-
cacd60e8b370\\\”,\\\”type\\\”:\\\”entrant\\\”,\\\”betting\\\”:{\\\”shows\\\”:[{\\\”marketnumber\\\”:1,\\\”
price\\\”:{\\\”decimal\\\”:28,\\\”denominator\\\”:1,\\\”numerator\\\”:28},\\\”created\\\”:\\\”2024-12-
12T17:20:33.137Z\\\”}]}},{\\\”id\\\”:\\\”11bae700-c6e5-4987-a558-
67fac5e503b3\\\”,\\\”type\\\”:\\\”entrant\\\”,\\\”betting\\\”:{\\\”shows\\\”:[{\\\”marketnumber\\\”:1,\\\”
price\\\”:{\\\”decimal\\\”:150,\\\”denominator\\\”:1,\\\”numerator\\\”:150},\\\”created\\\”:\\\”2024-12-
12T17:20:33.137Z\\\”}]}}]}\”}]”,
Пример заглушки данных PUSH - STATUS
Это пример изменения статуса, в данном случае говорится, что гонка закончилась.
“[{\”correlationId\”:\”76b23408-2e0e-4612-b8f6-7c7116a27dbb\”,\”features\”:[],\”message\”:\”{\\\”id\\\”:\\\”c4c30487-1ee9-4864-886a11516985cefe\\\”,\\\”type\\\”:\\\”event\\\”,\\\”finished\\\”:\\\”2024-12-
12T17:03:32.995Z\\\”,\\\”status\\\”:\\\”finished\\\”,\\\”meta\\\”:{\\\”event:status:finished:timestamp\\\”:{\\\”code\\\”:\\\”event:status:finished:timestamp\\\”,\\\”value\\\”:\\\”2024-12-12T17:03:32.995Z\\\"}}}\"}]"
Для отображения мы предоставляем идентификатор события c4c30487-1ee9-4864-886a-11516985cefe, которое состоится в 17:00 в Челмсфорде 12 декабря 2024 года.
Это сообщение указывает, что гонка была отмечена как завершенная, и содержит временную метку, когда это произошло.
Это отбой для 6:00 вечера в Челмсфорде, который имеет идентичный формат, за исключением того, что статус "отбой", а связанная с ним временная метка имеет другое название.
“[{\”correlationId\”:\”23b2508d-26a7-463a-8458-405c4b206830\”,\”features\”:[],\”message\”:\”{\\\”id\\\”:\\\”4afa5384-b4bc-4951-9ad3-1d35a6742cbc\\\”,\\\”type\\\”:\\\”event\\\”,\\\”offtime\\\”:\\\”2024-12-
12T18:01:17.117Z\\\”,\\\”status\\\”:\\\”off\\\”,\\\”meta\\\”:{\\\”event:status:off:timestamp\\\”:{\\\”code\\\”:\\\”event:status:off:timestamp\\\”,\\\”value\\\”:\\\”2024-12-12T18:01:17.117Z\\\"}}}\"}]"
Пример заглушки данных PAGE - GOING / WEATHER
В этом примере показано обновление погоды/события.
[{\”correlationId\”:\”7ef44900-2c46-48dd-b289-4096bb0b7437\”,\”features\”:[],\”message\”:\”{\\\”id\\\”:\\\”c4c30487-1ee9-4864-886a11516985cefe\\\”,\\\”type\\\”:\\\”event\\\”,\\\”meta\\\”:{\\\”event:going\\\”:{\\\”code\\\”:\\\”event:going \\\”,\\\”value\\\”:\\\”standard\\\”},\\\”event:weather\\\”:{\\\”code\\\”:\\\”event:weather\\\”,\\\”value\\\”:
В данном случае идентификатор события - c4c30487-1ee9-4864-886a-11516985cefe, это 5 вечера в Челмсфорде 12 декабря 2024 года.
В этом сообщении говорится, что событие перешло в разряд стандартных, а погода обновлена до Light Rain Showers.
Приложение D - фильтры полей
Эти возможности более подробно описаны в нашем стоп-сигнал в разделе параметров запроса каждой конечной точки, но API предоставляет возможность возвращать подмножества полей, доступных в конечной точке, или искать определенные строки данных в API.
Например, в конечной точке заведения вас могут интересовать только идентификаторы треков и их название. Поэтому, задав в POSTMAN запрос 'fields' на 'id,name' (знаки речи не нужны), вы получите список всех площадок в системе, с их UUID и названием.
{{$baseURL}}/venues?fields=id,name
Это позволит получить список всех заведений в системе.
Однако если вы хотите увидеть страну, к которой принадлежит трек, и расширяете список полей, чтобы включить его ({{$baseURL}}/venues?fields=id,name,country) = вы заметите, что мы возвращаем ВСЕ данные по конечной точке country, что не имеет смысла.
Чтобы ограничить возврат данных во вложенной конечной точке, необходимо убедиться, что у вас включена кодировка URL, а затем отправить следующую строку {{$baseURL}}/venues?fields=id,name,country{name,code}, которая вернет название трека, его идентификатор, страну, в которой находится трек, и место, где он расположен
Допустим, вы хотите отфильтровать треки на определенной территории? В настоящее время вы можете искать по коду страны или по countryid (фильтрация по названию в настоящее время недоступна)
{{$baseURL}}/venues?fields=id,name,country{name,code}&countrycodes=UK
Этот запрос вернет идентификатор и название всех треков, хранящихся в системе для Великобритании
{{$baseURL}}/venues?fields=id,name,country{name,code,timezones,id}&countryids=b1 8b2ec5-f60e-4255-bf12-5c258c223d5d&pagesize=25
Таким образом, этот запрос вернет id и название места проведения мероприятия, а также имя, код, часовой пояс и ID для ID в запросе (которым оказалась Англия). Это также устанавливает количество результатов, возвращаемых по запросу, равным 25, а не 10 по умолчанию.
STAGES - примеры фильтров полей
Стадии конечной точки
Я хочу просто видеть место проведения, названия гонок и время старта.
{{$baseURL}}/stages?fields=id,name,start,end,events[]{id,title,start}&from=2024-12-04&to=2024-12 04&countrycodes=UK&pagesize=10
возвращает (для краткости это частичный ответ)
"Размер страницы": 10,
"Всего": 4,
"filters": {
"from": "2024-12-04",
"to": "2024-12-04",
"fields": "id,name,start,end,events[]{id,title,start}",
"countrycodes": [
"ВЕЛИКОБРИТАНИЯ"
]
},
"items": [
{
"id": “50adf989-535e-434d-b32a-e8d4c86d0252”,
"name": "Lingfield",
"начало": “2024-12-04T11:20:00.000Z”,
"end": “2024-12-04T15:25:00.000Z”,
"events": [
{
"id": “80335f1d-0264-4339-88d1-15f7c643d799”,
"title": "Выиграйте 1 млн с гандикапом на золотые голы от BetMGM",
"start": “2024-12-04T11:20:00.000Z”
},
{
"id": “c6b595d4-efbd-40d5-a635-446e9f0cf7e6”,
"title": "BetMGM: Питомник Showtime",
"start": “2024-12-04T11:50:00.000Z”
},
{
"id": “5b2fd2f7-946e-41ea-a33c-a28f0ec7f1d9”,
"title": "Играйте ответственно на BetMGM/ EBF Fillies' Novice Stakes (GBB Race) (Div 1)",
"start": “2024-12-04T12:20:00.000Z”
Я хочу видеть информацию о сцене и связанные с ней метаданные (например, время проведения, погода и преимущество ничьей), но информация, возвращаемая в метазаглушке, недоступна для фильтрации.
{{$baseURL}}/stages?from=2024-12-04&to=2024-12-04&countrycodes=UK&pagesize=10&fields=id,name,start,end,meta
возвращает такой ответ
"filters": {
"from": "2024-12-04",
"to": "2024-12-04",
"fields": "id,name,start,end,meta",
"countrycodes": [
"ВЕЛИКОБРИТАНИЯ"
]
},
"items": [
{
"id": “50adf989-535e-434d-b32a-e8d4c86d0252”,
"name": "Lingfield",
"начало": “2024-12-04T11:20:00.000Z”,
"end": “2024-12-04T15:25:00.000Z”,
"meta": {
"stage:going": {
"code": "stage:going",
"значение": "стандарт"
},
"stage:weather": {
"code": "stage:weather",
"значение": "Mostly Cloudy".
},
"stage:drawadvantage": {
"code": "stage:drawadvantage",
"Значение": "Небольшой эффект".
},
"stage:going:description": {
"code": "stage:going:description",
"значение": null
}
}
Я хочу видеть список гонок и их текущий статус, а также время старта и финиша.
{{$baseURL}}/stages?from=2024-12-04&to=2024-12-04&countrycodes=UK&pagesize=10&query=Kempton&fields=id,name,start,end,events[]{start,status,finished,offftime}
"items": [
{
"id": “abd95869-59cc-496e-b9d6-bb48520b9fa6”,
"name": "Кемптон",
"начало": “2024-12-04T16:10:00.000Z”,
"end": “2024-12-04T20:10:00.000Z”,
"events": [
{
"начало": “2024-12-04T16:10:00.000Z”,
"status": "HORSE_RACING_EVENT_WEIGHED_IN",
"finished": “2024-12-04T16:11:58.000Z”,
"offtime": “2024-12-04T16:10:29.000Z”
},
{
"начало": “2024-12-04T16:40:00.000Z”,
"status": "HORSE_RACING_EVENT_WEIGHED_IN",
"finished": “2024-12-04T16:45:00.000Z”,
"offtime": “2024-12-04T16:43:46.000Z”
},
{
"начало": “2024-12-04T17:10:00.000Z”,
"status": "HORSE_RACING_EVENT_WEIGHED_IN",
"finished": “2024-12-04T17:12:44.000Z”,
"offtime": “2024-12-04T17:11:30.000Z”
},
{
"начало": “2024-12-04T17:40:00.000Z”,
"status": "EVENT_RESULT",
"finished": “2024-12-04T17:43:56.000Z”,
"offtime": “2024-12-04T17:43:56.000Z”
},
{
"начало": “2024-12-04T18:10:00.000Z”,
"status": "EVENT_OVERNIGHT",
"закончен": null,
"offtime": null
},
{
"начало": “2024-12-04T18:40:00.000Z”,
"status": "EVENT_OVERNIGHT",
"закончен": null,
"offtime": null
},
{
"начало": “2024-12-04T19:10:00.000Z”,
"status": "EVENT_OVERNIGHT",
"закончен": null,
"offtime": null
},
{
"начало": “2024-12-04T19:40:00.000Z”,
"status": "EVENT_OVERNIGHT",
"закончен": null,
"offtime": null
},
{
"начало": “2024-12-04T20:10:00.000Z”,
"status": "EVENT_OVERNIGHT",
"закончен": null,
"offtime": null
}
СОБЫТИЯ - Примеры полевого фильтра
Я хочу видеть простой список участников каждого забега.
{{$baseURL}}/events?from=04-12-2024&to=04-12-2024&fields=id,title,stageeventnumber,start,entrants[]{id,name,entrantnumber,stallnumber,status}&stageids=abd95869-59cc-496e-b9d6-bb48520b9fa6
Это для Кемптона 4 декабря 2024 года.
NB Рекомендуется указывать идентификатор этапа в запросе на мероприятие, чтобы вы могли быть уверены в том, что запрашиваете именно это собрание.
id": “6af09a35-bcae-4013-8168-9e2626bb6821”,
"title": "Unibet Zero% Mission Handicap",
"stageeventnumber": 8,
"начало": “2024-12-04T19:40:00.000Z”,
"entrants": [
{
"id": “49cac5dd-d7c3-4f0a-88d8-99b445d848f0”,
"name": "Альпийская прогулка",
"entrantnumber": 1,
"stallnumber": 12,
"status": "RUNNER"
},
{
"id": “8ee130ee-8d36-4614-afee-ec8347cae7e9”,
"name": "Eton Blue",
"entrantnumber": 2,
"stallnumber": 5,
"status": "RUNNER"
},
{
"id": “643ace81-e7a4-4d9f-85ab-4b55871a444b”,
"name": "Silver Nightfall",
"entrantnumber": 3,
"stallnumber": 9,
"status": "RUNNER"
},
{
"id": “fbd27e5f-604c-491d-94b7-ed198716f308”,
"name": "Sgian Dubh",
"entrantnumber": 4,
"stallnumber": 6,
"status": "RUNNER"
},
{
"id": “3a45c37d-3966-494f-929b-9af650ff5e3d”,
"name": "Bohemian Breeze",
"entrantnumber": 5,
"stallnumber": 7,
"status": "RUNNER"
},
{
"id": “5825afa8-89e9-4394-ac2c-1106527a7306”,
"name": "Birthday Angel",
"entrantnumber": 6,
"stallnumber": 10,
"статус": "DOUBTFUL"
},
{
"id": “07d6b012-6458-4cd1-9972-c964487326f2”,
"name": "Шамардаль Стар",
"entrantnumber": 7,
"stallnumber": 8,
"status": "RUNNER"
},
{
"id": “be54bc6e-ffc8-417c-ac60-74abadd6a3de”,
"name": "Освобожденный Лад",
"entrantnumber": 8,
"stallnumber": 3,
"status": "RUNNER"
},
{
"id": “d4246b68-e4c2-4104-9684-e81117988e42”,
"name": "Tortured Soul",
"entrantnumber": 9,
"stallnumber": 1,
"status": "RUNNER"
},
{
"id": “b505b52d-c6e7-43de-a5f0-f8934675401c”,
"name": "Последняя императрица",
"entrantnumber": 10,
"stallnumber": 11,
"status": "RUNNER"
},
{
"id": “6d1270da-0273-4a87-b256-098c6d0136a7”,
"name": "Синий воротничок",
"entrantnumber": 11,
"stallnumber": 4,
"status": "RUNNER"
},
{
"id": “fa1eea5f-806c-47be-8d5c-712db1ee8f04”,
"name": "Meisterzinger",
"entrantnumber": 12,
"stallnumber": 2,
"status": "RUNNER"
}
]
Я хочу легко получить описание шелка и URL-адрес для бегунов в забеге.
{{$baseURL}}/events?from=04-12-2024&to=04-12-2024&fields=id,title,stageeventnumber,start,entrants[]{id,name,associations[]{renditions{original{href, sourceText}}}}&stageids=abd95869-59cc-496e-b9d6-bb48520b9fa6
Частичный ответ для краткости
"filters": {
"from": "04-12-2024",
"to": "04-12-2024",
"fields":
"id,title,stageeventnumber,start,entrants[]{id,name,associations[]{renditions{original{href,sourceText}}
}}”,
"stageids": [
“abd95869-59cc-496e-b9d6-bb48520b9fa6”
]
},
"items": [
{
"id": “dbc87146-8263-4d1a-944c-f9e85e266fcb”,
"title": "Попробуйте новую акцию Unibet, увеличивающую гандикап",
"stageeventnumber": 9,
"начало": “2024-12-04T20:10:00.000Z”,
"entrants": [
{
"id": “977e3d61-fccd-4670-9c2d-44dc9f21f537”,
"name": "Символ надежды",
"associations": [
{
"renditions": {
"original": {
"href": "https://bombyx.api.press.net/v1/bombyx/silk/f6d0989c-9f03-a14e-6498-8b4a1fe8cdfe",
"sourceText": "Желтый, темно-синий ромб, шевроны на рукавах, темно-синяя кепка, желтый ромб".
}
}
}
]
},
{
"id": “168aae24-fb52-44e1-a5d9-9e3f8e45ffec”,
"name": "Большой Бард",
"associations": [
{
"renditions": {
"original": {
"href": "https://bombyx.api.press.net/v1/bombyx/silk/d6b426c6-3851-ad96-ecbe4b3fb2c2d1c8",
"sourceText": "Желтый, розовые швы, желтые рукава и шапочка".
}
}
}
]
},
{
"id": “b25186df-3e39-4fb2-ac4b-8728f23195e5”,
"name": "Brunel Charm",
"associations": [
{
"renditions": {
"original": {
"href": “https://bombyx.api.press.net/v1/bombyx/silk/0fb840c3-41e0-36d5-da47-7a656cc9b39b”,
"sourceText": "Бордовый, изумрудно-зеленые звезды, рукава и звезда на кепке".
}
}
}
]
},
ENTRANTS - примеры фильтра по полям
Я хочу видеть каждое обновление ставки, полученное бегуном в забеге
{{$baseURL}}/entrants/dd06959e-4090-45d8-91f7-42d12a12baf2?pagesize=25&fields=id,name,betting
Отклик (возвращает прогнозную цену, показывает и SP)
{
"id": “dd06959e-4090-45d8-91f7-42d12a12baf2”,
"name": "Песчаная Газель",
"Ставки": {
"прогноз": {
"цена": {
"decimal": 6,
"числитель": 6,
"знаменатель": 1
}
},
"shows": [
{
"marketnumber": 1,
"created": “2024-12-04T16:02:34.000Z”,
"цена": {
"decimal": 16,
"числитель": 16,
"знаменатель": 1
}
},
{
"marketnumber": 1,
"created": “2024-12-04T16:00:33.000Z”,
"цена": {
"decimal": 14,
"числитель": 14,
"знаменатель": 1
}
},
{
"marketnumber": 1,
"created": “2024-12-04T16:00:00.000Z”,
"цена": {
"decimal": 12,
"числитель": 12,
"знаменатель": 1
}
},
{
"marketnumber": 1,
"created": “2024-12-04T16:05:57.000Z”,
"цена": {
"decimal": 18,
"числитель": 18,
"знаменатель": 1
}
},
{
"marketnumber": 1,
"created": “2024-12-04T16:06:33.000Z”,
"цена": {
"decimal": 16,
"числитель": 16,
"знаменатель": 1
}
},
{
"marketnumber": 1,
"created": “2024-12-04T16:06:54.000Z”,
"цена": {
"decimal": 18,
"числитель": 18,
"знаменатель": 1
}
},
{
"marketnumber": 1,
"created": “2024-12-04T16:09:46.000Z”,
"цена": {
"decimal": 20,
"числитель": 20,
"знаменатель": 1
}
}
],
"startingprice": {
"цена": {
"decimal": 20,
"числитель": 20,
"знаменатель": 1
},
"marketposition": null,
"marketcount": null
}
}
}