Jede Lernplattform anbinden

So funktioniert es

Es gibt vier Wege, Lerninhalte in MuchSkills einzubinden. Sie können auch mehrere davon gleichzeitig nutzen.

Für Cornerstone, Degreed, Docebo, LinkedIn Learning, Coursera und interne LMS gibt es derzeit keinen nativen Connector. Die Wege 2, 3 und 4 lassen sich mit all diesen Systemen nutzen.

Bevor Sie beginnen

• In MuchSkills: die Rolle Owner oder Admin, um API-Clients anzulegen und einen individuellen Connector anzufragen.
• Klären Sie, was Sie brauchen. Zertifikate, Ziele, Kurslinks oder Lernaktivitäten. Davon hängt ab, welcher Weg passt.
• Für den API-Weg: einen Entwickler, die Integrationsfunktionen Ihres LMS oder eine Integrationsplattform, die eine REST API aufrufen kann.
• Prüfen Sie die E-Mail-Adressen. MuchSkills erkennt Personen an der E-Mail-Adresse, mit der sie sich anmelden. Ihr LMS muss genau diese Adresse übermitteln.

Schritte

Zertifikate und Ziele per API übertragen

1. Erstellen Sie einen API-Client mit Write-Scope. Gehen Sie zu Team/Org › Settings › API Access, klicken Sie auf New Client, vergeben Sie einen Namen, aktivieren Sie unter Scopes die Option Write und klicken Sie auf Create Client. Kopieren Sie Client ID und Client Secret. Alle Schritte zur Einrichtung finden Sie unter MuchSkills API und API Access.
2. Rufen Sie ein Zugriffstoken ab. Senden Sie Client ID und Client Secret formularcodiert mit grant_type=client_credentials an POST https://app.muchskills.com/oauth2/token. Das Token gilt etwa eine Stunde.
3. Senden Sie ein Zertifikat. Sobald jemand in Ihrem LMS ein Zertifikat erwirbt, schicken Sie es an POST /api/v1/user-certifications/{email} und verwenden dabei die MuchSkills-E-Mail-Adresse der Person:

{
  "certification": "AZ-104",
  "issuingOrganization": "Microsoft",
  "period": {
    "license": "AZ104-2026-001",
    "issuedAt": "2026-01-15",
    "expiredAt": "2027-01-15",
    "urls": ["https://issuer.example/verify/abc"]
  }
}

MuchSkills findet das Zertifikat über seinen exakten Namen, seinen Code (etwa AZ-104) oder einen bekannten Alias. Mit issuingOrganization grenzen Sie die Suche ein. Bei einem Zertifikat, das nie abläuft, lassen Sie expiredAt weg und senden "notExpiring": true. Mit demselben Aufruf verlängern Sie auch ein Zertifikat, das die Person bereits besitzt.

4. Legen Sie ein Ziel fest (optional). Wenn Sie jemandem ein Entwicklungsziel zuweisen möchten, senden Sie POST /api/v1/goals/{email} mit einem skill oder einer certification und geben Sie an, auf welchem Weg die Person das Ziel erreichen soll:

{
  "certification": "AWS Certified Developer - Associate",
  "issuingOrganization": "Amazon Web Services",
  "reachingType": "classes",
  "deadline": "2026-12-31"
}

Für eine Kompetenz senden Sie stattdessen "skill" und ein "desiredLevel" von 1 bis 9. reachingType ist mentor, self oder classes.

Kurse in der Learning Library verlinken

5. Öffnen Sie die Learning Library. Gehen Sie zu My Growth › Learning Library.
6. Fügen Sie einen Kurs hinzu. Klicken Sie auf Add a course, fügen Sie die Webadresse des Kurses ein und klicken Sie auf Get Page Details. MuchSkills übernimmt Titel, Bild und Beschreibung von der Seite. Passen Sie diese an und legen Sie das Kursniveau fest.
7. Verschlagworten Sie die Kompetenzen. Ordnen Sie jede Kompetenz zu, die der Kurs vermittelt. Der Kurs erscheint dann auf den Seiten dieser Kompetenzen, in Analyselisten und in der Skill-Gap-Analyse jeder Person.

Individuellen Connector anfragen

8. Schicken Sie uns die Details. Schreiben Sie an support@muchskills.com oder nutzen Sie den Chat, und zwar mit diesen Angaben:
   • Name der Plattform und ob sie in der Cloud oder auf Ihren eigenen Servern läuft
   • Link zur API-Dokumentation der Plattform
   • gewünschte Daten in MuchSkills, etwa Katalog, Kursabschlüsse oder Zertifikate
   • Personenkreis, der einbezogen werden soll
   • technische Ansprechperson auf Ihrer Seite
   • Sie erhalten dann eine Rückmeldung von uns, was möglich ist. Zu einer individuellen Einrichtung gehört ein technischer Termin zwischen Ihrem Administrator und unserem CTO.

Prüfen, ob alles funktioniert

• API: Der Zertifikatsaufruf antwortet mit 200 und liefert das Zertifikat mit seinen aktiven Zeiträumen. Das Zertifikat erscheint bei der Person unter My Skills › My Certifications.
• Ziele: Das Ziel erscheint bei der Person unter My Growth › Goals.
• Learning Library: Der Kurs ist in der Library aufgeführt und wird Personen, denen eine verschlagwortete Kompetenz fehlt, unter My Growth › Gap Analysis angezeigt.

Ihr Nutzen

• Alle Nachweise an einem Ort. Zertifikate von jeder Plattform liegen bei den übrigen, mit Datum, Nachweisdateien und lückenloser Historie.
• Lernen, das bei den Lücken ansetzt. Mit Kompetenzen verknüpfte Kurse erscheinen genau dort, wo man sieht, was einem noch fehlt.
• Kein Lock-in. Sie behalten Ihre Lernplattform, MuchSkills läuft parallel dazu.

Wichtige Hinweise

Noch kein Endpunkt für Kursaktivitäten. Die API nimmt Zertifikate und Ziele entgegen, aber keinen Kursfortschritt und keine Kursabschlüsse. Wenn Sie Aktivitäten von einer Plattform ohne nativen Connector benötigen, fragen Sie einen individuellen Connector an.

Zertifikate werden als Historie geführt. Jeder Aufruf ergänzt einen Zeitraum, in dem die Person das Zertifikat hält. Fehler korrigieren Sie, indem Sie den Zeitraum per PATCH /api/v1/user-certifications/{periodId} anpassen, statt ihn zu löschen und neu zu senden.

Links oder Dateien als Nachweis. Ein Link in urls wird so gespeichert, wie er ist, und funktioniert nicht mehr, sobald die Quelle die Datei verschiebt. Wenn Sie eine dauerhafte Kopie behalten möchten, laden Sie die Datei selbst hoch. Pro Zertifikatszeitraum sind bis zu 10 Anhänge mit je maximal 10 MB möglich.

Regeln für Ziele. Eine Person kann pro Kompetenz oder Zertifikat ein offenes Ziel haben. Ein Zertifikat, das sie bereits besitzt, kann kein Ziel werden.

Anfragelimits. Wenn Sie Anfragen zu schnell senden, antwortet die API mit 429. Warten Sie und versuchen Sie es mit zunehmend längeren Pausen erneut. Die Aufrufe für Ziele erlauben eine Anfrage pro Sekunde und Token.

Fehlerbehebung