---
title: "Idempotentes Erstellen von Druckaufträgen"
description: "Verhindern Sie doppelte Ausdrucke, wenn Anfragen nach Timeout oder Netzwerkfehler wiederholt werden."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Idempotentes Erstellen von Druckaufträgen

<p class="docs-lead">Verhindern Sie doppelte Ausdrucke, wenn Anfragen nach Timeout oder Netzwerkfehler wiederholt werden.</p>

<div class="api-reference-actions"><span><strong>API-Version:</strong> v1</span><a href="/docs/api/v1/openapi.json">OpenAPI v1 als JSON herunterladen</a><a href="/de/docs/api/v1/explorer/">Im interaktiven API Explorer öffnen</a><a href="/de/docs/api/v1/idempotency/index.md">Als Markdown anzeigen</a></div>

## 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

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/v1/print-jobs/create/"><strong>Druckauftrag erstellen</strong><span>Senden Sie ein hochgeladenes Dokument mit Idempotenz und expliziten Druckoptionen an einen ausgewählten Drucker.</span></a>
<a class="docs-card" href="/de/docs/api/v1/errors/"><strong>Fehler und Wiederholungen der CloudPrint API</strong><span>Behandeln Sie HTTP-Statuscodes, maschinenlesbare Fehler, Anfragelimits, Anfrageverfolgung und sichere Wiederholungslogik.</span></a>
<a class="docs-card" href="/de/docs/api/print-jobs/"><strong>Druckaufträge erstellen und verfolgen</strong><span>Senden Sie ein Dokument an einen Drucker, vermeiden Sie Duplikate und prüfen Sie das physische Ergebnis.</span></a></div>

<nav class="docs-resource-links" aria-label="Nächste Schritte"><a href="https://cloudprint.me/status/">Dienststatus</a><a href="/de/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Konto öffnen</a><a href="/docs/legal/privacy/">Datenschutzerklärung</a><a href="/docs/legal/terms/">Nutzungsbedingungen</a><a href="/docs/legal/payments-and-refunds/">Zahlungen und Erstattungen</a><a href="/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>