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

Получить версии CloudPrint Agent ​

Получите без авторизации актуальные установщики CloudPrint Agent и их контрольные суммы.

GET/agent-download-api/v1/releasesВерсия API: v1operationId: listPublicAgentReleasesОткрыть в Markdown

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

Получите без авторизации актуальные установщики CloudPrint Agent и их контрольные суммы.

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

Для этого метода Bearer-токен не нужен.

Запрос ​

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

Параметры ​

ИмяРасположениеТипОбязательноОписаниеОграничения
X-Request-IdheaderstringнетНеобязательный идентификатор для трассировки запроса; CloudPrint вернёт безопасное значение в заголовке ответа.maxLength: 128; example: "order-100045-attempt-1"

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

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

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

cURL ​

bash
curl -sS https://public-api.cloudprint.me/agent-download-api/v1/releases

Ответ ​

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

Поля ответа ​

ИмяТипОбязательноОписаниеОграничения
availablebooleanдаДоступен ли опубликованный установщик для выбранной платформы.—
channelstring | nullдаКанал выпуска, к которому относится эта сборка Agent.—
releasesarrayдаОпубликованные установщики Agent по поддерживаемым платформам.—
unavailable_reasonstring | nullнетПричина, по которой для этой платформы нет опубликованного установщика.—

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

json
{
  "available": true,
  "channel": "string",
  "releases": [
    {
      "version": "string",
      "channel": "string",
      "published_at": "2026-08-06T12:00:00Z",
      "installers": [
        {
          "filename": "string",
          "platform": "macos",
          "architecture": "string",
          "format": "string",
          "size_bytes": 1,
          "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
          "download_url": "/resource"
        }
      ]
    }
  ]
}

Ошибки ​

HTTP-статусОписание
429Превышен лимит запросов; учитывайте Retry-After.
500Внутренняя ошибка CloudPrint.
503Сервис временно недоступен.

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

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