Authentifizierung

Alle API-Anfragen müssen mittels eines API-Schlüssels authentifiziert werden.

Basis-URL

https://api.recordmeeting.com/v1

API-Schlüssel-Authentifizierung

Fügen Sie Ihren API-Schlüssel in den Authorization-Header ein:

Authorization: Bearer <your_api_key>

Informationen zum Erstellen eines API-Schlüssels finden Sie unter Benutzerhandbuch → API-Schlüssel.

Beispielanfrage

curl -X GET "https://api.recordmeeting.com/v1/recordings"
  -H "Authorization: Bearer rm_your_api_key_here"

Fehlerantworten

Alle Fehler haben folgendes Format:

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

Authentifizierungs-Fehlercodes

Code	HTTP-Status	Bedeutung
UNAUTHORIZED	401	Fehlender oder fehlerhafter Authorization-Header
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	Der dem Schlüssel zugeordnete Benutzer existiert nicht mehr
FORBIDDEN	403	Authentifiziert, aber keine Berechtigung für diese Ressource

Häufige Fehlercodes

Code	HTTP-Status	Bedeutung
RECORDING_NOT_FOUND	404	Die Aufnahme-ID existiert nicht oder ist nicht zugänglich
RECORDING_LOCKED	403	Funktion erfordert ein Abonnement-Upgrade
VALIDATION_ERROR	400	Ungültige oder fehlende Anforderungsparameter
INTERNAL_ERROR	500	Serverseitiger Fehler