Получить контекст API-клиента
Проверьте, к какому аккаунту и API-приложению относится текущий токен и какие разрешения ему выданы.
Назначение метода
Проверьте, к какому аккаунту и API-приложению относится текущий токен и какие разрешения ему выданы.
Авторизация
Передавайте короткоживущий токен в Authorization: Bearer <access_token>.
Подходит любой действующий токен доступа CloudPrint; дополнительные разрешения не требуются.
Запрос
Основной адрес API: https://public-api.cloudprint.me/api/v1/me
Параметры
У метода нет параметров пути, строки запроса или дополнительных заголовков.
Тело запроса
У метода нет тела запроса.
Примеры запросов
cURL
bash
curl -sS https://public-api.cloudprint.me/api/v1/me \
-H "Authorization: Bearer $ACCESS_TOKEN"Ответ
HTTP-статус: 200 — Запрос выполнен.
Поля ответа
| Имя | Тип | Обязательно | Описание | Ограничения |
|---|---|---|---|---|
account_id | string (uuid) | да | Стабильный UUID аккаунта CloudPrint, которому принадлежит ресурс. | — |
account_name | string | да | Отображаемое имя аккаунта CloudPrint. | example: "Acme Print Ops" |
client_app_id | string | null (uuid) | нет | Стабильный идентификатор API Credentials, представленных текущим токеном. | — |
client_app_name | string | null | нет | Название API Credentials, используемое при диагностике аккаунта. | — |
application_id | string | null (uuid) | нет | Стабильный идентификатор Developer Application, представленного токеном установки. | — |
application_name | string | null | нет | Название Developer Application, видимое операторам аккаунта. | — |
authorization_mode | string | да | Модель авторизации токена: данные доступа аккаунта или установка приложения. | enum: client_credentials, app_installation |
installation_id | string | null (uuid) | да | Стабильный UUID App Installation, выдавшей разрешение токену. | — |
scopes | array | нет | Разрешения, выданные текущему токену доступа. | example: ["agents:read","printers:read","documents:write","print_jobs:write","print_jobs:read"] |
permissions | array | нет | Разрешения установки, включённые в этот токен. | — |
Пример ответа
json
{
"account_id": "11111111-1111-4111-8111-111111111111",
"account_name": "Acme Print Ops",
"client_app_id": null,
"client_app_name": null,
"application_id": null,
"application_name": null,
"authorization_mode": "client_credentials",
"installation_id": null,
"scopes": [
"agents:read",
"printers:read",
"documents:write",
"print_jobs:write",
"print_jobs:read"
],
"permissions": [
"string"
]
}Ошибки
| HTTP-статус | Описание |
|---|---|
401 | Авторизация отсутствует или недействительна. |
429 | Превышен лимит запросов; учитывайте Retry-After. |
500 | Внутренняя ошибка CloudPrint. |
Рекомендации по интеграции
- Используйте эту проверку при подключении и диагностике, чтобы подтвердить аккаунт и выданные разрешения.
- Не вызывайте метод перед каждым бизнес-запросом: токен уже содержит контекст клиента.
Связанная документация
Получить токен доступа OAuth2Обменяйте данные доступа CloudPrint API на короткоживущий Bearer-токен OAuth2 по схеме Client Credentials.Получить список агентов печатиПолучите список агентов CloudPrint в аккаунте и проверьте их статус, версию и состояние обновления.Получить список доступных принтеровПолучите принтеры подключённых агентов CloudPrint и выберите стабильный printer_id для сценария печати.