---
layout: home
title: "Документация CloudPrint"
description: "Подключите CloudPrint к бизнес-системе: установите локальный агент, выберите принтер, отправьте документ и отследите результат печати."
sidebar: false
aside: false
outline: false
hero:
  name: "CloudPrint"
  text: "Печать на локальных принтерах из вашего приложения"
  tagline: "Подключите агент CloudPrint, отправляйте задания со своего сервера через Public API и отслеживайте каждое до конечного статуса."
  actions:
    - theme: brand
      text: "Отправить первое задание"
      link: "/docs/getting-started/"
    - theme: alt
      text: "Открыть API v1"
      link: "/docs/api/v1/"
features:
  - title: "Быстрый старт"
    details: "Пройдите весь путь от настройки аккаунта до напечатанного документа."
    link: "/docs/getting-started/"
    linkText: "Открыть раздел"
  - title: "Print API"
    details: "Авторизуйтесь через API Credentials, выберите принтер и создавайте надёжные задания печати."
    link: "/docs/api/overview/"
    linkText: "Открыть раздел"
  - title: "Developer Platform"
    details: "Создайте одно приложение, которое клиенты устанавливают в свои аккаунты CloudPrint."
    link: "/docs/developer-platform/"
    linkText: "Открыть раздел"
  - title: "Partner Platform"
    details: "Создавайте и обслуживайте изолированные аккаунты CloudPrint для своих клиентов."
    link: "/docs/partner-platform/"
    linkText: "Открыть раздел"
---

<div class="docs-home-intro">
<p>Это карта документации CloudPrint. Для первой интеграции начните с быстрого старта, по руководствам изучите весь процесс, а во время разработки используйте версионированный справочник API.</p>
</div>

## Путь до первого выполненного задания

Для надёжной первой печати пройдите эти шаги по порядку. В каждом разделе разобраны API-запрос и проверки, необходимые для рабочей системы.

<ol class="docs-journey"><li class="docs-journey-step"><span class="docs-journey-number" aria-hidden="true">1</span><div><a href="/docs/concepts/remote-printing/"><strong>Разберитесь в процессе печати</strong></a><p>Узнайте, что выполняется на вашем сервере, в CloudPrint и на компьютере рядом с принтером.</p></div></li>
<li class="docs-journey-step"><span class="docs-journey-number" aria-hidden="true">2</span><div><a href="/docs/api/authentication/"><strong>Авторизуйте сервер</strong></a><p>Создайте учётные данные API и обменяйте их на короткоживущий токен доступа OAuth2.</p></div></li>
<li class="docs-journey-step"><span class="docs-journey-number" aria-hidden="true">3</span><div><a href="/docs/api/agents-and-printers/"><strong>Подключите агент и выберите принтер</strong></a><p>Получите доступные очереди печати и сохраните стабильный printer_id.</p></div></li>
<li class="docs-journey-step"><span class="docs-journey-number" aria-hidden="true">4</span><div><a href="/docs/api/documents/"><strong>Подготовьте документ к печати</strong></a><p>Загрузите PDF или RAW-данные, явно указав язык принтера.</p></div></li>
<li class="docs-journey-step"><span class="docs-journey-number" aria-hidden="true">5</span><div><a href="/docs/api/print-jobs/"><strong>Создайте и проверьте задание</strong></a><p>Используйте идемпотентность, сохраните `print_job_id` и опрашивайте задание до конечного статуса.</p></div></li></ol>

## Справочник и запуск в рабочей среде

Используйте эти страницы после первой печати: при реализации конкретного сценария или подготовке интеграции к запуску.

<div class="docs-card-grid"><a class="docs-card" href="/docs/api/v1/"><strong>Справочник CloudPrint API v1</strong><span>Версионированная документация CloudPrint API по авторизации, принтерам, документам, заданиям, ошибкам и безопасным повторам.</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/v1/idempotency/"><strong>Идемпотентное создание заданий</strong><span>Предотвращайте двойную печать при повторе запросов после превышения времени ожидания или сетевого сбоя.</span></a>
<a class="docs-card" href="/docs/troubleshooting/"><strong>Диагностика агентов, принтеров и заданий</strong><span>Находите причину ошибок CloudPrint по идентификатору запроса, статусу задания, подключению агента, возможностям принтера и коду API.</span></a>
<a class="docs-card" href="/docs/guides/web-app-printing/"><strong>Печать из веб-приложения на локальный принтер</strong><span>Добавьте локальную печать в SaaS или веб-приложение без открытых портов принтера и системного диалога браузера.</span></a>
<a class="docs-card" href="/docs/guides/shipping-labels/"><strong>Печать транспортных этикеток из вашей системы</strong><span>Передавайте созданные перевозчиком PDF- или ZPL-этикетки из интернет-магазина, WMS или ERP на нужный локальный принтер.</span></a></div>

## Что ваша система передаёт в CloudPrint

<div class="docs-boundary"><p>Ваш сервер обращается к CloudPrint Public API. Локальный агент поддерживает исходящее соединение и передаёт на выбранный принтер готовый PDF или RAW-данные с явно указанным языком принтера. CloudPrint не создаёт этикетки перевозчиков, а порты принтера не нужно открывать в интернет.</p></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>