Disko Turnikesi (Turnstile API'si)¶
Turnike API'si, bir kart tutucu turnikede bir Disko misafir kartının etkinlik alanından ayrılmasına izin verilip verilmeyeceğine karar verir. Bilinçli olarak basit tutulmuştur, böylece bir turnike kumandası onu bir girişe (JWT) gerek duymadan çağırabilir: API anahtarı URL üzerinden aktarılır.
Kurulum¶
Admin → Disko → Genel → Turnike (Turnstile API'si)
- „Generieren" (Oluştur) bir API anahtarı üretir (tam olarak gösterilir).
- Kaydedin.
- Yanındaki bağlantı URL'sini „Kopieren" (Kopyala) ile alın ve turnikeye kaydedin.
Boş bir API anahtarı turnike API'sini devre dışı bırakır.
Çağırma¶
{key}— yapılandırılmış API anahtarı.{kartenId}— okutulan misafir kartının kimliği.
Yanıt bir JSON nesnesidir:
{ "canExit": true, "message": "Karte kann raus — Restguthaben 5,00 €", "refund": 5.0, "status": "ok" }
message, turnikede gösterim için tasarlanmıştır.
Durum Kodları¶
| Kod | Anlam | Turnike |
|---|---|---|
| 200 | Kart karşılanmış — çıkabilir (refund = varsa kalan bakiye) |
aç |
| 402 | Hâlâ açık bir tutar var — lütfen kasaya | kilitli |
| 423 | Kart kilitli | kilitli |
| 409 | Kart zaten hesaplanmış | kilitli |
| 404 | Kart bilinmiyor | kilitli |
| 401 | API anahtarı eksik veya yanlış | kilitli |
Turnikedeki kural: 200 = aç, diğer her şey = kilitli ve message'ı göster.
Hesaplama ve Lisans Koltuğu¶
Karşılanmış bir kartta (durum 200) turnike, kartı hemen hesaplar — otomatik olarak oluşturulan kendi „Drehkreuz" (Turnike) kullanıcısı altında. Bu sırada turnike bir kasa cihazı gibi oturum açar ve böylece bir lisans koltuğu kullanır.
Kart istisnai olarak hemen hesaplanamıyorsa (ör. boş koltuk olmadığından), misafir yine de dışarı çıkabilir — kart daha sonra gün sonu raporunda hesaplanır.
Kalan bakiye
Kalan bir kart bakiyesi (refund) turnikede ödenmez. Misafir bunu kasadan alır; kayıt, Kartlarda
kalan bakiye ayarını izler (ödeme / bakiye kaybı / bahşiş).
İlgili İşlevler¶
Turnike olmadan çıkışta iki mobil alternatif vardır:
- Self-Checkout (
/disco/selfcheckout) — kiosk: karşılanmış bir kartta yeşil tam ekran çerçeve „OK ve çık", ödenmesi gereken bir tutar varsa kırmızı çerçeve ve tutar. - Mobil çıkış kasası — yoğunluk olduğunda ek bir kasa için Disko kasasının telefon görünümü (Fotoğraf/Kalemler/Bilgiler sekmeleri).