Verfügbare Drucker auflisten

Rufen Sie die über verbundene Agents sichtbaren Drucker ab und wählen Sie eine stabile Drucker-ID für Ihre Integration.

GET/api/v1/printersAPI-Version: v1operationId: listPrintersAls Markdown anzeigen

Funktion dieser Methode

Rufen Sie die über verbundene Agents sichtbaren Drucker ab und wählen Sie eine stabile Drucker-ID für Ihre Integration.

Authentifizierung

Senden Sie ein kurzlebiges Token in Authorization: Bearer <access_token>.

Erforderliche Scopes: printers:read

Anfrage

Produktions-URL: https://public-api.cloudprint.me/api/v1/printers

Parameter

Name	Position	Typ	Erforderlich	Beschreibung	Einschränkungen
`limit`	query	`integer`	nein	Höchstzahl der Ressourcen auf einer Ergebnisseite.	min: 1; max: 100; default: `100`
`cursor`	query	`string \| null`	nein	Opaker Cursor der angefragten Ergebnisseite; senden Sie ihn unverändert zurück.	—
`X-Request-Id`	header	`string`	nein	Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück.	maxLength: 128; example: `"order-100045-attempt-1"`

Anfrageinhalt

Die Methode hat keinen Anfrageinhalt.

Anfragebeispiele

cURL

bash

curl -sS 'https://public-api.cloudprint.me/api/v1/printers?limit=100' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Antwort

HTTP-Status: 200 — Anfrage erfolgreich.

Antwortfelder

Name	Typ	Erforderlich	Beschreibung	Einschränkungen
`printers`	`array`	ja	Drucker, die von Agents des aktuellen Kontos erkannt wurden.	—
`next_cursor`	`string \| null`	ja	Opaker Cursor für die nächste Ergebnisseite; senden Sie ihn unverändert zurück.	—

Beispielantwort

json

{
  "printers": [
    {
      "printer_id": "11111111-1111-4111-8111-111111111111",
      "agent_id": "11111111-1111-4111-8111-111111111111",
      "local_identifier": "zebra-zd421-usb-001",
      "name": "Warehouse Label Printer",
      "status": "online",
      "last_seen_at": "2026-08-06T12:00:00Z",
      "agent_name": "Warehouse PC agent",
      "agent_hostname": "warehouse-pc",
      "agent_status": "online",
      "agent_last_seen_at": "2026-08-06T12:00:00Z",
      "capabilities": {
        "backend": "windows_native",
        "language_profiles": [
          {
            "language": "zpl",
            "version": "zpl2",
            "supported_commands": [
              "gf"
            ],
            "max_bitmap_width_dots": 812,
            "max_bitmap_height_dots": 1199,
            "compression_modes": [
              "ascii-hex"
            ],
            "codepage": "utf-8"
          }
        ],
        "supports_custom_media": true,
        "supports_orientation": true,
        "supports_copies": true,
        "supports_duplex": true,
        "supports_color": true,
        "supports_scaling": true,
        "supports_offsets": true,
        "supports_printable_area": true,
        "supported_dpi": [
          1
        ],
        "supported_media_sizes": [
          {
            "width_mm": 0,
            "height_mm": 0
          }
        ],
        "supported_feed_types": [
          "gap"
        ],
        "darkness_min": 0,
        "darkness_max": 30,
        "speed_min": 1,
        "speed_max": 14
      },
      "endpoint": {
        "system_print_available": true,
        "raw_passthrough_available": true,
        "configuration_issue": "interactive_output_port",
        "os": "linux",
        "driver_name": "CUPS",
        "port_name": "ipp://printer.local/ipp/print",
        "print_processor": "cups",
        "data_type": "RAW",
        "connection_type": "cups",
        "default_media_profile_id": "string",
        "default_media_profile": {
          "width_mm": 100,
          "height_mm": 150,
          "dpi": 203,
          "orientation": "default",
          "feed_type": "gap",
          "darkness": 15,
          "speed": 4
        }
      }
    }
  ],
  "next_cursor": "string"
}

Fehler

HTTP-Status	Beschreibung
`401`	Authentifizierung fehlt oder ist ungültig.
`403`	Das Token hat nicht die erforderlichen Berechtigungen.
`422`	Mindestens ein Feld ist ungültig.
`429`	Anfragelimit überschritten; beachten Sie Retry-After.
`500`	Interner CloudPrint-Fehler.

Hinweise zur Integration

Speichern Sie printer_id; der lokale Warteschlangenname kann sich ändern.
Prüfen Sie Status, Funktionen und Verbindungsdaten, bevor Sie RAW-, Duplex-, Farb-, Medien- oder DPI-Optionen anbieten.

Verfügbare Drucker auflisten ​

Funktion dieser Methode ​

Authentifizierung ​

Anfrage ​

Parameter ​

Anfrageinhalt ​

Anfragebeispiele ​

cURL ​

Antwort ​

Antwortfelder ​

Beispielantwort ​

Fehler ​

Hinweise zur Integration ​

Verwandte Dokumentation ​