Получить список заданий печати

Получите последние задания CloudPrint с курсорной пагинацией для интерфейсов и поддержки.

GET/api/v1/print-jobsВерсия API: v1operationId: listPrintJobsОткрыть в Markdown

Назначение метода

Получите последние задания CloudPrint с курсорной пагинацией для интерфейсов и поддержки.

Авторизация

Передавайте короткоживущий токен в Authorization: Bearer <access_token>.

Обязательные разрешения: print_jobs:read

Запрос

Основной адрес API: https://public-api.cloudprint.me/api/v1/print-jobs

Параметры

Имя	Расположение	Тип	Обязательно	Описание	Ограничения
`limit`	query	`integer`	нет	Поле контракта API; учитывайте указанные тип и ограничения.	min: 1; max: 100; default: `20`
`cursor`	query	`string \| null`	нет	Поле контракта API; учитывайте указанные тип и ограничения.	—

Тело запроса

У метода нет тела запроса.

Примеры запросов

cURL

bash

curl -sS 'https://public-api.cloudprint.me/api/v1/print-jobs?limit=20' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Ответ

HTTP-статус: 200 — Запрос выполнен.

Поля ответа

Имя	Тип	Обязательно	Описание	Ограничения
`print_jobs`	`array`	да	Задания печати текущего аккаунта с учётом фильтров.	—
`next_cursor`	`string \| null`	да	Непрозрачный cursor следующей страницы; передавайте его без изменений.	—

Пример ответа

json

{
  "print_jobs": [
    {
      "print_job_id": "11111111-1111-4111-8111-111111111111",
      "document_id": "11111111-1111-4111-8111-111111111111",
      "document_mime_type": "application/pdf",
      "document_format": "pdf",
      "document_raw_language": null,
      "printer_id": "11111111-1111-4111-8111-111111111111",
      "status": "pending",
      "copies": 1,
      "intent": "shipping_label",
      "color_mode": "default",
      "duplex_mode": "default",
      "media_width_mm": 58,
      "media_height_mm": 40,
      "dpi": 203,
      "scale_mode": "none",
      "orientation": "default",
      "offset_x_mm": 0,
      "offset_y_mm": 0,
      "margin_top_mm": 0,
      "margin_right_mm": 0,
      "margin_bottom_mm": 0,
      "margin_left_mm": 0,
      "created_at": "2026-08-06T12:00:00Z",
      "reserved_at": null,
      "started_at": null,
      "completed_at": null,
      "failure_reason": null
    }
  ],
  "next_cursor": null
}

Ошибки

HTTP-статус	Описание
`401`	Авторизация отсутствует или недействительна.
`403`	Для операции недостаточно разрешений.
`422`	Поля запроса не прошли проверку.
`429`	Превышен лимит запросов; учитывайте Retry-After.
`500`	Внутренняя ошибка CloudPrint.

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

Получить статус задания печатиПолучайте состояние задания CloudPrint, пока оно не перейдёт в конечный статус printed или failed.Создание и отслеживание заданий печатиСоздавайте идемпотентные задания CloudPrint, проверяйте параметры принтера и отслеживайте результат до конечного статуса.Ошибки и повторы CloudPrint APIОбрабатывайте HTTP-статусы, машиночитаемые ошибки, ограничения частоты запросов, трассировку и безопасные повторы.

Получить список заданий печати ​

Назначение метода ​

Авторизация ​

Запрос ​

Параметры ​

Тело запроса ​

Примеры запросов ​

cURL ​

Ответ ​

Поля ответа ​

Пример ответа ​

Ошибки ​

Рекомендации по интеграции ​

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