API Keys endpoints

API-sleutel aanmaken

POST /api/v1/api-keys

Maakt een nieuwe API-sleutel voor de geverifieerde gebruiker.

Aanvraagtekst

{
  "name": "My integration"
}

Veld	Vereist	Beschrijving
`name`	Ja	Weergavenaam voor de sleutel (1-100 tekens)

Antwoord

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

API-sleutels weergeven

GET /api/v1/api-keys

Retourneert alle API-sleutels voor de geverifieerde gebruiker. De volledige sleutelwaarde wordt na aanmaak nooit meer geretourneerd.

Antwoord

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

API-sleutel intrekken

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

Trekt een API-sleutel permanent in. Aanvragen die deze sleutel gebruiken, zullen onmiddellijk mislukken met INVALID_API_KEY.

Antwoord

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

Foutcodes

Code	HTTP Status	Betekenis
`API_KEY_NOT_FOUND`	404	Sleutel bestaat niet of behoort toe aan een andere gebruiker
`ALREADY_REVOKED`	400	Sleutel was al ingetrokken