---
title: "Идемпотентное создание заданий"
description: "Предотвращайте двойную печать при повторе запросов после превышения времени ожидания или сетевого сбоя."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/docs/">Документация CloudPrint</a><span aria-hidden="true">/</span><span>Справочник API</span></nav>

# Идемпотентное создание заданий

<p class="docs-lead">Предотвращайте двойную печать при повторе запросов после превышения времени ожидания или сетевого сбоя.</p>

<div class="api-reference-actions"><span><strong>Версия API:</strong> v1</span><a href="/docs/api/v1/openapi.json">Скачать OpenAPI v1 в формате JSON</a><a href="/docs/api/v1/explorer/">Открыть интерактивный справочник API</a><a href="/docs/api/v1/idempotency/index.md">Открыть в Markdown</a></div>

## Зачем печати идемпотентность

Время ожидания может истечь после того, как CloudPrint принял запрос, но до того, как ваша серверная часть получила ответ. Создание нового задания в этот момент способно напечатать документ дважды.

## Как построить ключ

Используйте стабильный ключ бизнес-операции, например `shipment-18451-label-v1`. Он должен быть не длиннее 128 символов и оставаться одинаковым при повторе запроса с теми же данными. Намеренная повторная печать считается новой операцией и получает новый ключ.

## Правила повторного использования

Для одного аккаунта одинаковые ключ и данные возвращают исходный результат. Тот же ключ с другими данными приводит к `409 Conflict`. Сохраняйте ключ до первого запроса.

## Восстановление после неопределённости

После сетевого сбоя повторите тот же запрос с тем же ключом. Получив `print_job_id`, сохраните его и проверяйте статус вместо создания нового задания.

## Связанная документация

<div class="docs-card-grid"><a class="docs-card" href="/docs/api/v1/print-jobs/create/"><strong>Создать задание печати</strong><span>Отправьте загруженный документ CloudPrint на выбранный принтер с идемпотентностью и явными параметрами.</span></a>
<a class="docs-card" href="/docs/api/v1/errors/"><strong>Ошибки и повторы CloudPrint API</strong><span>Обрабатывайте HTTP-статусы, машиночитаемые ошибки, ограничения частоты запросов, трассировку и безопасные повторы.</span></a>
<a class="docs-card" href="/docs/api/print-jobs/"><strong>Создание и отслеживание заданий печати</strong><span>Создавайте идемпотентные задания CloudPrint, проверяйте параметры принтера и отслеживайте результат до конечного статуса.</span></a></div>

<nav class="docs-resource-links" aria-label="Следующие шаги"><a href="/docs/api/v1/explorer/">OpenAPI</a><a href="https://my.cloudprint.by">Открыть кабинет</a><a href="/docs/legal/privacy/">Политика конфиденциальности</a><a href="/docs/legal/terms/">Условия использования</a><a href="/docs/legal/payments-and-refunds/">Оплата и возврат</a><a href="/docs/legal/data-processing/">DPA</a></nav>