Authentification
L'URL de base est https://app.citeme.io/api/v1. Toutes les requêtes exigent un en-tête Authorization: Bearer cm_....
curl https://app.citeme.io/api/v1/projects \
-H "Authorization: Bearer cm_xxxxxxxxxxxx"
Créer une clé
Dashboard → Paramètres → Clés API. Seuls les propriétaires et administrateurs de l'organisation peuvent en créer.
- Format :
cm_suivi de 48 caractères hexadécimaux. Elle n'est affichée qu'une fois à la création. - Forfait : Pro ou Expert. Avec un autre forfait, les requêtes reçoivent
403. - Lecture seule par défaut : à la création, vous choisissez entre une clé en lecture seule (scope
read) et une clé qui autorise aussi les écritures (scopesreadetwrite). Le scope ne dépend pas du forfait.
Ne jamais exposer votre clé
Ne l'incluez jamais dans du code côté client ni dans un dépôt public.
Scopes
| Requête | Scope exigé | Réponse si absent |
|---|---|---|
| Toute requête | read | 403 Forbidden: This API key does not have read permissions |
POST (lancer un audit, ajouter un mot-clé) | write, en plus de read | 403 Forbidden: This API key does not have write permissions |
Une clé en lecture seule ne peut donc que lister et lire. Pour lancer un audit par API, créez une clé avec écriture.
Quelle clé pour quelle surface
CiteMe a deux systèmes de clés, volontairement séparés. Chacun refuse les routes de l'autre.
Clé API cm_ | Clé de citeme login | |
|---|---|---|
| Création | Dashboard → Paramètres → Clés API | commande citeme login (CLI, extension Chrome, MCP local) |
| Forfait minimal | Pro | Starter |
| Routes acceptées | /api/v1/projects/* (cette documentation) | /api/v1/cli/* |
Serveur MCP hébergé (https://mcp.citeme.io) | refusée | acceptée comme Bearer |
Une clé de citeme login appelée sur /api/v1/projects est refusée, et une clé cm_ appelée sur /api/v1/cli/* aussi. Pour piloter CiteMe depuis un agent IA, voir Piloter CiteMe depuis un agent IA.