Teilen & Verifizierung

Jeder Nachweis auf badges.ninja hat eine öffentliche Verifizierungsseite, die jeder ohne Anmeldung aufrufen kann. Empfänger:innen können ihre Badges in sozialen Medien, per E-Mail oder über einen direkten Link teilen.

Empfänger:innen haben auch ein eigenes Portal

Wenn du ein Badge über badges.ninja erhalten hast, kannst du dich (ohne Passwort) unter badges.ninja/me anmelden, um alle deine Badges an einem Ort zu sehen und ein öffentliches Profil unter badges.ninja/u/<your-handle> zu gestalten. Siehe Empfängerportal.

Öffentliche Nachweisseite

Jeder Nachweis hat eine öffentliche URL:

https://badges.ninja/awards/{guid}

Diese Seite zeigt das Badge-Bild, Name und Beschreibung des Badges, den Namen der Empfängerin bzw. des Empfängers, Name und Logo des Ausstellers, das Ausstellungsdatum und ein eventuelles Ablaufdatum sowie die Kriterien, die für den Erhalt des Badges erfüllt wurden. Jeder mit dem Link kann die Seite öffnen und die Echtheit des Nachweises bestätigen.

Die Nachweisseite zeigt immer eine Schaltfläche Add to LinkedIn profile, damit Empfänger:innen den Nachweis direkt unter „Licenses & Certifications" in LinkedIn speichern können. (Hat der Aussteller eine LinkedIn-Organisations-ID hinterlegt, füllt LinkedIn die verifizierte Unternehmensseite vor; andernfalls wird der Name des Ausstellers verwendet.) Ein einziges Download-Dropdown bietet zwei Optionen: Badge image (das originale PNG) und Certificate (ein druckfähiges A4-PDF, das bei Bedarf unter /certify-badge/award/{guid}/pdf erzeugt wird).

Öffentliche Teilen-Seite

Die Teilen-Seite bietet Optionen zum Teilen in sozialen Medien:

https://badges.ninja/awards/{guid}/share

Auf dieser Seite können Empfänger:innen ihr Badge teilen über:

• LinkedIn — veröffentlicht das Badge in ihrem LinkedIn-Feed (um den Nachweis direkt zum Profil hinzuzufügen, nutze stattdessen die Schaltfläche Add to LinkedIn profile auf der Nachweisseite)
• Twitter / X — veröffentlicht einen Tweet mit dem Badge-Link und individuellem Teilen-Text
• Facebook — teilt auf der Facebook-Chronik
• WhatsApp — sendet eine Nachricht mit dem Badge-Link
• Telegram — sendet eine Nachricht mit dem Badge-Link
• Send Email — öffnet ein Modal auf der Seite, das eine gestaltete E-Mail an eine oder mehrere Personen zustellt (siehe Teilen per E-Mail unten)
• Copy Link — kopiert die Verifizierungs-URL in die Zwischenablage
• Einbettungs-Snippets — kopiere fertiges <img>- und <iframe>-HTML, um das Badge in eine Website, ein Intranet oder eine E-Mail-Signatur einzufügen

QR-Verifizierung

Eine eigene Verifizierungsseite zeigt einen scanbaren QR-Code, der auf ihre eigene URL verweist – ideal für gedruckte Zertifikate, Event-Banner oder LinkedIn-Screenshots.

https://badges.ninja/verify/{guid}

Wer den QR-Code mit der Handykamera scannt, landet auf der Live-Verifizierungsseite und kann dort bestätigen, dass das Badge auf badges.ninja gehostet wird und der Open-Badge-v2.0-Spezifikation entspricht. Die Identität der Empfängerin bzw. des Empfängers wird als SHA-256-Hash angezeigt, sodass E-Mail-Adressen nie öffentlich sichtbar sind.

PDF-Zertifikat

Jeder Nachweis kann als druckfertiges A4-PDF-Zertifikat heruntergeladen werden. Die Option Certificate befindet sich im Download-Dropdown auf der öffentlichen Nachweisseite (/awards/{guid}) – nicht auf der Verifizierungsseite, die nur den scanbaren QR-Code und das rohe Open-Badge-JSON enthält. Bei Auswahl wird das PDF bei Bedarf (unter /certify-badge/award/{guid}/pdf) erzeugt – mit Badge-Bild, Name der Empfängerin bzw. des Empfängers, Aussteller, Kriterien, Ausstellungsdatum, optionalem Ablaufdatum und einem QR-Code, der auf die Live-Verifizierungs-URL zurückverweist.

Vorschau in sozialen Medien

Wenn ein Badge-Link auf LinkedIn, X, Slack, Facebook, WhatsApp oder per E-Mail geteilt wird, ruft die Plattform den Teilen-Endpunkt ab und rendert aus den von badges.ninja ausgelieferten Open-Graph-Metadaten eine ansprechende Karte:

• Badge-Bild als Vorschaubild
• Badge-Name als Titel
• Name des Ausstellers und der Empfängerin bzw. des Empfängers in der Beschreibung

So wirken Badges überall professionell, wo sie geteilt werden – Empfänger:innen müssen weder ein eigenes Bild anhängen noch Text verfassen. Die Vorschau wird serverseitig unter /certify-badge/award/{guid}/share-html erzeugt und am CDN-Edge zwischengespeichert, sodass sie selbst beim ersten Teilen sofort erscheint.

Teilen per E-Mail

Du kannst Nachweise auf zwei Wegen per E-Mail versenden:

Über die öffentliche Teilen-Seite

Empfänger:innen können ihr Badge mit Freunden, Mentor:innen oder potenziellen Arbeitgebern teilen, indem sie auf der Teilen-Seite auf Send Email klicken. Es öffnet sich ein Modal, in dem sie eine oder mehrere E-Mail-Adressen, einen optionalen Betreff und eine persönliche Nachricht eingeben:

Jede Adressatin bzw. jeder Adressat erhält eine gestaltete HTML-E-Mail mit der persönlichen Nachricht und einer Schaltfläche, die mit einem Klick die öffentliche Nachweisseite öffnet:

Über das Dashboard

Aussteller können jeden Nachweis über die Seite „Credentials" im Dashboard per E-Mail versenden:

1. Suche den Nachweis auf der Seite Credentials.
2. Klicke in der Zeile auf die Schaltfläche Send oder öffne das Detail-Modal und klicke auf Resend email.
3. Gib die E-Mail-Adresse der Empfängerin bzw. des Empfängers ein und sende ab.

Für beide Wege wird dieselbe E-Mail-Vorlage verwendet.

Open-Badge-v2.0-JSON-Endpunkte

Für die Interoperabilität mit anderen Badge-Plattformen stellt badges.ninja standardkonformes Open-Badge-v2.0-JSON unter diesen öffentlichen Endpunkten bereit:

Endpunkt	Beschreibung
/certify-badge/issuer/{guid}	JSON des Aussteller-Profils
/certify-badge/badge/{guid}	BadgeClass-JSON
/certify-badge/award/{guid}	Assertion-JSON (der Nachweis)

Diese Endpunkte liefern JSON-LD gemäß der Open-Badge-v2.0-Spezifikation. Andere Badge-Plattformen und Verifizierer können diese Daten nutzen, um Nachweise zu validieren.

Beispiel – einen Nachweis verifizieren:

curl https://api.badges.ninja/certify-badge/award/abc123-def456

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://api.badges.ninja/certify-badge/award/abc123-def456",
  "recipient": {
    "type": "email",
    "identity": "sha256$..."
  },
  "badge": "https://api.badges.ninja/certify-badge/badge/xyz789",
  "issuedOn": "2025-01-15T00:00:00.000Z",
  "verification": {
    "type": "hosted"
  }
}

Badge-Bild-URLs

Badge-Bilder werden auf Amazon S3 gespeichert und über unser globales CDN unter einer inhaltsadressierten, unveränderlichen URL ausgeliefert, die aus einem kryptografischen Hash (SHA-256) der Bild-Bytes abgeleitet wird. Das bedeutet:

• Bilder sind dauerhaft und inhaltsadressiert – die URL leitet sich aus den Bytes selbst ab, sodass sie nicht manipuliert oder unbemerkt ersetzt werden können
• Bild-URLs im Open-Badge-JSON sehen so aus: https://badges.ninja/images/{sha256}.png
• Bilder werden vom CDN-Edge ausgeliefert, laden also überall auf der Welt schnell und bleiben für die Lebensdauer des Nachweises verfügbar

Da das Bild Teil der Open-Badge-Assertion ist, beeinträchtigt ein späterer Austausch der Badge-Grafik bereits ausgestellte Nachweise nicht: Das Originalbild behält seine eigene inhaltsadressierte URL, sodass historische Nachweise ihr ursprüngliches Bild behalten, auch wenn du das Badge für neue Ausstellungen neu gestaltest.