Ein Zertifikat über die Learn365-API aktualisieren

Einführung

Die Learn365 API ermöglicht es Ihnen, das Ablaufdatum, das Ausstellungsdatum und den Status eines Zertifikats zu aktualisieren.

Dieser Artikel beschreibt, wie Sie Zertifikate per API aktualisieren. Die Aktualisierungen wirken sich nicht auf bereits ausgestellte Zertifikat-PDF-Dateien aus, aber Zertifikate können per API neu ausgestellt werden.

Gehen Sie wie folgt vor, um das Zertifikat zu aktualisieren:

Erforderliche Rolle: Katalogadministrator oder Kursadministrator

Zum Verwenden der Learn365-API müssen Sie mit dem entsprechenden API-Schlüssel auf https:/api.365.systems autorisiert sein . Details finden Sie indiesem Artikel.

1. Navigieren Sie inhttps:/api.365.systemszum Abschnitt Certificates und erweitern Sie ihn.

2. Wählen Sie den Patch-Endpunkt /odata​/v2​/Certificates({Id}) endpoint (dies aktualisiert ein Zertifikat teilweise) and selectTry it out.

3. Fügen Sie im erforderlichen Feld key: Id die Zertifikat-ID des entsprechenden Benutzers für den entsprechenden Kurs ein.

4. Aktualisieren Sie im Feld Certificate die Daten der relevanten Eigenschaften. Sie sollten die entire row for properties you don't want to update.

Um den Zertifikatstatus zu aktualisieren, geben Sie in der Eigenschaft Status Folgendes an:

• 0 fürValid
• 1 für Expiring
• 2 für Expired

Um das Ausstellungsdatum oder das Ablaufdatum des Zertifikats zu aktualisieren, geben Sie die entsprechenden Daten an.

5. Wählen SieExecuteaus, um die Anfrage auszuführen.

6. Im Block Antworten kontrollieren Sie die Ergebnisse:

• Code 2xx (zum Beispiel 200) zeigt an, dass die Anfrage korrekt funktioniert hat.
• Sie können Download verwenden, um die Daten aus der Antwort im .JSON-Format auf Ihren Computer herunterzuladen.

Sie können die aktualisierten Zertifikatsinformationen im Learn365 Admin Center und in den heruntergeladenen Fortschrittsberichten nachverfolgen. Dieser API-Aufruf löst keine Änderungen an Zertifikat-PDF-Dateien aus, die bereits ausgestellt wurden.