Техническая документация: Интеграция системы для расчета ставок и купонов.

{APIHOST}/WebServices/BCService.asmx/LogIn/

"errorCode":1,
"fullErrorCode":99,
"errorMessage":"Неверныйуровень доступа"

    import requests
    import json
    
    url = "https://example-domain-calc.com/WebServices/BCService.asmx/LogIn/"
    
    payload = json.dumps({
      "login": "demo-login@demosportapi.net",
      "password": "demo-password"
    })
    headers = {
      'Content-Type': 'application/json'
    }
    
    response = requests.request("POST", url, headers=headers, data=payload)
    
    print(response.text)
    

    $curl = curl_init();
    
    curl_setopt_array($curl, array(
        CURLOPT_URL => 'https://example-domain-calc.com/WebServices/BCService.asmx/LogIn/',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => '',
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 0,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => 'POST',
        CURLOPT_POSTFIELDS =>'{
        "login":"demo-login@demosportapi.net",
        "password":"demo-password"
    }',
        CURLOPT_HTTPHEADER => array(
        'Content-Type: application/json'
        ),
    ));
    
    $response = curl_exec($curl);
    
    curl_close($curl);
    echo $response;
    

 
const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
    "login": "demo-login@demosportapi.net",
    "password": "demo-password"
});

const requestOptions = {
    method: "POST",
    headers: myHeaders,
    body: raw,
    redirect: "follow"
};

fetch("https://example-domain-calc.com/WebServices/BCService.asmx/LogIn/", requestOptions)
    .then((response) => response.text())
    .then((result) => console.log(result))
    .catch((error) => console.error(error));
                                            

 
                           
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"login\":\"demo-login@demosportapi.net\",\r\n    \"password\":\"demo-password\"\r\n}");
Request request = new Request.Builder()
.url("https://example-domain-calc.com/WebServices/BCService.asmx/LogIn/")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
                            
                                            

{"d":{"UserId":"36557"}}

{"d":{}}

Метод отправки ставки или купона

Для отправки ставки необходимо использовать cookie, полученные на этапе авторизации. Эти данные обязательны для идентификации вашей сессии и обработки запросов.

URL для запроса:

{HOST_API}/bet/place/

Пример тела отправки в body:

{
    "data":{
        "list_bets":[
            "line#586464528|17|954|2.5#4.27",  "live#586464528|87|4|0#1.12"
        ],
        "realAmount":"2",
        "currency":"USD",
        "lang":"en",
        "remote_host":"https://mysites.com",
        "rate_mode":"reject"
    }
}

Описание полей

Параметр	Описание
list_bets	Код ставки и коэффициенты. Формат: "тип_события # ID_матча|Код_ставки # коэффициент". Например: "live#579216393|1|1|0#2.1"
realAmount	Сумма ставки. Указывается в виде строки, например: "150".
currency	Валюта купона.
lang	Язык, на котором сохраняются ставка и купон. Например: "en" или "ru" или "tr".
remote_host	URL для отправки результатов расчета купона. Указывайте без конечного слэша.
rate_mode	Опция принятия купона при изменении коэффициентов: "reject" (отклонить при изменении) или "accept" (принять при любых изменениях). По умолчанию: "accept".

Примечание: Убедитесь, что параметры передаются в корректном формате. Например, list_bets должен быть массивом, даже если ставка одна.

Мы не проверяем сумму ставки. Вы можете передавать как реальную сумму ставки, так и любое значение. Это сделано для обеспечения конфиденциальности ваших финансовых данных. Наша задача — предоставить результаты расчета. Вы сами выполняете начисления выигрышей своим игрокам.

Обязательные параметры для отправки ставки:

• list_bets — содержит информацию о ставке и соответствующем матче.
• remote_host — URL, на который мы отправим результаты расчета купона или исхода.
• rate_mode — определяет, как система обрабатывает изменения коэффициентов.

Остальные параметры также нужно отправлять но они являются необязательными и могут быть использованы для вашего удобства.

Описание параметра remote_host

remote_host — это адрес вашего сервера, на который мы отправляем запросы с результатами расчета ставок. На этом хосте должен быть настроен прием запросов от нашего сервера. Ниже описаны примеры возможных значений и особенности работы с этим параметром.

Вы можете указать различные варианты remote_host:

• Простой хост: https://mysites.com
• Хост с портом: https://mysites.com:78665
• Хост с дополнительными путями: https://mysites.com/request/sportapi/sender
• Хост с параметрами: https://mysites.com/request.php?action=webhook

Важно: При отправке запроса наша система автоматически добавляет к указанному remote_host строку /api/bet/result.
Таким образом, конечный адрес для получения запросов формируется как remote_host + "/api/bet/result". Убедитесь, что ваш сервер настроен на прием данных по этому пути.

Примеры:

• Вы передаете remote_host = https://mysites.com. Мы отправляем запросы на: https://mysites.com/api/bet/result.
• Вы передаете remote_host = https://mysites.com/request.php?action=webhook. Мы отправляем запросы на: https://mysites.com/request.php?action=webhook/api/bet/result.

Технические детали:

• Запросы отправляются методом POST.
• Ваш сервер должен быть готов принимать JSON-данные, которые мы отправляем.
• Ваш сервер должен отдать код 200 в случаи успешного приема данных

Убедитесь, что ваш сервер корректно обрабатывает указанный путь и запросы. В следующем разделе приведен пример структуры данных, которые отправляются нашим сервером.

Описание параметра rate_mode

Параметр rate_mode задает поведение системы при изменении коэффициентов. Он может принимать два значения:

• accept: В этом режиме купон будет принят с текущим коэффициентом, даже если он изменился. Например, игрок добавил в купон ставку \"Победа Манчестера\" с коэффициентом 2.02. Пока он нажимал кнопку \"Сделать ставку\", коэффициент изменился на 1.37 или 2.78. В режиме accept система сохранит купон с новым коэффициентом без уведомления вашей системы.
• reject: В этом режиме система отклонит купон, если коэффициент изменился. В ответе будет ошибка с уведомлением о том, что коэффициент изменился.

Выбирайте режим, который лучше всего соответствует вашим бизнес-процессам и обеспечивает удобство для ваших пользователей.

Важные рекомендации

1. Форматирование JSON: Убедитесь, что данные корректно сериализуются в JSON-формат перед отправкой.
2. Cookie: Передавайте cookie, полученные на этапе авторизации, для успешной идентификации сессии пользователя.
3. Обработка ошибок: Обрабатывайте ответы сервера, особенно случаи, когда возвращается errorCode = 1.
4. Тестирование: Проведите тесты на всех этапах интеграции, включая отправку одиночных и нескольких ставок.

Поля ответа

Параметр	Описание
betCode	Уникальный номер ставки в нашей системе
errorCode	Основной статус результата запроса
fullErrorCode	Детализация ошибок.
errorMessage	Текстовые сообщения об ошибках системы
AmountOut	Возможная сумма выигрыша
CountEvents	Количество ставок в купоне
Coef	Коэффициенты исходов
IsLive	Тип ставки: онлайн или до начала матча (true/false)
LinesId	ID матча
EventDate	Дата матча

Описание ошибок при отправке ставки

При отправке ставки могут возникнуть различные ошибки. Ответ сервера содержит три ключевых поля:

• errorCode: Основной статус запроса.
• fullErrorCode: Детализация ошибки.
• errorMessage: Текстовое описание ошибки.

Успешная операция

Если ставка успешно принята, сервер возвращает:

{
  "errorCode": 0,
  "fullErrorCode": 0,
  "errorMessage": ""
}

Описание: Купон принят, ошибок нет.

Общая ошибка

Если произошла ошибка, сервер возвращает:

{
  "errorCode": 1,
  "fullErrorCode": [КОД_ОШИБКИ],
  "errorMessage": "[ОПИСАНИЕ_ОШИБКИ]"
}

Описание: Произошла одна из возможных ошибок. Ниже приведены коды и сообщения ошибок.

Возможные коды и описания ошибок

Код ошибки (fullErrorCode)	Сообщение ошибки (errorMessage)	Описание
1	error_wrong_bet_data	Неверные данные ставки. Проверьте параметры list_bets и другие обязательные поля.
1	error_block_bet_data	Ставка временно заблокирована и не может быть принята.
1	error_repeat_bet_data	Повтор ставки на один и тот же исход из одного матча не допускается.
2	label_change_rate	Коэффициент изменился. Купон отклонен из-за несовпадения указанного и актуального коэффициентов.
3	error_exist_bet	Данный исход ставки уже не существует. Проверьте актуальность данных.
99	Неверный уровень доступа	Пользователь не имеет прав для выполнения данной операции. Скорее всего нужно заново авторизироваться, пропали куки, или аккаунт заблокирован.
99	Error exist remote host!	Некорректный или отсутствующий параметр remote_host. Проверьте настройку вашего сервера.

Рекомендации для обработки ошибок если коэффициент изменился

 
{
    "errorCode":1,
    "fullErrorCode":2,
    "errorMessage":"Изменился коэффициент",
    "rate_mode":"reject",
    "changed":[
        {
            "gid":"586464528", // ид матча
            "rb":2.15, // коэффициент в вашем купоне
            "rg":"2.27", //коэффициент который сейчас реальный
            "rt":0 // статус изменения. 0 - понизился, 1 - повысился
        }
    ]
} 

Рекомендации для обработки ошибок

• Проверка входных данных:
  • Убедитесь, что все обязательные параметры переданы корректно.
  • Проверьте формат list_bets и наличие всех обязательных полей.
• Работа с коэффициентами: Если используется rate_mode = reject, обработайте ошибки, связанные с изменением коэффициентов (label_change_rate).
• Настройка сервера: Убедитесь, что ваш сервер корректно указан в параметре remote_host.
• Журналирование ошибок: Ведите логирование всех ошибок (errorCode, fullErrorCode, errorMessage) для упрощения отладки и взаимодействия с поддержкой.
• Действия при критических ошибках:
  • В случае ошибок уровня 99 проверьте права доступа и настройки API на вашей стороне.

{
    "remote_host": "https://mysite.com",
    "Heads": [{
        "KeyHead": {
            "Id": "344143",
            "BarCode": "x9c52i8411"
        },
        "Status": 2,
        "ExtStatus": 0,
        "AmountOut": 11130,
        "DateReceive": "1597075782"
    }]
}

{
    "remote_host": "https://mysite.com",
    "Heads": [{
        "KeyHead": {
            "Id": "313",
            "BarCode": "75vz48t935"
        },
        "Status": 2,
        "ExtStatus": 0,
        "AmountOut": 19.85,
        "DateReceive": "1592937968"
    }, {
        "KeyHead": {
            "Id": "312",
            "BarCode": "77i0r6e15t"
        },
        "Status": 2,
        "ExtStatus": 0,
        "AmountOut": 12.51,
        "DateReceive": "1592937280"
    }]
}