API des appareils et Device Hub
Dernière mise à jour 2026-10-13
Registre cloud des appareils, appairage du hub et protocole local Device Hub.
Registre cloud des appareils#
GET /api/wms/print-devices?warehouse_id=<uuid>&hub_id=<uuid>&page=1&page_size=50
// -> items: id, name, model, device_type, connection, address,
// is_default_label_printer, status, last_seen_at, hub_id, hub_name,
// warehouse_id, warehouse_name, created_atEn ligne/hors ligne est calculé depuis last_seen_at (seuil de 2 minutes). Le Hub synchronise automatiquement les imprimantes après l’appairage.
Protocole local de Device Hub#
L’appairage et l’impression locale passent par l’app Device Hub en WebSocket sur ws://127.0.0.1:18443 (JSON avec action + params ; événements poussés en { event, data }). hub.info et hub.pair sans auth ; le reste exige le token d’appairage.
// 1. user reads the 6-digit code shown in the Device Hub tray app
// 2. pair (no auth required):
ws -> { "action": "hub.pair", "params": { "code": "482910" }, "id": "1" }
ws <- { "id": "1", "ok": true, "data": { "token": "<hub-token>" } }
// 3. store the token locally; all later requests send it (see device-hub lib).
// success envelope: { id, ok: true, data }
// error envelope: { id, ok: false, error: { code, message } }- hub.info — version/plateforme du hub, sans auth.
- printer.list → { printers } ; printer.discover lance un scan USB + réseau (mDNS), résultats via événements printer.discovered.
- printer.print { device_id, data: "<zpl>", copies } → { job_id } ; fin/échec via événement print.job_completed.
- printer.status { device_id } — état temps réel (plus de papier/ruban, capot ouvert).
- device.register { device_id, name, is_default } — enregistre un appareil découvert (remonte aussi au registre cloud).
Liaison du relais cloud#
ws -> { "action": "hub.cloud_bind", "params": {
"supabase_url": "https://<ref>.supabase.co",
"supabase_anon_key": "<anon-key>",
"organization_id": "<uuid>",
"warehouse_id": "<uuid>" // optional
}, "id": "2" }
ws <- { "id": "2", "ok": true, "data": {} }
// after binding, the Hub pulls print_jobs with its cloud credentials and syncs the device ledger.