Diszkó-forgókapu (Turnstile-API)¶
A forgókapu-API egy kártyavisszatartó forgókapunál dönti el, hogy egy diszkó-vendégkártya elhagyhatja-e a helyszínt. Szándékosan egyszerű, hogy egy forgókapu-vezérlő bejelentkezés (JWT) nélkül hívhassa: a hívót az API-kulcs azonosítja.
Beállítás¶
Adminisztráció → Diszkó → Általános → Forgókapu (Turnstile-API)
- A „Generálás” API-kulcsot hoz létre (teljes egészében megjelenik).
- Mentés.
- Adja meg a kulcsot a forgókapuban. A mellette lévő csatlakozási URL („Másolás”) már tartalmazza a kulcsot — ez az alább leírt, útvonalon keresztüli régebbi híváshoz illik.
Egy üres API-kulcs kikapcsolja a forgókapu-API-t.
Hívás (ajánlott: kulcs a fejlécben)¶
GET /api/v1/disco/turnstile/{kartenId}
POST /api/v1/disco/turnstile/{kartenId}
X-Dikas-Turnstile-Key: {key}
{kartenId}— a ráhelyezett vendégkártya azonosítója.X-Dikas-Turnstile-Key— a beállított API-kulcs.
Miért jobb a fejléces csatlakozás
Az útvonalban lévő kulcs minden hozzáférési naplóban szerepel — a proxyban, a webszerverben és minden köztes állomáson. A fejlécben nem jelenik meg ott. Új forgókapu beállításakor ezért ezt az utat válassza.
Hívás az útvonalon keresztül (régebbi út, továbbra is működik)¶
Szakmailag azonos — a meglévő forgókapuk és vezérlések, amelyek nem állíthatók át egyik napról a másikra, változatlanul tovább működnek. Ha egy eszköz mindkettőt küldi, a fejlécben lévő kulcs érvényes.
A válasz egy JSON-objektum:
{ "canExit": true, "message": "Karte kann raus — Restguthaben 5,00 €", "refund": 5.0, "status": "ok" }
A message a forgókapun való megjelenítésre szolgál.
Állapotkódok¶
| Kód | Jelentés | Forgókapu |
|---|---|---|
| 200 | A kártya fedezett — kimehet (refund = esetleges maradék egyenleg) |
nyit |
| 402 | Még van nyitott összeg — kérjük, menjen a pénztárhoz | zárva |
| 423 | A kártya zárolva van | zárva |
| 409 | A kártya már el van számolva | zárva |
| 404 | Ismeretlen kártya | zárva |
| 401 | Az API-kulcs hiányzik vagy hibás | zárva |
Szabály a kapunál: 200 = nyitás, minden más = zárva, és a message megjelenítése.
Elszámolás és licenc-seat¶
Fedezett kártya esetén (200-as állapot) a forgókapu a kártyát azonnal elszámolja — egy saját, automatikusan létrehozott „Forgókapu” felhasználó nevében. Ekkor a forgókapu pénztáreszközként jelentkezik be, és elfoglal egy licenc-seatet.
Ha a kártyát kivételesen nem lehet azonnal elszámolni (pl. mert nincs szabad seat), a vendég ennek ellenére kimehet — a kártya ekkor a napi záráskor kerül elszámolásra.
Maradék egyenleg
A kártyán maradó egyenleget (refund) a forgókapu nem fizeti ki. A vendég a
pénztárnál veheti fel; a könyvelés a Maradék egyenleg a kártyákon beállítást követi (kifizetés /
egyenleg elévülése / borravaló).
Kapcsolódó funkciók¶
Forgókapu nélkül két mobil alternatíva áll rendelkezésre a kijáratnál:
- Önkiszolgáló kiléptetés (
/disco/selfcheckout) — kioszk: zöld, teljes képernyős keret „OK, távozhat” felirattal fedezett kártyánál, piros keret az összeggel, ha még fizetni kell. - Mobil kijárati pénztár — a diszkópénztár telefonos nézetben (Fotó/Tételek/Infók fülek) egy további pénztárként, ha nagy a forgalom.