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

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

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

   • access_key
   • access_secret_key

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

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

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

   curl https://breaking-bet.com/access_keys/{ACCESS_KEY_ID}/access_tokens \
   -H "Content-Type: application/json" \
   -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. Например, для создания фильтра вилок необходимо послать запрос вида POST https://arbs.prematch.api.breaking-bet.com/filters/{ACCESS_KEY_ID}

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

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

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

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

5. Данные, отдаваемые через DataApi часто содержат ID тех или иных сущностей — названий видов спорта, букмекеров, видов исходов и т.д. Для того чтобы расшифровать эти ID и получить человекочитаемые названия, необходимо использовать Dictionaries API. Подробнее об этом сервисе вы можете узнать на соответствующей странице данного руководства. Rate Limits для Dictionaries API рассчитаны исходя из ожидания кэширования этих данных на стороне клиента.