Druckaufträge auflisten

Rufen Sie aktuelle Druckaufträge mit Cursor-Paginierung für Betriebsansichten und Supportwerkzeuge ab.

GET/api/v1/print-jobsAPI-Version: v1operationId: listPrintJobsAls Markdown anzeigen

Funktion dieser Methode

Rufen Sie aktuelle Druckaufträge mit Cursor-Paginierung für Betriebsansichten und Supportwerkzeuge ab.

Authentifizierung

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

Erforderliche Scopes: print_jobs:read

Anfrage

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

Parameter

Name	Position	Typ	Erforderlich	Beschreibung	Einschränkungen
`limit`	query	`integer`	nein	Höchstzahl der Ressourcen auf einer Ergebnisseite.	min: 1; max: 100; default: `20`
`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/print-jobs?limit=20' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Antwort

HTTP-Status: 200 — Anfrage erfolgreich.

Antwortfelder

Name	Typ	Erforderlich	Beschreibung	Einschränkungen
`print_jobs`	`array`	ja	Druckaufträge für das aktuelle Konto und die gewählten Filter.	—
`next_cursor`	`string \| null`	ja	Opaker Cursor für die nächste Ergebnisseite; senden Sie ihn unverändert zurück.	—

Beispielantwort

json

{
  "print_jobs": [
    {
      "print_job_id": "11111111-1111-4111-8111-111111111111",
      "document_id": "11111111-1111-4111-8111-111111111111",
      "document_mime_type": "application/pdf",
      "document_format": "pdf",
      "document_raw_language": null,
      "printer_id": "11111111-1111-4111-8111-111111111111",
      "status": "pending",
      "copies": 1,
      "intent": "shipping_label",
      "color_mode": "default",
      "duplex_mode": "default",
      "media_width_mm": 58,
      "media_height_mm": 40,
      "dpi": 203,
      "scale_mode": "none",
      "orientation": "default",
      "offset_x_mm": 0,
      "offset_y_mm": 0,
      "margin_top_mm": 0,
      "margin_right_mm": 0,
      "margin_bottom_mm": 0,
      "margin_left_mm": 0,
      "created_at": "2026-08-06T12:00:00Z",
      "reserved_at": "2026-08-06T12:00:00Z",
      "started_at": "2026-08-06T12:00:00Z",
      "completed_at": "2026-08-06T12:00:00Z",
      "failure_reason": "string"
    }
  ],
  "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

Übergeben Sie next_cursor unverändert.
Nutzen Sie die Liste für Betrieb und Support; bekannte Aufträge rufen Sie direkt per ID ab.

Druckaufträge auflisten ​

Funktion dieser Methode ​

Authentifizierung ​

Anfrage ​

Parameter ​

Anfrageinhalt ​

Anfragebeispiele ​

cURL ​

Antwort ​

Antwortfelder ​

Beispielantwort ​

Fehler ​

Hinweise zur Integration ​

Verwandte Dokumentation ​