Delning och verifiering

Varje credential på badges.ninja har en publik verifieringssida som vem som helst kan komma åt 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 tjänat ett märke via badges.ninja kan du logga in (utan lösenord) på badges.ninja/me för att se alla dina märken på ett ställe och kurera en publik profil på badges.ninja/u/<your-handle>. Se Mottagarportal.

Publik credential-sida

Varje credential har en publik URL:

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

Sidan visar märkesbilden, märkets namn och beskrivning, mottagarens namn, utfärdarens namn och logotyp, utfärdandedatum och eventuellt utgångsdatum samt de kriterier mottagaren uppfyllde för att få märket. Alla som har länken kan öppna sidan och bekräfta att credentialen är äkta.

Credential-sidan visar alltid en Add to LinkedIn profile-knapp så att mottagaren kan spara credentialen direkt i sina LinkedIn Licenses & Certifications. (Om utfärdaren har angett ett LinkedIn-organisations-ID fyller LinkedIn i den verifierade företagssidan i förväg; annars används utfärdarens namn.) En enda Download-rullgardinsmeny erbjuder två alternativ: Badge image (original-PNG) och Certificate (en utskriftsvänlig A4-PDF som genereras direkt på /certify-badge/award/{guid}/pdf).

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 — publicerar märket i deras LinkedIn-flöde (för att lägga till credentialen direkt i profilen, använd i stället knappen Add to LinkedIn profile på credential-sidan)
• Twitter / X — publicerar ett inlägg med märkeslänken och en 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 på sidan som skickar ett formaterat e-postmeddelande till en eller flera mottagare (se Delning via e-post nedan)
• Copy Link — kopierar verifierings-URL:en till urklipp
• Inbäddningskod — kopiera färdig <img>- och <iframe>-HTML för att lägga in märket på en webbplats, ett intranät eller i en e-postsignatur

QR-verifiering

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

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

Den som skannar QR-koden med mobilkameran hamnar på den levande verifieringssidan, där de kan bekräfta att märket ligger på badges.ninja och följer specifikationen Open Badge v2.0. Mottagarens identitet visas som en SHA-256-hash så att e-postadresser aldrig exponeras publikt.

PDF-certifikat

Varje credential kan laddas ned som ett utskriftsklart A4-PDF-certifikat. Alternativet Certificate finns i rullgardinsmenyn Download på den publika credential-sidan (/awards/{guid}) — inte på verifieringssidan, som bara har den skanningsbara QR-koden och den råa Open Badge-JSON:en. När du väljer det genereras PDF:en direkt (på /certify-badge/award/{guid}/pdf) med märkesbild, mottagarens namn, utfärdare, kriterier, utfärdandedatum, valfritt utgångsdatum och en QR-kod som länkar tillbaka till den levande 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 delningsslutpunkten och renderar ett rikt kort från de Open Graph-metadata som badges.ninja skickar:

• Märkesbilden som förhandsgranskningsbild
• Märkets namn som rubrik
• Utfärdarens och mottagarens namn i beskrivningen

Det gör att märken ser professionella ut oavsett var de delas — mottagare behöver varken bifoga en egen bild eller skriva någon text. Förhandsvisningen genereras på serversidan på /certify-badge/award/{guid}/share-html och cachas i CDN-kanten, så förhandsvisningar visas direkt redan vid första delningen.

Delning via e-post

Du kan skicka credentials 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 formaterat HTML-e-postmeddelande med mottagarens personliga meddelande och en knapp för att öppna den publika credential-sidan med ett klick:

Från instrumentpanelen

Utfärdare kan skicka vilken credential som helst via e-post från sidan Credentials på instrumentpanelen:

1. Hitta credentialen på sidan Credentials.
2. Klicka på knappen Send på raden, eller öppna detaljmodalen och klicka på Resend email.
3. Ange mottagarens e-postadress och skicka.

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

JSON-slutpunkter för Open Badge v2.0

För interoperabilitet med andra märkesplattformar tillhandahåller badges.ninja standardiserad Open Badge v2.0-JSON på dessa publika slutpunkter:

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

Dessa slutpunkter returnerar JSON-LD som följer specifikationen Open Badge v2.0. Andra märkesplattformar och verifierare kan använda datan för att validera credentials.

Exempel — verifiera en credential:

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 märkesbilder

Märkesbilder lagras på Amazon S3 och levereras via vårt globala CDN under en innehållsadresserad, oföränderlig URL som härleds från en kryptografisk hash (SHA-256) av bildens bytes. Det innebär:

• Bilderna är permanenta och innehållsadresserade — URL:en härleds från själva bytesen, så de kan inte manipuleras eller i tysthet bytas ut
• Bild-URL:er i Open Badge-JSON ser ut så här: https://badges.ninja/images/{sha256}.png
• Bilderna levereras från CDN-kanten, så de laddas snabbt överallt i världen och finns kvar under hela credentialens livstid

Eftersom bilden är en del av Open Badge-assertionen bryter ett senare byte av märkets grafik inte tidigare utfärdade credentials: originalbilden behåller sin egen innehållsadresserade URL, så äldre credentials behåller sin ursprungliga bild även om du omdesignar märket för nya utfärdanden.