---
title: "Получить контекст API-клиента"
description: "Проверьте, к какому аккаунту и API-приложению относится текущий токен и какие разрешения ему выданы."
---
# Получить контекст API-клиента
Проверьте, к какому аккаунту и API-приложению относится текущий токен и какие разрешения ему выданы.
GET/api/v1/meВерсия API: v1operationId:getApiClientContextОткрыть в Markdown
## Назначение метода
Проверьте, к какому аккаунту и API-приложению относится текущий токен и какие разрешения ему выданы.
## Авторизация
Передавайте короткоживущий токен в `Authorization: Bearer `.
Подходит любой действующий токен доступа 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. |
## Рекомендации по интеграции
- Используйте эту проверку при подключении и диагностике, чтобы подтвердить аккаунт и выданные разрешения.
- Не вызывайте метод перед каждым бизнес-запросом: токен уже содержит контекст клиента.
## Связанная документация