# GET /v1/whoami

Tôi là ai

Tác nhân đứng sau khoá API hoặc phiên hiện tại, kèm các quyền của nó. Mọi tác nhân đã xác thực đều gọi được. Tầng giới hạn tốc độ: `read`.

- Quyền cần có: mọi key hoặc phiên đã xác thực
- Giới hạn tốc độ: `read` — 120 yêu cầu mỗi cửa sổ 60 giây cho mỗi API key hoặc phiên web

## Tham số

Không có tham số.

## Phản hồi

```
{ 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")[] }
```

## Lỗi

Các route có giới hạn tốc độ trả `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (số giây tới hết cửa sổ); phản hồi 429 có thêm `Retry-After`. Header có thể vắng khi bộ giới hạn tạm thời không sẵn sàng (khi đó yêu cầu vẫn được cho qua).

| Mã | Ý nghĩa |
|---|---|
| 401 | Thiếu, sai hoặc đã thu hồi API key. |
| 403 | Key thiếu quyền cần có, hoặc thao tác không được phép với tác nhân này. |
| 429 | Vượt giới hạn tốc độ; chờ `Retry-After` giây. |

Tài liệu HTML: https://agimone.com/vi/developers/api/#who-am-i
API 2026-10
