Authenticatie

Alle API-aanvragen moeten worden geauthenticeerd met behulp van een API-sleutel.

Basis-URL

https://api.recordmeeting.com/v1

API-sleutelauthenticatie

Voeg uw API-sleutel toe aan de Authorization-header:

Authorization: Bearer <uw_api_sleutel>

Zie Gebruikershandleiding → API-sleutels om een API-sleutel aan te maken.

Voorbeeldverzoek

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

Foutreacties

Alle fouten volgen dit formaat:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Menselijk leesbare beschrijving"
  }
}

Authenticatie foutcodes

Code	HTTP-status	Betekenis
UNAUTHORIZED	401	Ontbrekende of foutief geformatteerde Authorization-header
INVALID_API_KEY	401	De sleutel bestaat niet of is ingetrokken
API_KEY_EXPIRED	401	De sleutel is verlopen
USER_NOT_FOUND	401	De gebruiker die aan de sleutel is gekoppeld, bestaat niet meer
FORBIDDEN	403	Geauthenticeerd, maar onvoldoende toestemming voor deze bron

Veelvoorkomende foutcodes

Code	HTTP-status	Betekenis
RECORDING_NOT_FOUND	404	De opname-ID bestaat niet of is niet toegankelijk
RECORDING_LOCKED	403	Functie vereist een abonnementupgrade
ORGANIZATION_SUBSCRIPTION_EXPIRED	402	De organisatie die eigenaar is van de opname heeft geen actief Enterprise-abonnement meer
TRANSCRIPT_NOT_AVAILABLE	403	Transcriptie is uitgeschakeld voor de organisatie of het lid
SHARING_DISABLED	403	Delen is uitgeschakeld voor de organisatie of het lid
VALIDATION_ERROR	400	Ongeldige of ontbrekende aanvraagparameters
INTERNAL_ERROR	500	Serverfout