DEV Community

Nacho Coll
Nacho Coll

Posted on

Verifizierbare digitale Zertifikate mit BADGES.ninja ausstellen: deutscher Leitfaden für Entwickler und Bildungsanbieter

Der deutsche Markt für Online-Weiterbildung und IHK-Zertifikatslehrgänge wächst stetig. Plattformen wie openHPI, Udemy, die IHK-Akademien, oncampus, OPEN vhb oder die zahlreichen Anbieter beruflicher Fortbildung qualifizieren jedes Jahr Hunderttausende Lernende — doch viele Anbieter verschicken nach wie vor ein einfaches PDF als Teilnahmenachweis.

Ein PDF ist nicht überprüfbar, lässt sich nur schlecht in LinkedIn integrieren und überdauert kaum den nächsten Provider-Wechsel. BADGES.ninja ist eine Plattform für digitale Zertifikate nach dem Open-Badge-v2.0-Standard, die genau dieses Problem löst — und die nativ auf Deutsch (Deutschland und Österreich) zur Verfügung steht.

In diesem Leitfaden zeige ich, wie man Zertifikate per REST-API ausstellt, eine CSV-Massenausstellung integriert und welche Funktionen ich für deutschsprachige Bildungsanbieter besonders interessant finde.

Warum Open Badge v2.0?

Open Badge v2.0 ist der offene Standard von IMS Global für interoperable digitale Zertifikate. Im Gegensatz zu einem PDF enthält jedes Open Badge maschinenlesbare Metadaten (Aussteller, Empfänger, Kriterien, Ausstellungsdatum, Ablauf, Belege) und eine Hosting-URL, über die jeder Drittanbieter das Zertifikat verifizieren kann. Es funktioniert genau wie ein Webstandard: ein verifizierbares JSON-Dokument mit eingebetteter PNG- oder SVG-Grafik.

Der wichtige Unterschied: Wenn jemand die Authentizität eines Zertifikats prüfen will, fragt er nicht den Empfänger, sondern den Aussteller — kryptografisch.

Die REST-API in der Praxis

BADGES.ninja stellt eine vollständige REST-API mit X-Api-Key-Authentifizierung bereit — auch im kostenlosen Plan. Das ist ein deutlicher Unterschied zu den meisten Konkurrenten, die programmatischen Zugriff den Enterprise-Tarifen vorbehalten.

Beispiel: einen neuen Aussteller (Issuer) anlegen:

curl -X POST https://api.badges.ninja/issuers \
  -H "X-Api-Key: bws_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "parameters": {
      "name": "Meine Akademie",
      "url": "https://example.com",
      "email": "admin@example.com"
    }
  }'
Enter fullscreen mode Exit fullscreen mode

Antwort:

{
  "statusCode": 200,
  "info": {
    "issuerId": "https://api.badges.ninja/certify-badge/issuer/abc123-def456"
  }
}
Enter fullscreen mode Exit fullscreen mode

Die issuerId ist eine permanente URL, die im JSON-LD-Kontext des Open-Badge-Dokuments referenziert wird. Genauso einfach: ein Badge anlegen, ein Award (Zertifikat) ausstellen, einen Empfänger benachrichtigen — alles über einen einzigen REST-Endpunkt.

Massenausstellung per CSV

Wer einmal versucht hat, Zertifikate für 2.000 Bootcamp-Absolventen einzeln auszustellen, kennt das Problem. Die /awards/bulk-Funktion in BADGES.ninja akzeptiert eine CSV-Datei mit Empfängerdaten und übernimmt den Rest:

  • automatische Wiederholung bei Fehlern
  • Pause/Wiederaufnahme bei Unterbrechung
  • E-Mail-Benachrichtigung mit individuellem Zertifikatslink
  • Status-Webhook für jedes ausgegebene Badge

Genau die Art Engineering-Detail, die man zu schätzen weiß, wenn der Prozess mitten im Versand abbricht.

IPFS-Speicherung: Permanenz für die Bildlinks

Ein digitales Zertifikat sollte so lange bestehen wie ein Papierdiplom. Das Problem klassischer Lösungen: Die Badge-Bilder werden auf herkömmlichen Servern gehostet und verschwinden, sobald der Anbieter geschlossen oder gewechselt wird.

BADGES.ninja speichert die Badge-Grafiken auf IPFS (dezentrales Speichersystem). Selbst wenn die Plattform irgendwann eingestellt würde, bleibt das Bild über jeden IPFS-Gateway abrufbar — über seinen Content-Hash. Für eine Hochschule, eine IHK-Akademie oder eine öffentliche Bildungseinrichtung ein gewichtiges Argument.

Optionale Blockchain-Verankerung

Zertifikate aus dem Pro-Plan können optional auf einer öffentlichen Blockchain verankert werden. Das fügt eine vom Aussteller unabhängige kryptografische Verifizierungsschicht hinzu — sinnvoll für Fälle, in denen Verifizierbarkeit besonders wichtig ist: regulierte Berufsabschlüsse, Compliance-Zertifikate, medizinische Fortbildung, BAFA-geförderte Maßnahmen.

Wichtig: Es ist optional. Viele Bildungsanbieter brauchen die Blockchain-Schicht nicht, und das ist völlig in Ordnung.

Empfängerportal und LinkedIn-Integration

Der Wert eines Zertifikats hängt davon ab, wie der Empfänger es nutzt. BADGES.ninja bringt ein passwortloses Empfängerportal unter badges.ninja/me mit. Jeder Empfänger sammelt dort alle seine Zertifikate und kann ein öffentliches Profil unter badges.ninja/u/<alias> anlegen.

Zusätzlich enthält jede öffentliche Zertifikatsseite:

  • einen Ein-Klick-Button „Zu LinkedIn-Profil hinzufügen"
  • ein herunterladbares PDF-Zertifikat
  • einen scanbaren QR-Code für gedruckte Lebensläufe
  • eine öffentliche Verifizierungs-URL

Mehrsprachigkeit als Differenzierungsmerkmal

Praktisch alle führenden Plattformen für digitale Zertifikate sind in Englisch entwickelt und übersetzen bestenfalls die Benutzeroberfläche. BADGES.ninja ist von Anfang an mehrsprachig — über 30 Sprachen werden unterstützt, einschließlich Deutsch (Deutschland und Österreich). Sowohl Aussteller als auch Empfänger können ihre Zertifikate in der eigenen Sprache verwalten und teilen.

Für eine deutsche IHK-Akademie, eine österreichische WIFI-Niederlassung, eine Schweizer Fachhochschule oder eine EdTech-Plattform in der DACH-Region ist das kein Detail, sondern eine echte Adoptionsanforderung.

Kostenloser Plan zum Starten

Der kostenlose Plan erlaubt bis zu 100 Ausstellungen pro Monat — genug, um das Format zu validieren oder eine kleine Tech-Community zu zertifizieren, ohne Kreditkarte. Sinnvolle Standardgrenze, die viele Konkurrenten so nicht bieten.

Fazit

Wenn ihr Kurse, Bootcamps, betriebliche Schulungen, Workshops oder IHK-Zertifikatslehrgänge anbietet und eure Zertifikatsausgabe modernisieren möchtet, lade ich euch ein, BADGES.ninja unter https://badges.ninja auszuprobieren. Der kostenlose Plan deckt 100 Ausstellungen pro Monat ab, ohne Kreditkarte und ohne Zeitlimit.

Fragen, Feedback oder Use Cases? Lasst es in den Kommentaren wissen — ich antworte gerne. 🎓

Top comments (0)