Zertifikat per API verleihen

Zertifikate können verwendet werden, um Lernende zu belohnen, nachdem sie einen Kurs oder Schulungsplan abgeschlossen haben. Es kann jedoch Fälle geben, in denen Benutzer einen Kurs oder Schulungsplan bereits abgeschlossen haben, bevor ein Zertifikat dafür existierte. In diesem Fall kann solchen Benutzern ein Zertifikat über die Option Externe Schulungsdaten importieren im Learn365 Admin Center oder einen Endpunkt der Learn365-API zuerkannt werden.

In diesem Artikel beschreiben wir, wie Sie ein Zertifikat über die Learn365-API vergeben.

Gehen Sie wie folgt vor, um ein Zertifikat über die Learn365-API zu vergeben:

1. Gehen Sie zu https://api.365.systems/, und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.

2. Wählen Sie im Abschnitt Certificates den Endpunkt /odata/v2/Certificates aus und klicken Sie oben rechts auf Try it out.

3. Im Feld Edit Value sehen Sie, welche Parameter beim Erstellen eines Zertifikats verwendet werden können:

• Id sollte gelöscht werden, da die ID eines Zertifikats erst nach der Zuerkennung abgerufen wird.
• CourseId ist ein Pflichtparameter. Ersetzen Sie guid durch die mit dem Zertifikat verknüpfte Kurs-ID.
• ContentUrl sollte gelöscht werden, da die URL eines Zertifikats erst nach der Zuerkennung generiert wird.
• IsGenerated sollte gelöscht werden, da der Wert von Learn365 eingetragen wird, nachdem ein Zertifikat aus der Vorlage generiert wurde.
• Status ist ein optionaler Parameter. Ersetzen Sie integer durch eine Zahl, die den Zertifikatsstatus angibt. Gültige Werte sind 0 (Gültig), 1 (Bald ablaufend) und 2 (Abgelaufen).
• Issued ist ein Pflichtparameter. Hier wird automatisch der aktuelle Zeitpunkt (als Datum und Uhrzeit) eingetragen, die Angabe kann aber manuell geändert werden.
• Expiry ist ein optionaler Parameter. Hier wird automatisch der aktuelle Zeitpunkt (als Datum und Uhrzeit) eingetragen, die Angabe kann aber manuell geändert werden.
• TemplateId ist ein Pflichtparameter, falls Sie eine PDF-Datei für ein Zertifikat erstellen möchten; andernfalls kann er weggelassen werden, und es wird dann nur ein Datensatz für den Benutzer erstellt. Ersetzen Sie guid durch die ID einer Zertifikatsvorlage, die Sie für das Zertifikat verwenden möchten. Informationen zum Abrufen einer Vorlagen-ID finden Sie in diesem Artikel.
• UserId ist ein Pflichtparameter. Ersetzen Sie guid durch die ID des Benutzers, dem Sie das Zertifikat verleihen möchten.
• UserLoginName ist ein optionaler Parameter. Ersetzen Sie string durch den Anmeldenamen des Benutzers. Der Anmeldename des Benutzers kann auf gleiche Weise wie die oben beschriebene UserId abgerufen werden.

4. Wenn Sie bereit sind, wählen Sie Execute aus, um die Anfrage auszuführen.

5. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren:

• Die Zahl 2xx (beispielsweise „202“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• Im Feld Response body wird das verliehene Zertifikat mit den festgelegten Parametern angezeigt. Neben dem Wertparameter wird die eindeutige ID des verliehenen Zertifikats angezeigt. Das Zertifikat kann auch in den Aufzeichnungen des Benutzers im Learn365 Admin Center sowie unter den Fortschritten des Benutzers angezeigt werden.
• Über die Option Download können Sie die Ergebnisse im JSON-Format auf Ihrem Computer speichern.