Delning och verifiering

Varje utmärkelse på badges.ninja har en publik verifieringssida som vem som helst kan nå utan att logga in. Mottagare kan dela sina märken på sociala medier, via e-post eller genom att kopiera en direktlänk.

Mottagare har också en egen portal

Om du har tilldelats ett märke via badges.ninja kan du logga in (inget lösenord behövs) på badges.ninja/me för att se alla dina märken på ett ställe och kuratera en publik profil på badges.ninja/u/<ditt-användarnamn>. Se Mottagarportalen.

Publik utmärkelsessida

Varje utmärkelse har en publik URL:

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

Den här sidan visar märkets bild (laddad från IPFS), märkets namn och beskrivning, mottagarens namn, utfärdarens namn och logotyp, utfärdandedatum och eventuellt utgångsdatum samt de kriterier som mottagaren uppfyllt för att tjäna märket. Vem som helst med länken kan öppna sidan för att bekräfta att meritbeviset är äkta.

Om utfärdaren har angett ett LinkedIn-organisations-ID visas knappen Lägg till på LinkedIn-profil så att mottagaren kan spara meritbeviset direkt i sina LinkedIn-licenser och certifieringar. Knappen Ladda ner märke levererar märkets originalbild (direkt från IPFS), och Ladda ner PDF genererar ett utskrivbart A4-certifikat i farten.

Publik delningssida

Delningssidan erbjuder alternativ för delning på sociala medier:

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

Från den här sidan kan mottagare dela sitt märke på:

• LinkedIn — postar i deras LinkedIn-flöde, eller lägger till meritbeviset direkt på profilen via knappen Lägg till på LinkedIn-profil (när utfärdaren har angett ett LinkedIn-organisations-ID)
• Twitter / X — postar en tweet med märkeslänken och anpassad delningstext
• Facebook — delar på deras Facebook-tidslinje
• WhatsApp — skickar ett meddelande med märkeslänken
• Telegram — skickar ett meddelande med märkeslänken
• Send Email — öppnar en modal direkt på sidan som levererar ett stilfullt e-postmeddelande till en eller flera mottagare (se Delning via e-post nedan)
• Copy Link — kopierar verifieringens URL till urklipp
• Embed snippets — kopierar färdiga <img>- och <iframe>-HTML-snuttar för att lägga in märket på en webbplats, ett intranät eller i en e-postsignatur

QR-verifiering

En dedikerad verifieringssida renderar en skanningsbar QR-kod som pekar på sin egen URL — perfekt för utskrivna certifikat, evenemangsbanderoller eller LinkedIn-skärmdumpar.

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

Vem som helst som skannar QR-koden med en mobilkamera hamnar på den live verifieringssidan, där de kan bekräfta att märket finns på badges.ninja, följer Open Badge v2.0-specifikationen och (på Pro-planen) är förankrat på kedjan via Matchain. Mottagarens identitet visas som en SHA-256-hash så att e-postadresser aldrig exponeras publikt.

PDF-certifikat

Varje utmärkelse har en knapp Download Certificate på den publika verifieringssidan. När du klickar genereras en utskriftsfärdig A4-PDF i farten som innehåller märkesbilden, mottagarens namn, utfärdaren, kriterier, utfärdandedatum, valfritt utgångsdatum och en QR-kod som länkar tillbaka till den live verifierings-URL:en.

Förhandsvisningar på sociala medier

När en märkeslänk delas på LinkedIn, X, Slack, Facebook, WhatsApp eller via e-post hämtar plattformen delningsendpointen och renderar ett rikt kort från de Open Graph-metadata som badges.ninja sänder ut:

• Märkesbilden som förhandsvisningsbild
• Märkets namn som titel
• Utfärdarens namn och mottagarens namn i beskrivningen

Detta säkerställer att märken ser professionella ut när de delas var som helst — mottagare behöver inte bifoga en egen bild eller skriva text. Förhandsvisningen genereras på serversidan vid /certify-badge/award/{guid}/share-html och cachas på CDN-edgen, så förhandsvisningar visas omedelbart även vid första delningen.

Delning via e-post

Du kan skicka utmärkelser via e-post på två sätt:

Från den publika delningssidan

Mottagare kan dela sitt märke med vänner, mentorer eller potentiella arbetsgivare genom att klicka på Send Email på delningssidan. En modal öppnas där de anger en eller flera e-postadresser, ett valfritt ämne och ett personligt meddelande:

Varje adressat får ett stilfullt HTML-e-postmeddelande med mottagarens personliga meddelande och en knapp med ett klick för att visa den publika utmärkelsessidan:

Från instrumentpanelen

Utfärdare kan skicka vilken utmärkelse som helst via e-post från sidan Awards i instrumentpanelen:

1. Hitta utmärkelsen på sidan Awards.
2. Klicka på knappen Send på raden, eller öppna detaljmodalen och klicka på Resend email.
3. Ange mottagarens e-post och skicka.

Samma e-postmall används för båda flödena.

Open Badge v2.0 JSON-endpoints

För interoperabilitet med andra märkesplattformar tillhandahåller badges.ninja standard Open Badge v2.0 JSON vid dessa publika endpoints:

Endpoint	Beskrivning
/certify-badge/issuer/{guid}	JSON för utfärdarprofil
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (utmärkelsen)

Dessa endpoints returnerar JSON-LD som följer Open Badge v2.0-specifikationen. Andra märkesplattformar och verifierare kan konsumera dessa data för att validera meritbevis.

Exempel — verifiera en utmärkelse:

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"
  }
}

URL:er för IPFS-bilder

Märkesbilder pinnas till IPFS (the InterPlanetary File System) via vår egen gateway, ipfs.ninja. Detta innebär:

• Bilder är permanenta och innehållsadresserade — de kan inte manipuleras eller tyst ersättas
• Bild-URL:er i Open Badge JSON ser ut som https://ipfs.ninja/ipfs/{cid}
• Samma innehålls-ID kan lösas via vilken publik IPFS-gateway som helst (cloudflare-ipfs.com, ipfs.io osv.) — dina märken är inte låsta till en enda leverantör

Eftersom bilden är en del av Open Badge-assertionen kan en senare ersättning av märkets grafik inte bryta tidigare utfärdade utmärkelser: det gamla IPFS-CID:t förblir lösbart för alltid, så historiska utmärkelser behåller sin originalbild även om du designar om märket för nya utfärdanden.