Condivisione e verifica

Ogni riconoscimento su badges.ninja dispone di una pagina pubblica di verifica accessibile a chiunque senza necessità di accedere. I destinatari possono condividere i propri badge sui social media, via email o copiando un link diretto.

Anche i destinatari hanno il proprio portale

Se hai ottenuto un badge tramite badges.ninja, puoi accedere (senza password) su badges.ninja/me per visualizzare tutti i tuoi badge in un unico posto e curare un profilo pubblico su badges.ninja/u/<il-tuo-handle>. Vedi Portale del destinatario.

Pagina pubblica del riconoscimento

Ogni riconoscimento ha un URL pubblico:

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

Questa pagina mostra l'immagine del badge (caricata da IPFS), il nome e la descrizione del badge, il nome del destinatario, il nome e il logo dell'emittente, la data di emissione e l'eventuale data di scadenza, nonché i criteri soddisfatti dal destinatario per ottenere il badge. Chiunque disponga del link può aprire la pagina per confermare che la credenziale sia autentica.

Se l'emittente ha impostato un ID organizzazione LinkedIn, viene visualizzato il pulsante Add to LinkedIn profile, in modo che il destinatario possa salvare la credenziale direttamente nella sezione Licenze e Certificazioni di LinkedIn. Il pulsante Download Badge fornisce l'immagine originale del badge (direttamente da IPFS), mentre Download PDF genera al volo un certificato A4 stampabile.

Pagina pubblica di condivisione

La pagina di condivisione offre opzioni di condivisione social:

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

Da questa pagina, i destinatari possono condividere il proprio badge su:

• LinkedIn — pubblica nel feed LinkedIn oppure aggiunge la credenziale direttamente al profilo tramite il pulsante Add to LinkedIn Profile (quando l'emittente ha impostato un ID organizzazione LinkedIn)
• Twitter / X — pubblica un tweet con il link del badge e un testo personalizzato
• Facebook — condivide sulla propria bacheca Facebook
• WhatsApp — invia un messaggio con il link del badge
• Telegram — invia un messaggio con il link del badge
• Send Email — apre un modale nella pagina che invia un'email formattata a uno o più destinatari (vedi Condivisione via email qui sotto)
• Copy Link — copia l'URL di verifica negli appunti
• Embed snippets — copia codice HTML <img> e <iframe> pronto all'uso per inserire il badge in un sito web, in una intranet o in una firma email

Verifica QR

Una pagina di verifica dedicata mostra un codice QR scansionabile che punta al proprio URL — perfetto per certificati stampati, banner di eventi o screenshot LinkedIn.

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

Chiunque scansioni il QR con la fotocamera del telefono atterra sulla pagina di verifica live, dove può confermare che il badge è ospitato su badges.ninja, segue la specifica Open Badge v2.0 e (sul piano Pro) è ancorato on-chain tramite Matchain. L'identità del destinatario viene mostrata come hash SHA-256, in modo che le email non siano mai esposte pubblicamente.

Certificato PDF

Ogni riconoscimento dispone di un pulsante Download Certificate sulla pagina pubblica di verifica. Cliccandolo si genera al volo un PDF A4 pronto per la stampa che include l'immagine del badge, il nome del destinatario, l'emittente, i criteri, la data di emissione, la scadenza opzionale e un codice QR che riporta all'URL di verifica live.

Anteprime sui social media

Quando un link a un badge viene condiviso su LinkedIn, X, Slack, Facebook, WhatsApp o via email, la piattaforma recupera l'endpoint di condivisione e renderizza una scheda ricca a partire dai metadati Open Graph emessi da badges.ninja:

• Immagine del badge come immagine di anteprima
• Nome del badge come titolo
• Nome dell'emittente e del destinatario nella descrizione

Questo garantisce che i badge appaiano professionali ovunque vengano condivisi — i destinatari non devono allegare la propria immagine né scrivere testi. L'anteprima viene generata lato server su /certify-badge/award/{guid}/share-html e memorizzata nella cache sull'edge della CDN, quindi le anteprime appaiono istantaneamente anche alla prima condivisione.

Condivisione via email

È possibile inviare i riconoscimenti dei badge via email in due modi:

Dalla pagina pubblica di condivisione

I destinatari possono condividere il proprio badge con amici, mentori o potenziali datori di lavoro cliccando Send Email sulla pagina di condivisione. Si apre un modale in cui inserire uno o più indirizzi email, un oggetto opzionale e un messaggio personale:

Ogni destinatario riceve un'email HTML formattata con il messaggio personale del mittente e un pulsante a un clic per visualizzare la pagina pubblica del riconoscimento:

Dalla dashboard

Gli emittenti possono inviare via email qualsiasi riconoscimento dalla pagina Awards della dashboard:

1. Trova il riconoscimento nella pagina Awards.
2. Clicca il pulsante Send sulla riga, oppure apri il modale di dettaglio e clicca Resend email.
3. Inserisci l'email del destinatario e invia.

Per entrambi i flussi viene utilizzato lo stesso modello di email.

Endpoint JSON Open Badge v2.0

Per garantire l'interoperabilità con altre piattaforme di badge, badges.ninja fornisce JSON Open Badge v2.0 standard sui seguenti endpoint pubblici:

Endpoint	Descrizione
/certify-badge/issuer/{guid}	JSON del profilo dell'emittente
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (il riconoscimento)

Questi endpoint restituiscono JSON-LD conforme alla specifica Open Badge v2.0. Altre piattaforme di badge e verificatori possono utilizzare questi dati per validare le credenziali.

Esempio — verifica di un riconoscimento:

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 delle immagini IPFS

Le immagini dei badge sono pinned su IPFS (l'InterPlanetary File System) attraverso il nostro gateway, ipfs.ninja. Ciò significa che:

• Le immagini sono permanenti e indirizzate per contenuto — non possono essere manomesse né sostituite silenziosamente
• Gli URL delle immagini nel JSON Open Badge appaiono come https://ipfs.ninja/ipfs/{cid}
• Lo stesso content-ID è risolvibile attraverso qualsiasi gateway IPFS pubblico (cloudflare-ipfs.com, ipfs.io, ecc.) — i tuoi badge non sono vincolati a un unico fornitore

Poiché l'immagine fa parte dell'assertion Open Badge, sostituire in seguito la grafica del badge non invalida i riconoscimenti già emessi: il vecchio CID IPFS rimane risolvibile per sempre, quindi i riconoscimenti storici conservano la propria immagine originale anche se ridisegnerai il badge per nuove emissioni.