Clés d'API

Créer une clé d’API

POST /api/v1/api-keys

Crée une nouvelle clé d’API pour l’utilisateur authentifié.

Corps de la requête

{
  "name": "My integration"
}

Champ	Requis	Description
name	Oui	Nom d’affichage de la clé (1 à 100 caractères)

Réponse

{
  "data": {
    "id": "key_uuid",
    "name": "My integration",
    "prefix": "rm_abc123",
    "key": "rm_abc123def456...",
    "created_at": "2025-09-19T15:00:00.000Z"
  }
}

Attention

Le champ key est renvoyé une seule fois au moment de la création. Stockez-le en toute sécurité, il ne peut plus être récupéré. Seul le prefix (les 8 premiers caractères) est affiché lors des requêtes ultérieures.

---

Lister les clés d’API

GET /api/v1/api-keys

Renvoie toutes les clés d’API pour l’utilisateur authentifié. La valeur complète de la clé n’est jamais renvoyée après la création.

Réponse

{
  "data": [
    {
      "id": "key_uuid",
      "name": "My integration",
      "prefix": "rm_abc123",
      "created_at": "2025-09-19T15:00:00.000Z",
      "last_used_at": "2025-09-20T10:30:00.000Z",
      "is_revoked": false
    }
  ]
}

---

Révoquer une clé d’API

DELETE /api/v1/api-keys/:id

Révoque définitivement une clé d’API. Les requêtes utilisant cette clé échoueront immédiatement avec INVALID_API_KEY.

Réponse

{
  "data": { "success": true }
}

Codes d’erreur

Code	Statut HTTP	Signification
API_KEY_NOT_FOUND	404	La clé n’existe pas ou appartient à un autre utilisateur
ALREADY_REVOKED	400	La clé a déjà été révoquée