Alle Drucker auflisten

Drucker auflisten

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

Gibt alle mit Ihrem Konto verbundenen Cloud-Drucker mit ihrer UID, ihrem Namen, ihrem Status und ihrer Konfiguration zurück. Verwenden Sie ihn, um die printer_uid zu ermitteln, die Sie zum Senden eines Druckauftrags benötigen.

Basis-URL: https://www.expedy.fr/api/v2

Authentifizierung

Dieser Endpunkt erfordert einen Authorization-Header, der Ihre SID und Ihren TOKEN enthält, getrennt durch einen einzelnen Doppelpunkt.

Authorization: <SID>:<TOKEN>

⚠️ Dies ist kein Bearer-Token. Fügen Sie kein Bearer- oder Basic-Präfix hinzu — senden Sie den rohen Wert SID:TOKEN.

Beide Werte finden Sie in der Expedy-Konsole unter API. Alle Anfragen müssen über HTTPS (TLS) erfolgen.

cURL-Beispiel:

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

Antwort `200 OK`

Gibt ein JSON-Array von Druckerobjekten zurück (leeres Array, wenn kein Drucker registriert ist).

Feld	Typ	Beschreibung
`printer_uid`	`string`	Eindeutige Kennung des Druckers. Dies ist der Wert, den Sie als `{printer_uid}` an den Druck-Endpunkt übergeben.
`printer_name`	`string`	Lesbare Bezeichnung, die in der Konsole festgelegt wird (z. B. `Kitchen`, `Lobby`).
`printer_status`	`string`	Aktivierungsstatus des Druckers. `1` = aktiv, `0` = gesperrt. Dies ist ein administratives Kennzeichen, das ausschließlich von ExpedyPRINT gesteuert wird — kein Echtzeit-Konnektivitätsindikator.
`printer_width`	`string`	Papierbreite in Millimetern: `58`, `80` oder `104`. Verwenden Sie sie, um Ihren Inhalt zu dimensionieren (32 / 48 Zeichen pro Zeile bei 58 / 80 mm).
`printer_graphic_mode`	`string`	In der Konsole konfigurierter Bildwiedergabemodus: `0` = Graphics (Standard), `1` = BitImageRaster, `2` = BitImageColumn. Siehe Bild und Logo.
`printer_print_mode`	`string`	Numerischer Code für den Druckmodus des Druckers (gerätespezifische Konfiguration).

ℹ️ printer_status ist ein Aktivierungskennzeichen, keine Echtzeit-Konnektivitätsprüfung. 0 bedeutet, dass der Drucker von ExpedyPRINT gesperrt wurde — in der Regel wegen eines Zahlungsproblems oder eines Verstoßes gegen unsere Nutzungsbedingungen — und er druckt erst wieder nach erneuter Aktivierung. Um zu überprüfen, ob ein aktives Gerät physisch erreichbar ist und druckt, senden Sie einen Testdruck, anstatt sich auf dieses Feld zu verlassen.

Beispielantwort:

[
  {
    "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"
  }
]

Fehler

Jeder Status, der nicht 2xx ist, gibt einen JSON-Umschlag mit einem message-Feld zurück:

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

Status	Bedeutung
`401` / `403`	Fehlende oder ungültige Zugangsdaten (`SID` / `TOKEN`).

Lesen Sie immer das message-Feld, anstatt sich allein auf den Statuscode zu verlassen.

Nächster Schritt

Sobald Sie eine printer_uid haben, senden Sie ihr Inhalte:

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

Siehe die Referenz des Druck-Endpunkts für den Anfragekörper und die Layout-Tags.

SDK & Beispiele

Bevorzugen Sie einen fertigen Client? Verwenden Sie das offizielle Node.js-SDK — es kapselt Authentifizierung und Druckerliste:

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