---
title: "Fehler und Wiederholungen der CloudPrint API"
description: "Behandeln Sie HTTP-Statuscodes, maschinenlesbare Fehler, Anfragelimits, Anfrageverfolgung und sichere Wiederholungslogik."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Fehler und Wiederholungen der CloudPrint API

<p class="docs-lead">Behandeln Sie HTTP-Statuscodes, maschinenlesbare Fehler, Anfragelimits, Anfrageverfolgung und sichere Wiederholungslogik.</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/errors/index.md">Als Markdown anzeigen</a></div>

## Stabile Fehlerstruktur

Fehler enthalten `error`, optional `error_code`, eine sichere `message` und strukturierte `details`. Steuern Sie Ihre Logik über maschinenlesbare Felder und den HTTP-Status.

## Anfragen verfolgen

Jede Antwort enthält `X-Request-Id`; speichern Sie ihn zusammen mit Ihrer internen ID, `print_job_id` und dem Zeitstempel.

## Wiederholungen

Wiederholen Sie einen `429` nach der in `Retry-After` angegebenen Wartezeit und temporäre `5xx` mit begrenzter exponentieller Verzögerung. Korrigieren Sie Authentifizierung, Scopes, Daten oder Format, bevor Sie andere Anfragen wiederholen.

## Druckfehler

Eine angenommene Anfrage kann dennoch in `failed` enden. Lesen Sie `failure_reason` und vergleichen Sie Format und Optionen mit den Druckerfunktionen.

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/v1/idempotency/"><strong>Idempotentes Erstellen von Druckaufträgen</strong><span>Verhindern Sie doppelte Ausdrucke, wenn Anfragen nach Timeout oder Netzwerkfehler wiederholt werden.</span></a>
<a class="docs-card" href="/de/docs/troubleshooting/"><strong>Fehlerbehebung</strong><span>Untersuchen Sie fehlgeschlagene Druckaufträge, ohne versehentlich eine zweite Kopie zu erzeugen.</span></a>
<a class="docs-card" href="/de/docs/api/v1/explorer/"><strong>Explorer für die CloudPrint API v1</strong><span>Untersuchen Sie interaktiv den vollständigen OpenAPI-v1-Vertrag, Schemas und Codebeispiele.</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>