Ga naar inhoud

Authenticatie

Elk verzoek aan de Record Meeting API heeft een API-sleutel nodig. Je maakt sleutels aan in de app onder Instellingen ➤ API-sleutels.

Het tabblad API-sleutels van Instellingen met de knop Sleutel aanmaken

https://api.recordmeeting.com/v1

Endpointpaden in deze referentie zijn geschreven met het voorvoegsel /v1, bijvoorbeeld GET /v1/recordings. Voeg ze toe aan https://api.recordmeeting.com.

Stuur je API-sleutel mee in de header Authorization. Sleutels beginnen met sk_rm_.

Authorization: Bearer sk_rm_your_key

Zie Gebruikershandleiding ➤ API-sleutels om een sleutel aan te maken. Een sleutel heeft dezelfde toegang als je account: je eigen opnames en de organisatieopnames die je mag zien.

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

Succesvolle antwoorden zijn JSON met het resultaat onder data. Lijst-endpoints die hun resultaten pagineren, voegen een pagination-object toe. Sommige antwoorden bevatten ook "success": true.

PATCH- en DELETE-verzoeken antwoorden met 204 No Content en een lege body als ze slagen.

Alle fouten hebben dit formaat:

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

Een verzoek zonder geldige header Authorization krijgt 401.

CodeHTTP-statusBetekenis
INVALID_API_KEY401De sleutel bestaat niet of is ingetrokken
API_KEY_EXPIRED401De sleutel is verlopen
USER_NOT_FOUND401Het account waartoe de sleutel behoort, bestaat niet meer
AUTH_ERROR401Authenticatie is mislukt
CodeHTTP-statusBetekenis
VALIDATION_ERROR400Ongeldige of ontbrekende verzoekparameters
RECORDING_NOT_READY400De opname kan nog niet worden gedeeld
ORGANIZATION_SUBSCRIPTION_EXPIRED402De organisatie die eigenaar is van de opname heeft geen actief Enterprise-abonnement meer
FORBIDDEN403Je bent geen lid van de organisatie, of je mag niet zien wat je hebt opgevraagd
RECORDING_LOCKED403De opname is vergrendeld. Upgrade om hem te openen
SUBSCRIPTION_REQUIRED403De actie vereist een betaald plan
TRANSCRIPT_NOT_AVAILABLE403Transcriptie is uitgeschakeld voor de organisatie of het lid
SHARING_DISABLED403Delen is uitgeschakeld voor de organisatie of het lid
RECORDING_NOT_FOUND404De opname bestaat niet of je hebt er geen toegang toe
INTERNAL_ERROR500Fout aan de serverzijde
  • Recordings: opnames opvragen, lezen, bijwerken en verwijderen, transcripties lezen, deellinks aanmaken
  • Organizations: organisaties, mappen en leden
  • API Keys endpoints: sleutels aanmaken, opvragen en intrekken