# GET /v1/whoami

Qui suis-je

Acteur associé à la clé API ou à la session en cours, avec ses portées. Tout acteur authentifié. Niveau de limite de débit : `read`.

- Portée requise: toute clé ou session authentifiée
- Limite débit: `read` — 120 requêtes par fenêtre de 60 s par clé API ou session web

## Paramètres

Aucun paramètre.

## Réponse

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

## Erreurs

Les routes soumises à une limite de débit renvoient `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset` (secondes avant la fin de la fenêtre) ; une réponse 429 contient aussi `Retry-After`. Ces en-têtes peuvent être absents lorsque le limiteur est temporairement indisponible (les requêtes sont alors acceptées).

| Statut | Sens |
|---|---|
| 401 | Clé API absente, invalide ou révoquée. |
| 403 | La clé n'a pas la portée requise, ou l'opération n'est pas autorisée pour cet acteur. |
| 429 | Limite de débit dépassée ; attendez `Retry-After` secondes. |

Documentation HTML: https://agimone.com/fr/developers/api/#who-am-i
API 2026-10
