Integrácia cez REST API

Zariadenie podporuje vzdialené vykonávanie skriptov pomocou jednoduchého rozhrania. Pre integrátorov je poskytnutá jednoduchá tirieda v Jave pre vykonávanie skriptov.

Použitie

Typ zariadenia		poznámka
eKasa	áno
eKasa + POS	áno
POS	áno

REST Api je súčasťou FM middleware a zapína sa priamo s eKasa

Vlastnosti

Skripty sa uchovávajú v RAM, tj. nie perzistentne - po reštarte zariadenia nie je možné získať vykonané skripty pred reštartom.
Skripty sú vykonávané asynchrónne, tj. skript sa zaradí na spracovanie a pomocou endpointu API je možné sa dotazovať na stav spracovania.

Popis koncových bodov

V prípade potreby integrácie do iného jazyka je možné priame využitie endpointov REST Serveru

Authenticate

Vygenerovanie autentifikačného tokenu

Content-Type: application/json
GET http://127.0.0.1:48080/api/authenticate

{
    "userName":"admin",
    "password":"1111"
}

Odpoveďou je komunikačný kľúč potrebný pre ďalšiu komunikáciu

Zaradenie Pegas skriptu na spracovanie

Content-Type: application/json
POST http://127.0.0.1:48080/api/pegas-script

POST /api/pegas-script HTTP/1.1
Host: 127.0.0.1:48080

Authorization: Bearer 34cdbf847f579409a876d250454a361a

{
    "pegasScript":"getVariable:B51\r\n"
}

Odpoveďou je ID scriptu, ktorý bol príkazu priradený, na get výsledku sa použije toto ID v následujúcom kroku ako "task/"ID".

Získanie stavu spracovania

Content-Type: application/json
GET http://127.0.0.1:48080/api/tasks/0

Authorization: Bearer 34cdbf847f579409a876d250454a361a

GET /api/tasks/1 HTTP/1.1
Host: 127.0.0.1:48080

HOST - IP adresa zariadenia, na ktoré sa REST má pripojiť.

Príkazy pre eKasa

Príkazy pre POS

Last modified: 23 februára 2026