---
title: "Błędy i ponowienia CloudPrint API"
description: "Obsługuj statusy HTTP, błędy maszynowe, limity, identyfikatory żądań i bezpieczne ponowienia."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Dokumentacja API</span></nav>

# Błędy i ponowienia CloudPrint API

<p class="docs-lead">Obsługuj statusy HTTP, błędy maszynowe, limity, identyfikatory żądań i bezpieczne ponowienia.</p>

<div class="api-reference-actions"><span><strong>Wersja API:</strong> v1</span><a href="/docs/api/v1/openapi.json">Pobierz OpenAPI v1 w formacie JSON</a><a href="/pl/docs/api/v1/explorer/">Otwórz interaktywną dokumentację API</a><a href="/pl/docs/api/v1/errors/index.md">Otwórz w Markdown</a></div>

## Stała struktura błędu

Błędy zawierają `error`, opcjonalny `error_code`, bezpieczne wyjaśnienie `message` i ustrukturyzowane dane `details`. Steruj logiką na podstawie pól maszynowych i statusu HTTP, a nie tekstu komunikatu.

## Śledzenie żądań

Każda odpowiedź zawiera `X-Request-Id`. Zapisuj go razem z identyfikatorem biznesowym, `print_job_id` i czasem.

## Kiedy ponawiać żądanie

Ponawiaj `429` po czasie wskazanym w `Retry-After`, a przejściowe błędy `5xx` — z ograniczonym wykładniczym opóźnieniem. Po `401` odśwież token jeden raz. Po `403` popraw uprawnienia, po `400` lub `422` — dane żądania, a po `415` — format. Nie ponawiaj tworzenia zadania bez pierwotnego `Idempotency-Key`.

## Błędy podczas druku

Przyjęte żądanie API może nadal zakończyć się zadaniem ze statusem `failed`. Odczytaj `failure_reason` i porównaj format oraz opcje z możliwościami drukarki.

## Powiązana dokumentacja

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/api/v1/idempotency/"><strong>Idempotentne tworzenie zadań</strong><span>Zapobiegaj podwójnemu drukowi podczas ponawiania żądań po przekroczeniu limitu czasu lub błędzie sieci.</span></a>
<a class="docs-card" href="/pl/docs/troubleshooting/"><strong>Diagnostyka agentów, drukarek i zadań</strong><span>Znajdź przyczynę problemu na podstawie identyfikatora żądania, statusu zadania, połączenia agenta, możliwości drukarki i kodu API.</span></a>
<a class="docs-card" href="/pl/docs/api/v1/explorer/"><strong>Interaktywny CloudPrint API v1</strong><span>Interaktywny podgląd pełnego kontraktu OpenAPI CloudPrint API v1, schematów i przykładów.</span></a></div>

<nav class="docs-resource-links" aria-label="Następne kroki"><a href="/pl/docs/api/v1/explorer/">OpenAPI</a><a href="https://my.cloudprint.me">Otwórz panel</a><a href="/docs/legal/privacy/">Polityka prywatności</a><a href="/pl/docs/legal/terms/">Regulamin</a><a href="/pl/docs/legal/payments-and-refunds/">Płatności i zwroty</a><a href="/pl/docs/legal/data-processing/">DPA</a></nav>