gkAPI (далее, apiCards2) предназначен для доступа к некоторым данным системы Game-Keeper, а также для внесения изменений в эти данные. Технология реализована со на базе Microsoft Web Server IIS и инструментах платформы .Net Core.
1.Схема взаимодействия
2. Состав дистрибутива
Папка с WEB-сервером apiCards2 находится в основном дистрибутиве версии GK в папке ..\GK\gkAPI\api.ext\cards2\.
Папка с gkExtServer находится в основном дистрибутиве версии GK в папке ..\GK\gkAPI\gkExtServer\.
Для удобства дальнейшей настройки и навигации необходимо создать папку WEB в корне папки GK и скопировать в неё cards2 и gkExtServer.
3. Установка и настройка gkExtServer
В папке с модулями gkExtServer, настраиваем конфигурационный файл gkExtServer.ini:
[DbConnect] – связь с gkPosServer
Port = 50300 – порт gkPosServer
ServerName = 127.0.0.1 – ip-адрес, где запущен gkPosServer
[Settings]
ServiceName=Cards – имя службы gkExtServer (будет отображаться в службах Windows)
HttpPort=50301 – порт gkExtServer
POSID=997
LogLevel=5
;Mode=1
Далее необходимо проинсталлировать службу gkExtServer, запустив через командную строку с ключом /install. Для удобства инсталляции службы в папке с gkExtServer.exe имеется install.bat, который необходимо запустить от имени Администратора. Предварительно в тексте файла необходимо отредактировать путь к gkExtServer.exe.
Запустить службу gkExtServer.
4. Настройка подключения apiCards2
Настройка заключается в конфигурировании файла gkconfig.json.
Содержимое файла:
{
"host": "127.0.0.1", - ip-адрес, где запущен gkExtServer
"port": "50301", - порт gkExtServer
}