Zum Inhalt springen

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.

Der Tab API-Schlüssel der Einstellungen mit der Schaltfläche Schlüssel erstellen

https://api.recordmeeting.com/v1

Endpoint-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.

Senden Sie Ihren API-Schlüssel im Authorization-Header. Schlüssel beginnen mit sk_rm_.

Authorization: Bearer sk_rm_your_key

Informationen 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.

Terminal-Fenster
curl "https://api.recordmeeting.com/v1/recordings" \
-H "Authorization: Bearer sk_rm_your_key"

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.

Alle Fehler haben dieses Format:

{
"error": {
"code": "ERROR_CODE",
"message": "Human readable description"
}
}

Eine Anfrage ohne gültigen Authorization-Header erhält 401.

CodeHTTP-StatusBedeutung
INVALID_API_KEY401Der Schlüssel existiert nicht oder wurde widerrufen
API_KEY_EXPIRED401Der Schlüssel ist abgelaufen
USER_NOT_FOUND401Das Konto, zu dem der Schlüssel gehört, existiert nicht mehr
AUTH_ERROR401Authentifizierung fehlgeschlagen
CodeHTTP-StatusBedeutung
VALIDATION_ERROR400Ungültige oder fehlende Anfrageparameter
RECORDING_NOT_READY400Die Aufzeichnung kann noch nicht geteilt werden
ORGANIZATION_SUBSCRIPTION_EXPIRED402Die Organisation, der die Aufzeichnung gehört, hat kein aktives Enterprise-Abonnement mehr
FORBIDDEN403Sie sind kein Mitglied der Organisation oder dürfen nicht sehen, was Sie angefordert haben
RECORDING_LOCKED403Die Aufzeichnung ist gesperrt. Führen Sie ein Upgrade durch, um sie zu öffnen
SUBSCRIPTION_REQUIRED403Die Aktion erfordert einen kostenpflichtigen Tarif
TRANSCRIPT_NOT_AVAILABLE403Die Transkription ist für die Organisation oder das Mitglied deaktiviert
SHARING_DISABLED403Das Teilen ist für die Organisation oder das Mitglied deaktiviert
RECORDING_NOT_FOUND404Die Aufzeichnung existiert nicht oder Sie können nicht darauf zugreifen
INTERNAL_ERROR500Serverseitiger Fehler