Elenca tutte le tue stampanti

Elenca le stampanti

GET https://www.expedy.fr/api/v2/printers/all

Restituisce tutte le stampanti cloud collegate al tuo account, con il loro UID, nome, stato e configurazione. Usalo per scoprire il printer_uid di cui hai bisogno per inviare un lavoro di stampa.

URL di base: https://www.expedy.fr/api/v2

Autenticazione

Questo endpoint richiede un'intestazione Authorization contenente il tuo SID e il tuo TOKEN, separati da un singolo carattere due punti.

Authorization: <SID>:<TOKEN>

⚠️ Questo non è un token Bearer. Non aggiungere un prefisso Bearer o Basic: invia il valore grezzo SID:TOKEN.

Entrambi i valori sono disponibili nella console Expedy, nella sezione API. Tutte le richieste devono essere effettuate tramite HTTPS (TLS).

Esempio cURL:

curl "https://www.expedy.fr/api/v2/printers/all" \
  -H "Authorization: <SID>:<TOKEN>"

Risposta `200 OK`

Restituisce un array JSON di oggetti stampante (array vuoto se nessuna stampante è registrata).

Campo	Tipo	Descrizione
`printer_uid`	`string`	Identificatore univoco della stampante. È il valore che passi come `{printer_uid}` all'endpoint di stampa.
`printer_name`	`string`	Etichetta leggibile impostata nella console (es. `Kitchen`, `Lobby`).
`printer_status`	`string`	Stato di attivazione della stampante. `1` = attiva, `0` = sospesa. È un flag amministrativo controllato esclusivamente da ExpedyPRINT — non un indicatore di connettività in tempo reale.
`printer_width`	`string`	Larghezza della carta in millimetri: `58`, `80` o `104`. Usala per dimensionare il tuo contenuto (32 / 48 caratteri per riga per 58 / 80 mm).
`printer_graphic_mode`	`string`	Modalità di rendering delle immagini configurata nella console: `0` = Graphics (predefinita), `1` = BitImageRaster, `2` = BitImageColumn. Vedi Immagine e logo.
`printer_print_mode`	`string`	Codice numerico della modalità di stampa della stampante (configurazione specifica del dispositivo).

ℹ️ printer_status è un flag di attivazione, non un controllo di connettività in tempo reale. 0 significa che la stampante è stata sospesa da ExpedyPRINT — di solito per un problema di pagamento o una violazione delle nostre condizioni d'uso — e non stamperà finché non verrà riattivata. Per verificare che un dispositivo attivo sia fisicamente raggiungibile e stampi, invia una stampa di prova invece di affidarti a questo campo.

Esempio di risposta:

[
  {
    "printer_uid": "UP3VS5JXRYA",
    "printer_name": "Lobby",
    "printer_status": "1",
    "printer_width": "58",
    "printer_graphic_mode": "0",
    "printer_print_mode": "0"
  },
  {
    "printer_uid": "MMAAZ112PI",
    "printer_name": "Kitchen",
    "printer_status": "1",
    "printer_width": "80",
    "printer_graphic_mode": "0",
    "printer_print_mode": "0"
  },
  {
    "printer_uid": "8L35EGFH8S7",
    "printer_name": "Warehouse",
    "printer_status": "1",
    "printer_width": "104",
    "printer_graphic_mode": "0",
    "printer_print_mode": "1"
  }
]

Errori

Qualsiasi stato diverso da 2xx restituisce un involucro JSON con un campo message:

{
  "message": "Missing ExpedyPRINT API credentials (SID / token)."
}

Stato	Significato
`401` / `403`	Credenziali mancanti o non valide (`SID` / `TOKEN`).

Leggi sempre il campo message invece di affidarti al solo codice di stato.

Passo successivo

Una volta ottenuto un printer_uid, inviagli del contenuto:

POST https://www.expedy.fr/api/v2/printers/{printer_uid}/print

Vedi il riferimento dell'endpoint di stampa per il corpo della richiesta e i tag di layout.

SDK ed esempi

Preferisci un client pronto all'uso? Usa l'SDK ufficiale Node.js: incapsula l'autenticazione e l'elenco delle stampanti:

👉 github.com/ExpedyDev/expedy-sdk-node