Получить управляемые аккаунты клиентов
Получите аккаунты клиентов, созданные партнёрским приложением, включая состояние агентов и принтеров.
Назначение метода
Получите аккаунты клиентов, созданные партнёрским приложением, включая состояние агентов и принтеров.
Авторизация
Передавайте одноразовый RS256 assertion Developer Application в Authorization: Bearer <application_assertion>. Это не токен доступа к Public API.
Запрос
Основной адрес API: https://public-api.cloudprint.me/partner-api/v1/accounts
Параметры
| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|---|
limit | query | integer | нет | Поле контракта API; учитывайте указанные тип и ограничения. | min: 1; max: 100; default: 50 |
cursor | query | string (uuid) | нет | Поле контракта API; учитывайте указанные тип и ограничения. | — |
external_customer_id | query | string | нет | Стабильный идентификатор этого ресурса. | minLength: 1; maxLength: 160 |
Тело запроса
У метода нет тела запроса.
Примеры запросов
cURL
bash
curl -sS https://public-api.cloudprint.me/partner-api/v1/accounts \
-H "Authorization: Bearer $APPLICATION_ASSERTION"Ответ
HTTP-статус: 200 — Запрос выполнен.
Поля ответа
| Имя | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|
data | array | да | Поле контракта API; учитывайте указанные тип и ограничения. | — |
next_cursor | string | null (uuid) | да | Непрозрачный cursor следующей страницы; передавайте его без изменений. | — |
Пример ответа
json
{
"data": [
"string"
],
"next_cursor": null
}Ошибки
| HTTP-статус | Описание |
|---|---|
401 | Авторизация отсутствует или недействительна. |
403 | Для операции недостаточно разрешений. |
422 | Поля запроса не прошли проверку. |
429 | Превышен лимит запросов; учитывайте Retry-After. |
500 | Внутренняя ошибка CloudPrint. |
Рекомендации по интеграции
Связанная документация
Создать управляемый аккаунт клиентаСоздайте изолированный аккаунт CloudPrint, App Installation и одноразовое подключение агента без регистрации клиента.Получить управляемый аккаунт клиентаПолучите одного управляемого клиента по стабильному relationship ID.Partner Platform CloudPrintСоздавайте и обслуживайте изолированные аккаунты клиентов CloudPrint из embedded- или white-label-продукта.