Ga naar inhoud

Endpoints voor API-sleutels

Endpoints voor het beheren van je eigen API-sleutels. Alle paden staan op https://api.recordmeeting.com en vereisen een API-sleutel. Zie Authenticatie.

Je eerste sleutel moet je in de app aanmaken, onder Instellingen ➤ API-sleutels. Zie Gebruikershandleiding ➤ API-sleutels.

POST /v1/api-keys

Maakt een nieuwe API-sleutel aan voor je account.

{
"name": "My integration"
}
VeldVerplichtBeschrijving
nameJaWeergavenaam voor de sleutel (1 tot 100 tekens)

201 Created

{
"data": {
"id": "key_uuid",
"name": "My integration",
"prefix": "sk_rm_a1b2c3",
"key": "sk_rm_a1b2c3d4e5f6...",
"created_at": "2026-09-19T15:00:00.000Z"
}
}

Fouten: 400 VALIDATION_ERROR.


GET /v1/api-keys

Retourneert de API-sleutels van je account. De volledige sleutelwaarde wordt na het aanmaken nooit meer geretourneerd.

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

last_used_at is null voor een sleutel die nog nooit is gebruikt.


DELETE /v1/api-keys/:id

Trekt een API-sleutel permanent in. Verzoeken die de sleutel gebruiken, mislukken vanaf dat moment met 401 INVALID_API_KEY. Dit kan niet ongedaan worden gemaakt.

204 No Content met een lege body.

CodeHTTP-statusBetekenis
API_KEY_NOT_FOUND404De sleutel bestaat niet of hoort bij een ander account
ALREADY_REVOKED400De sleutel was al ingetrokken