Idempotentes Erstellen von Druckaufträgen
Verhindern Sie doppelte Ausdrucke, wenn Anfragen nach Timeout oder Netzwerkfehler wiederholt werden.
API-Version: v1OpenAPI v1 als JSON herunterladenIm interaktiven API Explorer öffnenAls Markdown anzeigen
Warum Idempotenz nötig ist
Ein Timeout kann auftreten, nachdem CloudPrint die Anfrage angenommen hat. Ein neuer Auftrag könnte das Dokument dann ein zweites Mal drucken.
Schlüssel festlegen
Verwenden Sie einen stabilen Schlüssel wie shipment-18451-label-v1 mit höchstens 128 Zeichen und behalten Sie ihn für denselben Inhalt bei.
Wiederverwendung
Dasselbe Konto, derselbe Schlüssel und derselbe Inhalt liefern das ursprüngliche Ergebnis; anderer Inhalt führt zu 409 Conflict.
Wiederherstellung
Wiederholen Sie die Anfrage nach einem Netzwerkfehler mit demselben Schlüssel. Sobald print_job_id bekannt ist, fragen Sie den Status ab, statt einen neuen Auftrag zu erstellen.
Verwandte Dokumentation
Druckauftrag erstellenSenden Sie ein hochgeladenes Dokument mit Idempotenz und expliziten Druckoptionen an einen ausgewählten Drucker.Fehler und Wiederholungen der CloudPrint APIBehandeln Sie HTTP-Statuscodes, maschinenlesbare Fehler, Anfragelimits, Anfrageverfolgung und sichere Wiederholungslogik.Druckaufträge erstellen und verfolgenSenden Sie ein Dokument an einen Drucker, vermeiden Sie Duplikate und prüfen Sie das physische Ergebnis.