Teilen & Verifizierung

Jede Auszeichnung auf badges.ninja verfügt über eine öffentliche Verifizierungsseite, die jeder ohne Anmeldung aufrufen kann. Empfänger können ihre Abzeichen in sozialen Medien, per E-Mail oder durch Kopieren eines direkten Links teilen.

Auch Empfänger haben ihr eigenes Portal

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

Öffentliche Auszeichnungsseite

Jede Auszeichnung hat eine öffentliche URL:

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

Diese Seite zeigt das Abzeichenbild (geladen aus IPFS), den Namen und die Beschreibung des Abzeichens, den Namen des Empfängers, den Namen und das Logo des Ausstellers, das Ausstellungsdatum und ein eventuelles Ablaufdatum sowie die Kriterien, die der Empfänger erfüllt hat, um das Abzeichen zu erhalten. Jeder mit dem Link kann die Seite öffnen, um zu bestätigen, dass die Berechtigung authentisch ist.

Wenn der Aussteller eine LinkedIn-Organisations-ID hinterlegt hat, erscheint die Schaltfläche Zum LinkedIn-Profil hinzufügen, sodass der Empfänger die Berechtigung direkt in seine LinkedIn-Lizenzen und -Zertifizierungen übernehmen kann. Die Schaltfläche Abzeichen herunterladen liefert das originale Abzeichenbild (direkt aus IPFS), und PDF herunterladen erzeugt spontan ein druckfertiges A4-Zertifikat.

Öffentliche Teilen-Seite

Die Teilen-Seite bietet Optionen für das Teilen in sozialen Netzwerken:

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

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

• LinkedIn — postet im LinkedIn-Feed oder fügt die Berechtigung über die Schaltfläche Add to LinkedIn Profile direkt zum Profil hinzu (wenn der Aussteller eine LinkedIn-Organisations-ID gesetzt hat)
• Twitter / X — veröffentlicht einen Tweet mit dem Abzeichenlink und einem benutzerdefinierten Teilen-Text
• Facebook — teilt in der Facebook-Chronik
• WhatsApp — sendet eine Nachricht mit dem Abzeichenlink
• Telegram — sendet eine Nachricht mit dem Abzeichenlink
• Send Email — öffnet ein Modalfenster auf der Seite, das eine gestaltete E-Mail an einen oder mehrere Empfänger zustellt (siehe E-Mail-Versand unten)
• Copy Link — kopiert die Verifizierungs-URL in die Zwischenablage
• Embed snippets — kopiert fertig einsetzbares <img>- und <iframe>-HTML, um das Abzeichen in eine Website, ein Intranet oder eine E-Mail-Signatur einzubetten

QR-Verifizierung

Eine eigene Verifizierungsseite stellt einen scanbaren QR-Code dar, der auf seine eigene URL verweist — perfekt für gedruckte Zertifikate, Veranstaltungsbanner oder LinkedIn-Screenshots.

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

Wer den QR-Code mit einer Smartphone-Kamera scannt, gelangt auf die Live-Verifizierungsseite, wo bestätigt werden kann, dass das Abzeichen auf badges.ninja gehostet ist, der Open Badge v2.0-Spezifikation entspricht und (im Pro-Tarif) über Matchain on-chain verankert ist. Die Identität des Empfängers wird als SHA-256-Hash angezeigt, sodass E-Mail-Adressen niemals öffentlich sichtbar sind.

PDF-Zertifikat

Jede Auszeichnung verfügt über eine Schaltfläche Zertifikat herunterladen auf der öffentlichen Verifizierungsseite. Ein Klick darauf erzeugt spontan ein druckfertiges A4-PDF, das das Abzeichenbild, den Namen des Empfängers, den Aussteller, die Kriterien, das Ausstellungsdatum, ein optionales Ablaufdatum und einen QR-Code enthält, der zur Live-Verifizierungs-URL zurückführt.

Vorschauen in sozialen Medien

Wenn ein Abzeichenlink auf LinkedIn, X, Slack, Facebook, WhatsApp oder per E-Mail geteilt wird, ruft die Plattform den Share-Endpunkt ab und stellt eine Rich-Card aus den Open-Graph-Metadaten dar, die badges.ninja ausgibt:

• Abzeichenbild als Vorschaubild
• Abzeichenname als Titel
• Aussteller- und Empfängername in der Beschreibung

So sehen Abzeichen überall professionell aus, wenn sie geteilt werden — Empfänger müssen kein eigenes Bild anhängen oder Texte schreiben. Die Vorschau wird serverseitig unter /certify-badge/award/{guid}/share-html erzeugt und am CDN-Edge zwischengespeichert, sodass Vorschauen sofort erscheinen, sogar beim ersten Teilen.

E-Mail-Versand

Du kannst Abzeichen-Auszeichnungen auf zwei Arten per E-Mail senden:

Über die öffentliche Teilen-Seite

Empfänger können ihr Abzeichen mit Freunden, Mentoren 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:

Jeder Adressat erhält eine gestaltete HTML-E-Mail mit der persönlichen Nachricht des Absenders und einer Ein-Klick-Schaltfläche, um die öffentliche Auszeichnungsseite anzuzeigen:

Über das Dashboard

Aussteller können jede Auszeichnung per E-Mail über die Auszeichnungsseite im Dashboard versenden:

1. Suche die Auszeichnung auf der Auszeichnungsseite.
2. Klicke auf die Schaltfläche Senden in der Zeile oder öffne das Detailmodal und klicke auf E-Mail erneut senden.
3. Gib die E-Mail-Adresse des Empfängers ein und sende sie ab.

Für beide Abläufe wird dieselbe E-Mail-Vorlage verwendet.

Open Badge v2.0 JSON-Endpunkte

Für die Interoperabilität mit anderen Abzeichenplattformen stellt badges.ninja standardmäßiges Open Badge v2.0 JSON unter diesen öffentlichen Endpunkten bereit:

Endpunkt	Beschreibung
/certify-badge/issuer/{guid}	JSON des Ausstellerprofils
/certify-badge/badge/{guid}	BadgeClass-JSON
/certify-badge/award/{guid}	Assertion-JSON (die Auszeichnung)

Diese Endpunkte liefern JSON-LD, das mit der Open Badge v2.0-Spezifikation konform ist. Andere Abzeichenplattformen und Verifizierer können diese Daten konsumieren, um Berechtigungen zu validieren.

Beispiel — eine Auszeichnung 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"
  }
}

IPFS-Bild-URLs

Abzeichenbilder werden in IPFS (dem InterPlanetary File System) über unser eigenes Gateway ipfs.ninja gepinnt. Das bedeutet:

• Bilder sind dauerhaft und inhaltsadressiert — sie können nicht manipuliert oder unbemerkt ersetzt werden
• Bild-URLs im Open-Badge-JSON sehen aus wie https://ipfs.ninja/ipfs/{cid}
• Dieselbe Inhalts-ID lässt sich über jedes öffentliche IPFS-Gateway auflösen (cloudflare-ipfs.com, ipfs.io usw.) — deine Abzeichen sind nicht an einen einzelnen Anbieter gebunden

Da das Bild Teil der Open-Badge-Assertion ist, führt ein späterer Austausch des Abzeichenmotivs nicht zum Bruch zuvor ausgestellter Auszeichnungen: Die alte IPFS-CID bleibt für immer auflösbar, sodass historische Auszeichnungen ihr ursprüngliches Bild behalten, auch wenn du das Abzeichen für neue Ausstellungen neu gestaltest.