Zum Inhalt springen

API-Schlüssel-Endpunkte

Endpunkte für die Verwaltung Ihrer eigenen API-Schlüssel. Alle Pfade liegen auf https://api.recordmeeting.com und benötigen einen API-Schlüssel. Siehe Authentifizierung.

Ihr erster Schlüssel muss in der App unter Einstellungen ➤ API-Schlüssel erstellt werden. Siehe Benutzerhandbuch ➤ API-Schlüssel.

POST /v1/api-keys

Erstellt einen neuen API-Schlüssel für Ihr Konto.

{
"name": "My integration"
}
FeldErforderlichBeschreibung
nameJaAnzeigename für den Schlüssel (1 bis 100 Zeichen)

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

Fehler: 400 VALIDATION_ERROR.


GET /v1/api-keys

Gibt die API-Schlüssel Ihres Kontos zurück. Der vollständige Schlüsselwert wird nach dem Erstellen nie mehr zurückgegeben.

{
"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 ist null für einen Schlüssel, der noch nie verwendet wurde.


DELETE /v1/api-keys/:id

Widerruft einen API-Schlüssel dauerhaft. Anfragen mit diesem Schlüssel schlagen ab dann mit 401 INVALID_API_KEY fehl. Das lässt sich nicht rückgängig machen.

204 No Content mit einem leeren Body.

CodeHTTP-StatusBedeutung
API_KEY_NOT_FOUND404Der Schlüssel existiert nicht oder gehört zu einem anderen Konto
ALREADY_REVOKED400Der Schlüssel wurde bereits widerrufen