Получить статистику управляемых аккаунтов
Получите количество управляемых аккаунтов, активных агентов и заданий печати за календарный месяц UTC.
Назначение метода
Получите количество управляемых аккаунтов, активных агентов и заданий печати за календарный месяц UTC.
Авторизация
Передавайте одноразовое JWT-подтверждение Developer Application, подписанное RS256, в Authorization: Bearer <application_assertion>. Это не токен доступа к Public API.
Запрос
Основной адрес API: https://public-api.cloudprint.me/partner-api/v1/usage
Параметры
| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|---|
period | query | string | нет | Календарный месяц UTC в формате YYYY-MM, за который рассчитано использование. | example: "2026-08" |
X-Request-Id | header | string | нет | Необязательный идентификатор для трассировки запроса; CloudPrint вернёт безопасное значение в заголовке ответа. | maxLength: 128; example: "order-100045-attempt-1" |
Тело запроса
У метода нет тела запроса.
Примеры запросов
cURL
bash
curl -sS 'https://public-api.cloudprint.me/partner-api/v1/usage?period=2026-08' \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Ответ
HTTP-статус: 200 — Запрос выполнен.
Поля ответа
| Имя | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|
period | string | да | Календарный месяц UTC в формате YYYY-MM, за который рассчитано использование. | — |
starts_at | string (date-time) | да | Временная метка CloudPrint в формате ISO 8601. | — |
ends_at | string (date-time) | да | Временная метка CloudPrint в формате ISO 8601. | — |
managed_accounts | integer | да | Количество управляемых клиентских аккаунтов за расчётный период. | min: 0 |
active_agents | integer | да | Количество активных агентов за выбранный календарный месяц UTC. | min: 0 |
print_jobs | integer | да | Задания печати текущего аккаунта с учётом фильтров. | min: 0 |
Пример ответа
json
{
"period": "2026-08",
"starts_at": "2026-08-06T12:00:00Z",
"ends_at": "2026-08-06T12:00:00Z",
"managed_accounts": 0,
"active_agents": 0,
"print_jobs": 0
}Ошибки
| HTTP-статус | Описание |
|---|---|
401 | Авторизация отсутствует или недействительна. |
403 | Для операции недостаточно разрешений. |
422 | Поля запроса не прошли проверку. |
429 | Превышен лимит запросов; учитывайте Retry-After. |
500 | Внутренняя ошибка CloudPrint. |
Связанная документация
Создание и управление аккаунтами клиентовАвторизуйте запросы Partner API, создавайте управляемые аккаунты, приостанавливайте, возобновляйте или закрывайте их.Получить управляемые аккаунты клиентовПолучите аккаунты клиентов, созданные авторизованным Developer Application, включая состояние агентов и принтеров.Ошибки и повторы CloudPrint APIОбрабатывайте HTTP-статусы, машиночитаемые ошибки, ограничения частоты запросов, трассировку и безопасные повторы.