Что такое API и как с ним работать

API – описание способов, которыми одна компьютерная программа/cайт/скрипт может взаимодействовать с другой программой/сайтом/скриптом. Иными словами, мы предоставляем вам свои данные о вилках и инструкции по их настройке и использованию. Вы же, в свою очередь, можете использовать эти данные, например, при написании скрипта/программы для автоматизации процесса ставок.

Как выполнить настройку и получить REST API данные

1. Для того, чтобы воспользоваться API – вам необходимо подать заявку со списком необходимых вам букмекеров (до 10 БК) и типом вилок/valuebets (прематч, лайв) на странице с тарифами.

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

Заявка на доступ к API может иметь 4 статуса

1. На рассмотрении - заявка находится на рассмотрении (обычно мы рассматриваем поступившие заявки в течение 48 часов).
2. Готово к оплате - заявка была одобрена и ожидает оплаты. Этот статус также отображается в том случае, если ваша подписка на выбранный тариф завершается и у вас есть возможность заказать ее повторно.
3. Оплачено - заявка оплачена, подписка на API готова к использованию.
4. Срок окончен - срок подписки по данной заявке истек.

Ваш персональный API токен появится на странице Личный кабинет → API сразу после активации подписки.

2. После активации подписки необходимо выполнить настройку получаемых данных под нужные вам параметры. Для этого перейдите на вкладку «Мультифильтры» в «Личном кабинете» и создайте фильтр с необходимыми вам настройками. Более детально о настройке фильтров читайте в Руководстве пользователя => Настройка фильтров.

[!] Запомните ID своего фильтра, он понадобится вам в дальнейшей работе с нашим API.

3. Следующий этап – проверка правильности выдаваемых данных. Для этого перейдите на выдачу с API («API Прематч», «API Лайв»), выберите тип API (вилки/valuebets) и примените ранее созданный фильтр. Такая визуализация данных позволит вам наглядно убедиться в том, что вы все настроили правильно.

4. Далее вам нужно перейти на вкладку API в Личном кабинете и скопировать там свой уникальный токен. Токен – буквенно-цифровой ключ, который используется для доступа к API данным конкретно взятым пользователем.

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

5. Вышеупомянутый токен, а также ID ранее созданного фильтра необходимо вставить в Swagger документацию (arb-controller - для вилок, valuebet-controller - для valuebets). Как результат – вы получите ссылку на данные под указанные вами параметры.

Swagger для Live: https://rest-api-lv.allbestbets.com/doc.html
Prematch: https://rest-api-pr.allbestbets.com/doc.html

Для этого в Swagger документации нажмите «POST» => «Try it out», далее в появившемся списке заполните все необходимые поля и нажмите «Execute».

access_token: Ваш уникальный токен.
search_filter: ID созданного вами фильтра.

На этом все, результат получен! Он полностью аналогичен отображаемому результату на страницах выдачи «API Прематч» или «API Лайв».

Далее, если вы хотите использовать получаемые данные для автоматизации процесса проставления вилок – вам необходимо реализовать на своей стороне соответствующий скрипт/программу и подключить его к нашему API при помощи сгенерированного Curl.