# GET /v1/whoami

Кто я

Субъект, стоящий за текущим ключом API или сессией, с его областями. Любой аутентифицированный субъект. Уровень лимита: `read`.

- Требуемая область: любой ключ или сессия после входа
- Лимит запросов: `read` — 120 запросов за окно в 60 с на ключ API или веб-сессию

## Параметры

Нет параметров.

## Ответ

```
{ actor_id: integer | null; actor_type: string; api_key_id: integer | null; scopes: ("publisher:read" | "publisher:write" | "admin:read" | "admin:write" | "infra:read" | "infra:write" | "adv:read" | "adv:write" | "scan:work" | "dsp0:review")[] }
```

## Ошибки

Маршруты с ограничением частоты возвращают `RateLimit-Limit`, `RateLimit-Remaining` и `RateLimit-Reset` (секунд до конца окна); ответ 429 также содержит `Retry-After`. Заголовки могут отсутствовать, пока ограничитель временно недоступен (запросы тогда пропускаются).

| Статус | Смысл |
|---|---|
| 401 | Ключ API отсутствует, недействителен или отозван. |
| 403 | У ключа нет требуемой области, либо операция недоступна для этого субъекта. |
| 429 | Лимит запросов превышен; подождите `Retry-After` секунд. |

HTML-документация: https://agimone.com/ru/developers/api/#who-am-i
API 2026-10
