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.
API-Schlüssel erstellen
Abschnitt betitelt „API-Schlüssel erstellen“POST /v1/api-keysErstellt einen neuen API-Schlüssel für Ihr Konto.
Request-Body
Abschnitt betitelt „Request-Body“{ "name": "My integration"}| Feld | Erforderlich | Beschreibung |
|---|---|---|
name | Ja | Anzeigename für den Schlüssel (1 bis 100 Zeichen) |
Antwort
Abschnitt betitelt „Antwort“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.
API-Schlüssel auflisten
Abschnitt betitelt „API-Schlüssel auflisten“GET /v1/api-keysGibt die API-Schlüssel Ihres Kontos zurück. Der vollständige Schlüsselwert wird nach dem Erstellen nie mehr zurückgegeben.
Antwort
Abschnitt betitelt „Antwort“{ "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.
API-Schlüssel widerrufen
Abschnitt betitelt „API-Schlüssel widerrufen“DELETE /v1/api-keys/:idWiderruft 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.
Antwort
Abschnitt betitelt „Antwort“204 No Content mit einem leeren Body.
Fehlercodes
Abschnitt betitelt „Fehlercodes“| Code | HTTP-Status | Bedeutung |
|---|---|---|
API_KEY_NOT_FOUND | 404 | Der Schlüssel existiert nicht oder gehört zu einem anderen Konto |
ALREADY_REVOKED | 400 | Der Schlüssel wurde bereits widerrufen |