Dokumentacja CloudPrint/Dokumentacja API

Błędy i ponowienia CloudPrint API

Obsługuj statusy HTTP, błędy maszynowe, limity, identyfikatory żądań i bezpieczne ponowienia.

Wersja API: v1Pobierz OpenAPI v1 w formacie JSONOtwórz interaktywną dokumentację APIOtwórz w Markdown

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

Idempotentne tworzenie zadańZapobiegaj podwójnemu drukowi podczas ponawiania żądań po przekroczeniu limitu czasu lub błędzie sieci.Diagnostyka agentów, drukarek i zadańZnajdź przyczynę problemu na podstawie identyfikatora żądania, statusu zadania, połączenia agenta, możliwości drukarki i kodu API.Interaktywny CloudPrint API v1Interaktywny podgląd pełnego kontraktu OpenAPI CloudPrint API v1, schematów i przykładów.

OpenAPIOtwórz panelPolityka prywatnościRegulaminPłatności i zwrotyDPA