Получить Agent Enrollments

Получите pending, claimed, expired и revoked Agent Enrollments без секретных кодов.

GET/partner-api/v1/accounts/{relationshipId}/agent-enrollmentsВерсия API: v1operationId: listPartnerAgentEnrollmentsОткрыть в Markdown

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

Получите pending, claimed, expired и revoked Agent Enrollments без секретных кодов.

Авторизация

Передавайте одноразовый RS256 assertion Developer Application в Authorization: Bearer <application_assertion>. Это не токен доступа к Public API.

Запрос

Основной адрес API: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agent-enrollments

Параметры

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

Тело запроса

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

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

cURL

bash

curl -sS "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/agent-enrollments" \
  -H "Authorization: Bearer $APPLICATION_ASSERTION"

Ответ

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

Поля ответа

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

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

json

{
  "data": [
    {
      "agent_enrollment_id": "11111111-1111-4111-8111-111111111111",
      "name": "string",
      "status": "pending",
      "expires_at": "2026-08-06T12:00:00Z",
      "created_at": "2026-08-06T12:00:00Z",
      "agent_id": null,
      "claimed_at": null,
      "revoked_at": null
    }
  ],
  "next_cursor": null
}

Ошибки

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

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

Создать Agent EnrollmentВыпустите идемпотентный одноразовый Enrollment до или после onboarding клиента.Получить один Agent EnrollmentПроверьте конкретное одноразовое подключение управляемого клиента и свяжите его с подключённым Agent.Подключение агента клиентаПодключите локальный CloudPrint Agent к правильному управляемому аккаунту без входа клиента в кабинет CloudPrint.

Получить Agent Enrollments ​

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

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

Запрос ​

Параметры ​

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

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

cURL ​

Ответ ​

Поля ответа ​

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

Ошибки ​

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

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