---
title: "Idempotentne tworzenie zadań"
description: "Zapobiegaj podwójnemu drukowi podczas ponawiania żądań po przekroczeniu limitu czasu lub błędzie sieci."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/pl/docs/">Dokumentacja CloudPrint</a><span aria-hidden="true">/</span><span>Dokumentacja API</span></nav>

# Idempotentne tworzenie zadań

<p class="docs-lead">Zapobiegaj podwójnemu drukowi podczas ponawiania żądań po przekroczeniu limitu czasu lub błędzie sieci.</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/idempotency/index.md">Otwórz w Markdown</a></div>

## Dlaczego druk wymaga idempotencji

Limit czasu może zostać przekroczony po przyjęciu żądania przez CloudPrint, ale przed otrzymaniem odpowiedzi przez serwer klienta. Utworzenie nowego zadania w tym momencie może wydrukować dokument dwa razy.

## Budowa klucza

Użyj stabilnego klucza operacji, np. `shipment-18451-label-v1`. Musi mieć nie więcej niż 128 znaków i pozostać identyczny dla ponowień z tymi samymi danymi. Celowy ponowny wydruk jest nową operacją i wymaga nowego klucza.

## Zasady ponownego użycia

Dla tego samego konta identyczne klucz i dane zwracają pierwotny wynik. Ten sam klucz z innymi danymi zwraca `409 Conflict`. Zapisz klucz przed pierwszym żądaniem.

## Odzyskiwanie po niepewności

Po błędzie sieci ponów to samo żądanie z tym samym kluczem. Po otrzymaniu `print_job_id` zapisz go i odczytuj stan zamiast tworzyć nowe zadanie.

## Powiązana dokumentacja

<div class="docs-card-grid"><a class="docs-card" href="/pl/docs/api/v1/print-jobs/create/"><strong>Utwórz zadanie druku</strong><span>Wyślij przesłany dokument CloudPrint na wybraną drukarkę z idempotencją i jawnymi opcjami.</span></a>
<a class="docs-card" href="/pl/docs/api/v1/errors/"><strong>Błędy i ponowienia CloudPrint API</strong><span>Obsługuj statusy HTTP, błędy maszynowe, limity, identyfikatory żądań i bezpieczne ponowienia.</span></a>
<a class="docs-card" href="/pl/docs/api/print-jobs/"><strong>Tworzenie i śledzenie zadań druku</strong><span>Twórz idempotentne zadania CloudPrint, sprawdzaj opcje drukarki i bezpiecznie śledź je aż do stanu końcowego.</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>