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.
API-sleutel aanmaken
Section titled “API-sleutel aanmaken”POST /v1/api-keysMaakt een nieuwe API-sleutel aan voor je account.
Aanvraagbody
Section titled “Aanvraagbody”{ "name": "My integration"}| Veld | Verplicht | Beschrijving |
|---|---|---|
name | Ja | Weergavenaam voor de sleutel (1 tot 100 tekens) |
Respons
Section titled “Respons”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.
API-sleutels weergeven
Section titled “API-sleutels weergeven”GET /v1/api-keysRetourneert de API-sleutels van je account. De volledige sleutelwaarde wordt na het aanmaken nooit meer geretourneerd.
Respons
Section titled “Respons”{ "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.
API-sleutel intrekken
Section titled “API-sleutel intrekken”DELETE /v1/api-keys/:idTrekt 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.
Respons
Section titled “Respons”204 No Content met een lege body.
Foutcodes
Section titled “Foutcodes”| Code | HTTP-status | Betekenis |
|---|---|---|
API_KEY_NOT_FOUND | 404 | De sleutel bestaat niet of hoort bij een ander account |
ALREADY_REVOKED | 400 | De sleutel was al ingetrokken |