Przejdź do treści
  • Przyjmowanie HTTP i MQTT, jedna umowa dla obu
  • Każda paczka z urządzenia archiwizowana 1:1
  • Dwa ślady audytu: firmy i logowania
  • Żadnego agenta do instalowania na maszynie
  • Pieniądze liczone w groszach, nigdy w floatach

Na sali

Co możesz postawić na sali

Wszystko, co potrafi policzyć żeton i zadzwonić do serwera. Tym, czym maszyna może być, jest słownik machine_types — globalny, z nadpisaniem per firma — więc nowa rodzina to wiersz dodany przez roota, nie nowe wydanie.

Flipper / pinball

Dwie strony jednej maszyny: co wpada, a ile oddaje gra.

in / out

Automat arcade

Wrzutnik monet, kredyt i sesje, które sprzedaje karta.

credit

Coin pusher

Poziom zasobnika i wypłata, która go opróżnia.

hopper

Chwytak / claw

Próby, wygrane i nagrody stojące za nimi.

attempts

Dyspenser żetonów

Nominał, który drukuje, i to, ile już wydrukował.

denomination

Kiosk / automatyka

Wszystko, co potrafi policzyć żeton i zadzwonić do serwera.

any counter

Za ladą

Sześć rzeczy i to cały panel

Żadnego modułu dokupianego później, żadnego panelu do składania. Firma loguje się i zastaje swoje własne lokalizacje, maszyny i pieniądze — i nic więcej.

Zobacz to opisane na całej stronie
  • Lokalizacje Każdy obiekt z adresem, gotowy na mapę.
  • Maszyny Co gdzie stoi i co każda maszyna przyjmuje.
  • Żetony Nominały, które oferujesz, wycenione w groszach.
  • Uzupełnienia i inkaso Żetony wsypane, żetony wybrane — i kto to zrobił.
  • Raporty Miesięczne zestawienie z detalami dziennymi pod spodem.
  • Historia firmy Krótki przegląd Twojego konta i jego zmian.

Kanał maszyn

Pięć wywołań, jedno poświadczenie

Cała część umowy przypadająca firmware'owi — pięć POSTów, para uuidów w ciele każdego. Liczniki i obecność wędrują tymi samymi tematami po MQTT dla urządzenia, które woli subskrybować.

POST /api/v1/machine/info

Własny wiersz maszyny, tak jak ustawił go operator: gdzie stoi, jak się nazywa i jakim jest typem maszyny.

POST /api/v1/machine/config

Co ta maszyna powinna oferować: jej nominały i flagi, którymi się rządzi. Maszyna, która nie może się z nami skontaktować, zachowuje ostatnią odpowiedź.

POST /api/v1/machine/telemetry

Paczka zdarzeń licznika — zużyte, naliczone, wydane — wysyłana jako całość, więc odrzucona paczka to po prostu paczka do poprawki i wysłania ponownie. Archiwizowana 1:1, by raport dało się odtworzyć.

POST /api/v1/machine/telemetry/heartbeat

Obecność, tania i mała. To ona robi maszynę zieloną lub szarą na ekranie operatora.

POST /api/v1/machine/config/ping

Własny zegar maszyny, trzymany obok chwili, w której dotarł do nas. Dwa czasy w jednym wierszu to to, co pokazuje rozjechany zegar urządzenia — zanim jego liczniki trafią na zły dzień.

Plan

Co obejmuje plan

Zestaw wywołań najemcy to jedna lista, publikowana przez samo API — oto ona, w trzech grupach. Agent per maszyna, opłata per zdarzenie i read, którego nie widać: nic z tych rzeczy.

Sala

To, co najemca odczytuje jako swoje:

places.read machines.read tokens.read machine-tokens.read

Praca

Dwa zapisy, które ma najemca (D3):

refills.write machine-tokens.write

Miesiąc

To, co zamyka okres:

reports.read history.read subscriptions.read

Lista jest czytana na żywo z własnego zestawu wywołań najemcy w API (client/plans); nazwy i ceny planów przyjdą wraz z fazą abonamentu (M7), więc tu ich nie widać.

Otwórz panel i wstaw jedną maszynę.

Jedno logowanie, jeden obiekt, jedna maszyna — to wystarczy, by zobaczyć, jak wychodzi z niej miesięczny raport. Reszta sali może przyjść w przyszłym tygodniu.