Mit unserer einfachen API können Sie Teilnehmer automatisch zu Ihrer Prüfung und Ihrer Academy hinzufügen und ihnen eine Einladung senden.
API-Sprache
Unsere API akzeptiert application/x-www-form-urlencoded oder multipart/form-data sowie JSON.
Prüfungs-API
Teilnehmer hinzufügen
Dieser API-Aufruf funktioniert nur, wenn der Zugriff auf Ihre Prüfung auf Eine vordefinierte Benutzergruppe eingestellt ist.
HTTP-Methode: POST
Erfolgsantwort
{ "success":true }
Fehlermeldung
{ "success":false, "error":"Beispielfehler" }
Feld – Typ – Beschreibung
- String – Der generierte API-Schlüssel für Ihr Konto. email – String – Die E-Mail-Adresse des Teilnehmers, den Sie hinzufügen möchten. name – Zeichenfolge – Der Name des Teilnehmers, den Sie hinzufügen möchten. examId – Ganzzahl – Die ID der Prüfung.
Teilnehmer hinzufügen, ohne ihn zu benachrichtigen
Fügen Sie einen Teilnehmer zu Ihrer Prüfung hinzu, ohne ihm eine Einladung zu senden. Die Anmeldedaten werden in der Antwort zurückgegeben.
HTTP-Methode: POST
Erfolgsantwort
{ "success":true, "data": { "playUrl":"[https://the.url/to/your/exam]([https://the.url/to/your/exam](https://the.url/to/your/exam))", "email":"[[email protected]](mailto:[email protected])", "authenticationCode":"ExampleAuthenticationCode" } }
Fehlermeldung
{ "success":false, "error":"Beispielfehler"}
- Typ - Beschreibung apikey - Zeichenfolge - Der generierte API-Schlüssel für Ihr Konto. email - Zeichenfolge - Die E-Mail-Adresse des Teilnehmers, den Sie hinzufügen möchten. name - Zeichenfolge - Der Name des Teilnehmers, den Sie hinzufügen möchten. examId - Ganzzahl - Die ID der Prüfung. identifier – Zeichenfolge – Die Kennung des Teilnehmers.
Academy-API
Teilnehmer hinzufügen
Dieser API-Aufruf fügt einen Teilnehmer zu einer Academy hinzu und löst aus, dass die Einladungs-E-Mail der Academy an ihn gesendet wird. Sie können diesen API-Aufruf auch nutzen, um den Teilnehmer sofort einer oder mehreren Gruppen hinzuzufügen.
Die Academy-ID und die Gruppen-ID finden Sie am Ende der URL:
In diesem Beispiel lautet die Academy-ID 123 und die Gruppen-ID 45678.
Wenn keine Gruppen-ID angegeben wird, wird der Teilnehmer nur zur Seite Teilnehmerübersicht der Academy und zur Gruppe Alle hinzugefügt. Wenn er sich bei der Academy anmeldet, sieht er die Gruppe Alle nur, wenn Inhalte hinzugefügt wurden.
Wird keine Academy-ID angegeben, wird die erste Academy verwendet.
HTTP-Methode: POST
Erfolgsantwort
{ "success":true}
Fehlermeldung
{ "success":false, "error":"Beispielfehler"}
Feld – Typ – Beschreibung
apikey – Zeichenfolge – Der für Ihr Konto generierte API-Schlüssel. email – Zeichenkette – Die E-Mail-Adresse des Teilnehmers, den Sie hinzufügen möchten. name – Zeichenkette – Der Name des Teilnehmers, den Sie hinzufügen möchten. groups – Zeichenkette – Die IDs der Gruppen, zu denen Sie den Teilnehmer hinzufügen möchten. Trennen Sie die Gruppen-IDs durch ein Komma. Academy – String – Die ID der Academy, der Sie den Teilnehmer hinzufügen möchten. Standardmäßig wird die erste Academy verwendet, wenn keine ID angegeben wird.
Teilnehmer ohne Benachrichtigung hinzufügen
Dieser API-Aufruf fügt einen Teilnehmer zu Ihrer Academy hinzu, versendet jedoch keine Einladung. Der Einladungslink wird in der Antwort zurückgegeben. Sie können diesen API-Aufruf auch verwenden, um einen Teilnehmer zu einer oder mehreren Gruppen in Ihrer Academy hinzuzufügen.
Die Academy-ID und die Gruppen-ID finden Sie in der URL:
In diesem Beispiel lautet die Academy-ID 123 und die Gruppen-ID 45678.
Wenn keine Gruppen-ID angegeben wird, wird der Teilnehmer nur zur Seite Teilnehmerübersicht der Academy und zur Gruppe Alle hinzugefügt. Wenn er sich bei der Academy anmeldet, sieht er die Gruppe Alle nur, wenn dort Inhalte hinzugefügt wurden.
Wird keine Academy-ID angegeben, wird die erste Academy verwendet.
HTTP-Methode: POST
Erfolgsantwort
`` {
"success":true, "data":{ "playUrl":"https://participant.easy-lms.com/your-academy", "email":"[email protected]", "inviteLink":"https://participant.easy-lms.com/your-academy/set-new-password?..." } }``
Fehlermeldung
{ "success":false, "error":"Beispielfehler" }
Feld – Typ – Beschreibung
- Zeichenfolge – Der generierte API-Schlüssel für Ihr Konto. E-Mail – Zeichenfolge – Die E-Mail-Adresse des Teilnehmers, den Sie hinzufügen möchten. Name – Zeichenfolge – Der Name des Teilnehmers, den Sie hinzufügen möchten. Kennung – Zeichenfolge – Die Kennung des Teilnehmers in Ihrem System. groups – Zeichenfolge – Die IDs der Gruppen, zu denen Sie den Teilnehmer hinzufügen möchten. Trennen Sie die Gruppen-IDs durch Kommas. academy – Zeichenfolge – Die ID der Academy, zu der Sie den Teilnehmer hinzufügen möchten. Standardmäßig wird die erste Academy verwendet, wenn keine ID angegeben wird.
Wenn ein Teilnehmer bereits zur Prüfung oder Academy hinzugefügt wurde, schlägt der API-Aufruf nicht fehl, sondern die Teilnehmerdaten werden aktualisiert, sofern die Kennung identisch ist.