Gestion des clés API

Endpoints staff pour gérer les clés API programmatiquement.

Accès Staff

Ces endpoints nécessitent un rôle ADMIN ou OWNER.

Lister les clés API

curl https://mc-prd.duckdns.org/api/v1/staff/api-keys \
-H "X-API-Key: YOUR_API_KEY"

Réponse 200:

{
  "data": [
    {
      "id": "key_123",
      "name": "Production API Key",
      "prefix": "mk_",
      "scopes": ["appointments:read", "appointments:write"],
      "organizationId": 1,
      "createdAt": "2026-01-15T10:00:00Z",
      "lastUsedAt": "2026-01-22T08:30:00Z",
      "expiresAt": null
    }
  ]
}

Créer une clé API

curl -X POST https://mc-prd.duckdns.org/api/v1/staff/api-keys \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "name": "Integration Key",
  "scopes": ["appointments:read"],
  "organizationId": 1,
  "expiresInDays": 365
}'

Révoquer une clé API

curl -X DELETE https://mc-prd.duckdns.org/api/v1/staff/api-keys/key_123 \
-H "X-API-Key: YOUR_API_KEY"

Consulter les scopes disponibles

Voir Scopes pour la liste complète des permissions.