apiCards2 предназначен для доступа к некоторым данным системы Game-Keeper, а также для внесения изменений в эти данные. Технология реализована на базе Microsoft Web Server IIS и инструментах платформы .Net Core.

Начиная с версии Web-Api 4.17, api работает на Net Core 8-го поколения!
Так же изменился конфигурационный файл. Изменения описаны ниже в документации.


Для возможности использования доступа к базе данных через интерфейс необходимо приобрести лицензию на модуль «WEB API».

Самую актуальную информацию всегда можно посмотреть на нашем демо-стенде по ссылке.


Схема взаимодействия

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


Состав дистрибутива

Для удобства дальнейшей настройки и навигации необходимо скопировать apiCards2 в папку WEB в корне папки GK.



Настройка подключения apiCards2

Настройка заключается в конфигурировании файла apiCards2.config.json.


Содержимое файла apiCards2.config.json :

{
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*",
  "GKPosServer": {
    "Url": "https://127.0.0.1:50302" – ip-адрес, где запущен gkPosServer, 50302 – PortH из gkPosServer.ini.
  },
  "ConnectionStrings": {
    "GKDB": "Data Source=127.0.0.1;Initial Catalog=gkArcade;TrustServerCertificate=True;User ID=sa;Password=" – строка подключения к БД gkArcade.
  }
  //"api-users": [
  //  {
  //    "key": "value"
  //  }
  //]
}



Установка платформы .Net Core

Для работы apiCards2 с версии 4.17 необходимо установить Net Core 8-го поколения!

Установка платформы .Net Core


Установка и настройка Microsoft Web Server IIS

Установка и настройка Microsoft Web Server IIS


В главном окне Диспетчера IIS выбираем элемент дерева «сайты», правой клавишей мыши – Добавить веб-сайт.


Вводим имя сайта, в нашем случае это apiCards2, указываем физический путь к папке cards2, задаем порт для веб-сервиса и нажимаем кнопку «ОК». При вводе имени сайта автоматически будет создан пул приложений для этого сайта с одноименным названием, необходимо в Диспетчере служб IIS перейти в меню дерева «Пулы приложений» и проверить, что пул создался с версией среды CLR.NET v4.0.