Агент подключается к CloudPrint сам и передаёт сведения о доступных системных очередях печати. Ваша система получает их состояние через Public API, сохраняет выбранный `printer_id` и перед печатью проверяет возможности принтера.
## Проверьте состояние агента ```bash curl -sS 'https://public-api.cloudprint.me/api/v1/agents?limit=50' \ -H "Authorization: Bearer $ACCESS_TOKEN" ``` ```json { "agents": [ { "agent_id": "22222222-2222-4222-8222-222222222222", "name": "Warehouse PC agent", "status": "online", "hostname": "warehouse-pc", "version": "0.1.1", "update": { "status": "up_to_date", "current_version": "0.1.1", "latest_version": "0.1.1", "minimum_supported_version": "0.1.0", "channel": "stable", "required": false }, "last_seen_at": "2026-06-08T10:10:00+00:00" } ], "next_cursor": null } ``` Для получения списка нужно разрешение `agents:read`. Агент должен иметь статус `online`. При диагностике также проверяйте `update.required` и сведения о версии. ## Получите принтеры ```bash curl -sS 'https://public-api.cloudprint.me/api/v1/printers?limit=100' \ -H "Authorization: Bearer $ACCESS_TOKEN" ``` Сокращённый ответ с полями выбора: ```json { "printers": [ { "printer_id": "11111111-1111-4111-8111-111111111111", "agent_id": "22222222-2222-4222-8222-222222222222", "name": "Warehouse Label Printer", "status": "online", "agent_name": "Warehouse PC agent", "agent_status": "online", "capabilities": { "backend": "windows_native", "language_profiles": [ { "language": "zpl", "version": "zpl2" } ], "supports_custom_media": true, "supports_orientation": true, "supports_copies": true, "supported_dpi": [ 203 ] }, "endpoint": { "system_print_available": true, "raw_passthrough_available": true, "os": "windows", "driver_name": "ZDesigner ZD421-203dpi ZPL", "connection_type": "windows_spooler" } } ], "next_cursor": null } ``` ## Сохраните правильный ID Храните `printer_id` в настройке филиала, упаковочного места или процесса. Администратору показывайте `name`, `agent_name` и статус, но не маршрутизируйте по имени. После пересоздания системной очереди требуйте повторное назначение и тест. ## Проверьте возможности принтера Для RAW нужен подходящий `language_profiles[*].language` и значение `raw_passthrough_available=true`. Для PDF должна быть доступна системная печать или поддерживаемое CloudPrint преобразование. Перед использованием нестандартного режима цвета, двусторонней печати, ориентации, количества копий, размера носителя, масштаба, смещения или DPI проверьте соответствующие поля возможностей. ## Пагинация и недоступные принтеры Оба списка возвращают `next_cursor`. Запрашивайте `?limit=100&cursor=VALUE`, пока не получите `null`. Не создавайте автоматическое задание для принтера, который не в сети, если продукт явно не поддерживает очередь; не выбирайте молча принтер другого филиала. ## Что означают данные подключения Поля драйвера, порта, операционной системы и типа подключения описывают локальную очередь печати и нужны для диагностики. Это не адрес, который должен вызывать ваш сервер. Учётные данные в URI устройства скрываются перед выдачей ответа. ## Чек-лист перед запуском - Используйте исходящее подключение агента и не открывайте порты принтера в интернет. - Сохраняйте стабильный идентификатор принтера, а не только отображаемое имя. - Проверяйте формат документа, размер страницы и ориентацию до создания задания. - Явно задайте обработку конечных статусов, повторов и защиту от двойной печати. ## Следующие шаги