Отозвать агента клиента
Отзовите потерянный или заменённый агент; его принтеры перейдут в статус `offline`.
DELETE
/partner-api/v1/accounts/{relationshipId}/agents/{agentId}Версия API: v1operationId: revokePartnerManagedAgentОткрыть в MarkdownНазначение метода
Отзовите потерянный или заменённый агент; его принтеры перейдут в статус offline.
Авторизация
Передавайте одноразовое JWT-подтверждение Developer Application, подписанное RS256, в Authorization: Bearer <application_assertion>. Это не токен доступа к Public API.
Запрос
Основной адрес API: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agents/{agentId}
Параметры
| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|---|
relationshipId | path | string (uuid) | да | Стабильный UUID связи партнёра с управляемым клиентом. | — |
agentId | path | string (uuid) | да | Стабильный UUID агента управляемого клиента, указанного в пути. | — |
X-Request-Id | header | string | нет | Необязательный идентификатор для трассировки запроса; CloudPrint вернёт безопасное значение в заголовке ответа. | maxLength: 128; example: "order-100045-attempt-1" |
Тело запроса
У метода нет тела запроса.
Примеры запросов
cURL
bash
curl -sS -X DELETE "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/agents/$AGENT_ID" \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Ответ
HTTP-статус: 204 — Операция выполнена без тела ответа.
Ошибки
| HTTP-статус | Описание |
|---|---|
401 | Авторизация отсутствует или недействительна. |
403 | Для операции недостаточно разрешений. |
404 | Запрошенный ресурс не найден. |
422 | Поля запроса не прошли проверку. |
429 | Превышен лимит запросов; учитывайте Retry-After. |
500 | Внутренняя ошибка CloudPrint. |
Связанная документация
Получить агентов клиентаПолучите всех агентов управляемого клиента, включая отозванных.Создать Agent EnrollmentСоздайте одноразовое подключение агента, которое можно безопасно повторить до или после первоначального подключения клиента.Настройка агента для управляемого аккаунтаСоздайте одноразовую ссылку и подключите CloudPrint Agent к нужному аккаунту клиента без входа в кабинет.