e-bon
e-bon.ro
Referință API

Instanțe ale aplicației

Endpoint REST pentru a inspecta ce instanțe ale aplicației mobile E-BON sunt în prezent conectate prin WebSocket și fac bridge la dispozitivele fiscale ale organizației.

Instanțe ale aplicației

API-ul de instanțe ale aplicației expune un singur endpoint de citire care returnează care instanțe ale aplicației mobile E-BON sunt în prezent conectate la backend-ul e-bon prin WebSocket pentru organizația autentificată. Fiecare instanță este un telefon sau o tabletă pe care rulează aplicația E-BON, care face bridge între unul sau mai multe AMEF-uri din rețeaua locală și cloud — intrările listate aici sunt citite direct din gateway-ul de dispozitive în memorie, deci reflectă conectivitatea live, nu starea din Firestore.

Ruta este sub /api/v1/app-instances și acceptă fie o cheie API (x-api-key / Authorization: Bearer …), fie un JWT din Portal.

Pentru starea WebSocket live a fiecărui dispozitiv fiscal (în loc de instanța de aplicație care face bridge), folosește GET /devices/statuses. Pentru înregistrările de dispozitive persistate în Firestore folosește GET /devices.

GET /api/v1/app-instances

Returnează lista instanțelor aplicației mobile E-BON conectate în prezent prin WebSocket pentru organizația autentificată. Fiecare intrare include metadatele capturate la handshake-ul WebSocket (appVersion, deviceModel, osVersion, connectedAt) și un deviceName rezolvat din înregistrarea Firestore a dispozitivului — căzând înapoi pe deviceId-ul brut dacă documentul nu poate fi citit.

  • Permisiune (scope): devices:read

Răspuns (200 OK)

{
  "instances": [
    {
      "deviceId": "dev_pos_01",
      "deviceName": "Tejghea POS 1",
      "appVersion": "2.4.1",
      "deviceModel": "Samsung Galaxy Tab A8",
      "osVersion": "Android 14",
      "connectedAt": "2026-04-09T08:00:00.000Z",
      "connectedDevices": []
    }
  ]
}
Câmpul connectedDevices este rezervat pentru utilizare viitoare și este în prezent returnat întotdeauna ca un array gol de către handler-ul rutei.

Exemplu

curl https://api.e-bon.ro/api/v1/app-instances \
  -H "x-api-key: ebon_live_acme_corp_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"

Coduri de eroare

Catalogul HTTP complet este pe Prezentare API › Catalogul codurilor de eroare HTTP.

Vezi și

  • Dispozitive — gestionează dispozitivele fiscale către care fac bridge aceste instanțe ale aplicației.
  • Autentificare — catalogul de permisiuni (devices:read este documentat aici).
  • Prezentarea API-ului — URL de bază, plicul de eroare, limite de rată, idempotență, paginare.

Facturare

Endpoint-uri REST pentru gestionarea abonamentului Stripe al organizației — sesiuni de checkout, portal client, starea abonamentului, anulare/reluare, facturi și handler-ul de webhook Stripe.

Comenzi

Endpoint-uri REST pentru a pune în coadă comenzi fiscale către un AMEF — trimiterea unei comenzi, listarea și filtrarea cozii, polling pe o singură comandă pentru finalizare și anularea unei comenzi în așteptare.