Данное апи игровой сервер использует для взаимодействием с сервером партнера. Игровой сервер выполняет указанный набор запросов( на данный момент это 4 метода) к серверу партнера. Партнеру необходимо на своей стороне реализовать обработку этих запросов и отдачу соответствующих ответов.

Протокол

API.URI - не забудьте сообщить менеджеру адрес, по которому Вы будете обрабатывать запросы.

Запросы

1. Платформа все запросы к АПИ выполняет в формате POST(HTTP)
2. URI запроса формируется по схеме API.URI + '/' + serviceName + '.' + methodName
3. В теле запроса (http body) передается строка в формате JSON (обьект)
4. Все запросы будут подписаны с использованием Секретного ключа(если не указано обратное для конкретного метода)

• Подпись может быть использована Партнером, чтобы убедиться что запрос пришел действительно от Платформы.
• В подписи запроса участвуют только поля первого уровня, значения которых - примитивы (не обьекты)
• В подписи не участвуют следующие поля partner, meta
• Обьект meta используется для передачи дополнительной информации, которая не является необходимой для обработки запроса. Например для слотов передается информация о кол-ве линий, размер ставки и т.д. Набор и формат данных в поле meta может меняться в любое время и без предупреждения, поэтому не рекомендуется завязываться на обработку этих данных. В случае необходимости получения статических данных по играм(игрокам и т.д.) следует воспользоваться соответствующим партнерским АПИ или использовать логин-пароль для доступа в личный кабинет.

Ответы

1. Все ответы Партнер должен в формате JSON.

   • Http Status Code - не является частью апи и во всех ответах должен быть 200 (в случае успешных и неуспешных вызовах (исключая случаи ошибок на транспортном уровне)). Http Status Code отличный от 200 говорит либо о серьезных неполадках на сервере, либо полностью ошибочном запросе.
   • Общая схема положительного ответа : Все положительные ответы должны в теле ответа содержать "status": 200

   {
         "status" : 200,
         "method" : "service.method",
         "response" : ...response entity as json...
   }
   

• Общая схема отрицательного ответа:

  {      
  			"status" : "цифровой код отличный от 200",
        "method" : "service.method",
        "message" : "Строковое описание ошибки. В целях безопасности, описание не обязательно четко описывает, что произошло на сервере, но в некоторых случаях может служить подсказкой. В остальных случаях обратитесь в тех.поддержку."
  }
  

Обработка ошибок

Общая информация:

• Connect timeout 1s
• Read timeout 3s