BreakingBet API

RU

EN

RU

EN

Appearance

Общий порядок работы с API ​

Для всех типов данных (вилки, коридоры, валуи) порядок взаимодействия с API имеет общую последовательность:

Шаг 1. Получение ключей доступа ​

В личном кабинете на сайте breaking-bet.com необходимо получить ключи доступа:

  • access_key
  • access_secret_key

Важно

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

Шаг 2. Получение Access Token ​

Данные реквизиты используются для автоматизированного получения короткоживущего access token.

Для этого необходимо послать запрос следующего вида:

bash
curl https://breaking-bet.com/access_keys/{YOUR_ACCESS_KEY}/access_tokens \
  -H 'Authorization: ApiKey {YOUR_SECRET_KEY}' \
  -d '{"service": "arbs_prematch"}'

Вместо arbs_prematch можно указать другой тип данных, в зависимости от того, что именно интересует:

  • arbs_prematch - для вилок prematch
  • arbs_live - для вилок live
  • middles_prematch - для коридоров prematch
  • middles_live - для коридоров live
  • valuebets_prematch - для ставок с перевесом prematch
  • valuebets_live - для ставок с перевесом live

Полученный Access token используется для обращения к одному из Data API и получения данных.

Срок жизни токена

Срок жизни access token ограничен 5 минутами и должен регулярно обновляться, как это описано на шаге №2.

Шаг 3. Создание фильтра ​

Для получения непосредственно искомых данных нужно сначала сконфигурировать фильтр, настройки которого определят критерии отбора вилок, валуе и коридоров.

Каждому типу данных соответствует свой API. Например, для создания фильтра вилок необходимо послать запрос вида:

bash
POST https://arbs.prematch.api.breaking-bet.com/filters/bb-{YOUR_ACCESS_KEY}

Более детально о том, как подготовить подобный запрос вы сможете узнать на соответствующих страницах данного руководства в разделе Data APIs.

Шаг 4. Получение данных ​

После создания фильтра можно начинать получать из него искомые данные:

bash
POST https://arbs.prematch.api.breaking-bet.com/filters/bb-{YOUR_ACCESS_KEY}/items

Детально о параметрах и форматах ответов подобных запросов вы так же можете узнать на соответствующих страницах.

Шаг 5. Расшифровка ID с помощью Dictionaries API ​

Данные, отдаваемые через DataApi часто содержат ID тех или иных сущностей — названий видов спорта, букмекеров, видов исходов и т.д.

Для того чтобы расшифровать эти ID и получить человекочитаемые названия, необходимо использовать Dictionaries API.

Кэширование

Rate Limits для Dictionaries API рассчитаны исходя из ожидания кэширования этих данных на стороне клиента.

Что дальше? ​