Перейти к содержанию

CloudPrintПечать на локальных принтерах из вашего приложения

Подключите агент CloudPrint, отправляйте задания со своего сервера через Public API и отслеживайте каждое до конечного статуса.

Это карта документации CloudPrint. Для первой интеграции начните с быстрого старта, по руководствам изучите весь процесс, а во время разработки используйте версионированный справочник API.

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

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

  1. Разберитесь в процессе печати

    Узнайте, что выполняется на вашем сервере, в CloudPrint и на компьютере рядом с принтером.

  2. Авторизуйте сервер

    Создайте учётные данные API и обменяйте их на короткоживущий токен доступа OAuth2.

  3. Подключите агент и выберите принтер

    Получите доступные очереди печати и сохраните стабильный printer_id.

  4. Подготовьте документ к печати

    Загрузите PDF или RAW-данные, явно указав язык принтера.

  5. Создайте и проверьте задание

    Используйте идемпотентность, сохраните `print_job_id` и опрашивайте задание до конечного статуса.

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

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

Справочник CloudPrint API v1Версионированная документация CloudPrint API по авторизации, принтерам, документам, заданиям, ошибкам и безопасным повторам.Ошибки и повторы CloudPrint APIОбрабатывайте HTTP-статусы, машиночитаемые ошибки, ограничения частоты запросов, трассировку и безопасные повторы.Идемпотентное создание заданийПредотвращайте двойную печать при повторе запросов после превышения времени ожидания или сетевого сбоя.Диагностика агентов, принтеров и заданийНаходите причину ошибок CloudPrint по идентификатору запроса, статусу задания, подключению агента, возможностям принтера и коду API.Печать из веб-приложения на локальный принтерДобавьте локальную печать в SaaS или веб-приложение без открытых портов принтера и системного диалога браузера.Печать транспортных этикеток из вашей системыПередавайте созданные перевозчиком PDF- или ZPL-этикетки из интернет-магазина, WMS или ERP на нужный локальный принтер.

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

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

Руководства по интеграции CloudPrint, подключению локального агента и надёжной работе печати.