Інтеграція API для букмекерської платформи: лінія, ставки й розрахунок
Лінія й коефіцієнти, прийом ставок і розрахунок купонів для вашого букмекерського проєкту: один JSON API, покрокова документація та консультації з API від нашої команди.
Із чого складається інтеграція
Беріть лише те, що потрібно продукту: саму лінію з коефіцієнтами або весь цикл від коефіцієнта до виплати.
Лінія й коефіцієнти
Prematch і live матчі, ринки та актуальні коефіцієнти з 25+ видів спорту й кіберспорту. Від $30/міс.
API коефіцієнтів →Прийом ставок
Ординари й експреси. API повторно перевіряє коефіцієнт і доступність результату в момент ставки.
Coupon API →Розрахунок
Купони розраховуються автоматично, результат надходить підписаним callback або за запитом. Від $300/міс.
Документація розрахунку →Готовий інтерфейс
Немає часу робити фронтенд ставок? Вбудуйте спортбук-віджет із матчами, коефіцієнтами та купоном.
Спортбук-віджет →Букмекерський сайт у вашому дизайні на наших даних
Live-матчі з коефіцієнтами, що змінюються, купон, який перевіряє ціну перед прийомом ставки, і розраховані ставки в історії гравця. Дизайн ваш, а дані, перевірка коефіцієнтів і розрахунок — від SportAPI.
- Лінія prematch і live
- Коефіцієнти в реальному часі
- Перевірка коефіцієнта під час ставки
- Сайт і мобільний застосунок
~20хв
до першого екрана з реальними матчами за готовими прикладами
1день
на лінію, ставки й розрахунок з ШІ-агентом і нашою документацією для ШІ
5–30днів
у звичайної команди розробників — залежно від досвіду в беттінгу
2дні
безкоштовного доступу до всіх видів спорту, prematch і live, для перевірки інтеграції
Від коефіцієнта на сайті до виплати
Шість викликів покривають увесь цикл ставки. Із SportAPI працює ваш сервер, гравці бачать лише ваш інтерфейс.
- 01↓ →
Меню спорту
menu повертає види спорту, країни й турніри для prematch або live.
- 02↓ →
Матчі й коефіцієнти
events і event повертають матчі, ринки та актуальні коефіцієнти.
- 03↓ →
Покажчик ставки
Вибраний результат передається покажчиком із коефіцієнтом, який бачив гравець.
- 04↓ →
Створення купона
coupons/place перевіряє коефіцієнт і приймає ординар або експрес.
- 05↓ →
Розрахунок
Після матчу купон розраховується, вам надходить підписаний callback.
- 06
Виплата
Ваша система зараховує виграш на баланс гравця.
Гравці працюють із вами, ви — із SportAPI
Сайт і застосунок звертаються лише до вашого бекенду. Він зберігає API-ключ, кешує лінію для всіх гравців, надсилає ставки в SportAPI й отримує розрахунок підписаним callback.
- Ключ ніколи не потрапляє в браузер
- Один кеш на всіх гравців
- Ваші баланси й правила
- Callback із HMAC-підписом
Шість кроків до запуску
Кроки 1–3 дають живу лінію на сайті. Кроки 4–6 потрібні, лише якщо ви приймаєте ставки через SportAPI.
1. Тестовий ключ
Залиште заявку в Telegram. Тестовий доступ — 2 дні до всіх видів спорту, prematch і live.
2. Перший запит
Викличте menu із ключем у заголовку Package і зберіть перший екран матчів.
3. Лінія та live
Завантажуйте матчі й коефіцієнти, оновлюйте live з рекомендованими інтервалами, приховуйте закриті результати.
Відкрити4. Прийом ставок
Отримайте JWT, зберіть покажчик ставки з вибраного результату та створіть купон.
Відкрити5. Отримання розрахунку
Перевіряйте HMAC-підпис callback або опитуйте розраховані купони; кожен пакет обробляйте один раз.
Відкрити6. Запуск
Оберіть тариф, перейдіть на робочий ключ і залиште опитування API як резервний канал для callback.
Ставки розраховуються без ручної роботи
Після матчу кожен купон автоматично отримує результат: виграш, програш, повернення або половинний виграш на азійських ринках. Callback приносить суму виплати, повтори не призводять до подвійної виплати, а опитування API відновлює результати після простою.
- Ординари й експреси
- Виграш, програш, повернення
- Безпечні повтори з batchId
- Відновлення після простою
Коефіцієнти на вхід, ставка на вихід: два запити
Для лінії потрібен API-ключ у заголовку Package, для ставки — JWT і покажчик вибраного результату. Повні приклади на cURL, Python, PHP та JavaScript — у документації.
# 1. Меню live-матчів (Sport Line API)
curl 'https://YOUR_API_DOMAIN/v1/menu/live/ua' \
--header 'Package: YOUR_API_KEY'
# 2. Ординар (Coupon API)
curl -X POST "$BASE_URL/api/partner/coupons/place" \
--header "Authorization: Bearer $CLIENT_TOKEN" \
--header "Content-Type: application/json" \
--data '{"list_bets": ["line#737779544#1#1#0#1.85"], "amount": 10}'Ваша частина й наша частина
Ваша частина
Ваш сервер зберігає API-ключ і робить усі запити. На вашому боці акаунти й баланси гравців, інтерфейс, платежі та вибір видів спорту й ринків для показу.
Наша частина
Лінія й коефіцієнти, перевірка коефіцієнта під час ставки, розрахунок і доставка результату, документація з прикладами та консультації з API. Код за вас ми не пишемо, але можемо зробити інтеграцію за додаткову плату.
Скільки коштує інтеграція
Лінія оплачується щомісяця за кількістю видів спорту. Почніть із безкоштовного доступу на 2 дні до всіх видів спорту. Прийом і розрахунок ставок (Coupon API): від $300/міс, $20 на місяць для тестових ставок. За оплату на кілька місяців — знижка до 30%.
Один вид спорту, щоб перевірити інтеграцію на реальному продукті.
- Видів спорту: 1
- Prematch + Live
- Мови: EN
- Топ-ліги
- Підтримка: 8/5
Десять видів спорту для букмекерської платформи, що зростає.
- Видів спорту: 10
- Prematch + Live
- Мови: EN, RU
- Топ-ліги
- Підтримка: 12/7
Усі види спорту та кіберспорт для повноцінної букмекерської контори.
- Видів спорту: усі
- Prematch + Live
- Мови: EN, RU
- Топ-ліги
- Кіберспорт включено
- Підтримка: 24/7
Питання про інтеграцію API ставок
Як працює інтеграція API для букмекерської платформи
Інтеграція API букмекерської платформи підключає до вашого продукту те, чого він не може зробити сам: спортивну лінію з актуальними коефіцієнтами, прийом ставок за цією лінією та розрахунок після матчу. У SportAPI кожна частина — окремий JSON API, тож можна почати з лінії й додати прийом ставок пізніше, не переробляючи інтерфейс.
Інтеграція API ставок крок за кроком
Перша частина — лінія. Ваш сервер запитує меню спорту, список матчів і повний матч з ринками й коефіцієнтами, зберігає ідентифікатори та оновлює live з рекомендованими інтервалами. Закриті результати треба блокувати в інтерфейсі, інакше гравці намагатимуться поставити на ціну, якої вже немає.
Друга частина — прийом ставок. Коли гравець підтверджує купон, ваш бекенд надсилає покажчик кожного вибраного результату разом із коефіцієнтом, який бачив гравець. Перевірка коефіцієнта відхиляє купон або приймає нову ціну за обраним вами режимом, тож гравець не отримає ставку за коефіцієнтом, якого вже немає.
Третя частина — розрахунок. Після події купон розраховується автоматично, результат надходить на ваш callback із HMAC-підписом. Ваша система зараховує виграш на баланс гравця і для надійності регулярно опитує розраховані купони.
API ставок для букмекерського бізнесу: що спланувати
Спершу серверну частину. API-ключ і JWT не потрапляють у браузер: усі запити йдуть через ваш бекенд, який заодно кешує лінію й захищає від лімітів запитів. Вирішіть, які види спорту й ринки показувати, як відображати зміну коефіцієнта і що робити з відхиленим купоном.
Далі звіряння. Надійна інтеграція зберігає код кожного купона, обробляє кожен пакет callback рівно один раз і вміє відновити результати після простою. Ці три правила захищають від найдорожчих помилок інтеграції — подвійної виплати й загубленої ставки.
Самостійно чи з нашою командою
Більшість команд інтегруються самостійно: у документації кожен метод описано з прикладами запитів і відповідей, є версія для ШІ-агентів. Перший екран із реальними матчами за готовими прикладами займає близько 20 хвилин. Консультації з API безкоштовні. Якщо розробників немає, команда SportAPI може зробити інтеграцію за додаткову плату, а найшвидше запуститися можна зі спортбук-віджетом або букмекерською системою під ключ.
Що перевірити перед запуском
Перед переходом на робочий ключ перевірте чотири речі. Лінія на сайті збігається з відповіддю API для того самого матчу, включно із закритими результатами. Купон зі зміненим коефіцієнтом відхиляється або приймається рівно так, як задано обраним режимом, і гравець бачить причину. Розрахований купон зараховує виграш один раз, навіть якщо повторно надіслати той самий callback. Якщо зупинити обробник callback на годину, опитування API відновлює всі результати. Коли всі чотири перевірки проходять на тестовому ключі, інтеграція готова до реальних гравців.
Якщо ви підключаєте лише лінію без прийому ставок, достатньо перших двох перевірок: лінія збігається з відповіддю API, а live оновлюється з рекомендованими інтервалами й не впирається в ліміти.
Типові помилки інтеграції
Запити до API з браузера й витік ключа. Оновлення live частіше за рекомендовані інтервали та впирання в ліміти. HTTP 200 вважається успіхом без перевірки бізнес-коду у відповіді. Подвійне зарахування виграшу, коли той самий callback надходить повторно. Усе це розібрано в посібнику з інтеграції і в короткому посібнику з прийому ставок.