Authentifizierung
Jede Anfrage an die Record Meeting API benötigt einen API-Schlüssel. Sie erstellen Schlüssel in der App unter Einstellungen ➤ API-Schlüssel.

Basis-URL
Abschnitt betitelt „Basis-URL“https://api.recordmeeting.com/v1Endpoint-Pfade in dieser Referenz werden mit dem Präfix /v1 geschrieben, zum Beispiel GET /v1/recordings. Hängen Sie sie an https://api.recordmeeting.com an.
Authentifizierung mit API-Schlüssel
Abschnitt betitelt „Authentifizierung mit API-Schlüssel“Senden Sie Ihren API-Schlüssel im Authorization-Header. Schlüssel beginnen mit sk_rm_.
Authorization: Bearer sk_rm_your_keyInformationen zum Erstellen eines Schlüssels finden Sie unter Benutzerhandbuch ➤ API-Schlüssel. Ein Schlüssel hat denselben Zugriff wie Ihr Konto: Ihre eigenen Aufzeichnungen und die Organisationsaufzeichnungen, die Sie sehen dürfen.
Beispielanfrage
Abschnitt betitelt „Beispielanfrage“curl "https://api.recordmeeting.com/v1/recordings" \ -H "Authorization: Bearer sk_rm_your_key"Antworten
Abschnitt betitelt „Antworten“Erfolgreiche Antworten sind JSON mit dem Ergebnis unter data. Listen-Endpunkte, die ihre Ergebnisse paginieren, fügen ein pagination-Objekt hinzu. Einige Antworten enthalten außerdem "success": true.
PATCH- und DELETE-Anfragen antworten bei Erfolg mit 204 No Content und einem leeren Body.
Fehlerantworten
Abschnitt betitelt „Fehlerantworten“Alle Fehler haben dieses Format:
{ "error": { "code": "ERROR_CODE", "message": "Human readable description" }}Authentifizierungsfehler
Abschnitt betitelt „Authentifizierungsfehler“Eine Anfrage ohne gültigen Authorization-Header erhält 401.
| Code | HTTP-Status | Bedeutung |
|---|---|---|
INVALID_API_KEY | 401 | Der Schlüssel existiert nicht oder wurde widerrufen |
API_KEY_EXPIRED | 401 | Der Schlüssel ist abgelaufen |
USER_NOT_FOUND | 401 | Das Konto, zu dem der Schlüssel gehört, existiert nicht mehr |
AUTH_ERROR | 401 | Authentifizierung fehlgeschlagen |
Häufige Fehlercodes
Abschnitt betitelt „Häufige Fehlercodes“| Code | HTTP-Status | Bedeutung |
|---|---|---|
VALIDATION_ERROR | 400 | Ungültige oder fehlende Anfrageparameter |
RECORDING_NOT_READY | 400 | Die Aufzeichnung kann noch nicht geteilt werden |
ORGANIZATION_SUBSCRIPTION_EXPIRED | 402 | Die Organisation, der die Aufzeichnung gehört, hat kein aktives Enterprise-Abonnement mehr |
FORBIDDEN | 403 | Sie sind kein Mitglied der Organisation oder dürfen nicht sehen, was Sie angefordert haben |
RECORDING_LOCKED | 403 | Die Aufzeichnung ist gesperrt. Führen Sie ein Upgrade durch, um sie zu öffnen |
SUBSCRIPTION_REQUIRED | 403 | Die Aktion erfordert einen kostenpflichtigen Tarif |
TRANSCRIPT_NOT_AVAILABLE | 403 | Die Transkription ist für die Organisation oder das Mitglied deaktiviert |
SHARING_DISABLED | 403 | Das Teilen ist für die Organisation oder das Mitglied deaktiviert |
RECORDING_NOT_FOUND | 404 | Die Aufzeichnung existiert nicht oder Sie können nicht darauf zugreifen |
INTERNAL_ERROR | 500 | Serverseitiger Fehler |
Endpunkte
Abschnitt betitelt „Endpunkte“- Aufzeichnungen: Aufzeichnungen auflisten, lesen, aktualisieren und löschen, Transkripte lesen, Freigabelinks erstellen
- Organisationen: Organisationen, Ordner und Mitglieder
- API-Schlüssel-Endpunkte: Schlüssel erstellen, auflisten und widerrufen