Met onze eenvoudige API kun je automatisch deelnemers toevoegen aan je examen en academie en hen een uitnodiging sturen.
API-taal
Onze API accepteert application/x-www-form-urlencoded, multipart/form-data en JSON.
Examen-API
Deelnemer toevoegen
Deze API-aanroep werkt alleen als de toegang tot uw examen is ingesteld op Een vooraf gedefinieerde groep gebruikers.
HTTP-methode: POST
Succesvol antwoord
{ "success":true }
Foutmelding
{ "success":false, "error":"Voorbeeldfout" }
Veld - Type - Beschrijving
- Tekstreeks - De gegenereerde API-sleutel voor uw account. email - Tekstreeks - Het e-mailadres van de deelnemer die u wilt toevoegen. name - Tekst - De naam van de deelnemer die u wilt toevoegen. examId - Geheel getal - Het ID van het examen.
Deelnemer toevoegen zonder kennisgeving
Voeg een deelnemer toe aan uw examen zonder hem of haar een uitnodiging. De inloggegevens worden in het antwoord teruggestuurd.
HTTP-methode: POST
Succesbericht
{ "success":true, "data": { "playUrl":"[https://the.url/to/your/exam]([https://the.url/to/your/exam](https://the.url/to/your/exam))", "email":"[john@doe.com](mailto:john@doe.com)", "authenticationCode":"ExampleAuthenticationCode" } }
Foutmelding
{ "success":false, "error":"Voorbeeld van een fout"}
- Type - Beschrijving apikey - Tekst - De gegenereerde API-sleutel voor uw account. email - Tekst - Het e-mailadres van de deelnemer die u wilt toevoegen. name - Tekst - De naam van de deelnemer die u wilt toevoegen. examId - Geheel getal - Het ID van het examen. identifier - Tekst - De identificatiecode van de deelnemer.
Academie API
Deelnemer toevoegen
Deze API-aanroep voegt een deelnemer toe aan een Academie en zorgt ervoor dat de uitnodigingsmail voor de Academie naar deze deelnemer wordt verzonden. Je kunt deze API-aanroep ook gebruiken om de deelnemer direct aan een of meer groepen toe te voegen.
De Academie-ID en groeps-ID staan aan het einde van de URL:
In dit voorbeeld is de Academie-ID 123 en de groeps-ID 45678.
Als er geen groeps-ID is opgegeven, wordt de deelnemer alleen toegevoegd aan de pagina Deelnemersoverzicht van de Academie en aan de groep Iedereen. Wanneer de deelnemer inlogt bij de Academie, ziet hij of zij alleen de groep Iedereen als er inhoud aan is toegevoegd.
Als er geen academie-ID wordt opgegeven, wordt de eerste academie gebruikt.
HTTP-methode: POST
Succesvol antwoord
{ "success":true}
Foutmelding
{ "success":false, "error":"Voorbeeldfout"}
Veld - Type - Beschrijving
apikey - Tekstreeks - De gegenereerde API-sleutel voor uw account. email - Tekstreeks - Het e-mailadres van de deelnemer die u wilt toevoegen. name - Tekstreeks - De naam van de deelnemer die u wilt toevoegen. groups - Tekstreeks - De ID's van de groepen waaraan u de deelnemer wilt toevoegen. Scheid groeps-ID’s met een komma.academy - Tekst - Het ID van de Academie waaraan u de deelnemer wilt toevoegen. Standaard is dit de eerste Academie als er geen ID wordt opgegeven.
Deelnemer toevoegen zonder kennisgeving
Deze API-aanroep voegt een deelnemer toe aan je Academie, maar verstuurt geen uitnodiging. De uitnodigingslink wordt in het antwoord teruggestuurd. U kunt deze API-aanroep ook gebruiken om een deelnemer toe te voegen aan een of meer groepen in uw academie.
De academie-ID en groeps-ID zijn te vinden in de URL:
In dit voorbeeld is de Academie-ID 123 en de groeps-ID 45678.
Als er geen groeps-ID is opgegeven, wordt de deelnemer alleen toegevoegd aan de Deelnemersoverzicht-pagina van de Academie en de groep Iedereen. Wanneer de deelnemer inlogt bij de academie, ziet hij of zij de groep Iedereen alleen als er inhoud aan is toegevoegd.
Als er geen academie-ID wordt opgegeven, wordt de eerste academie gebruikt.
HTTP-methode: POST
Succesvol antwoord
`` {
"success":true, "data":{ "playUrl":"https://participant.easy-lms.com/your-academy", "email":"john@doe.com", "inviteLink":"https://participant.easy-lms.com/your-academy/set-new-password?..." } }``
Foutmelding
{ "success":false, "error":"Voorbeeldfout" }
Veld - Type - Beschrijving
- Tekstreeks - De gegenereerde API-sleutel voor uw account. email - Tekstreeks - Het e-mailadres van de deelnemer die u wilt toevoegen. name - Tekstreeks - De naam van de deelnemer die u wilt toevoegen. identifier - Tekstreeks - De identificatiecode van de deelnemer in uw systeem. groepen - Tekst - De ID's van de groepen waaraan u de deelnemer wilt toevoegen. Scheid de groeps-ID's met een komma.Academie - Tekst - De ID van de Academie waaraan u de deelnemer wilt toevoegen. Standaard is dit de eerste Academie als er geen ID wordt opgegeven.
Als een deelnemer al aan het examen of de Academie is toegevoegd, zal de API niet mislukken, maar de deelnemersgegevens bijwerken als de identificatiecode hetzelfde is.