Partilha e verificação

Cada atribuição no badges.ninja tem uma página pública de verificação a que qualquer pessoa pode aceder sem iniciar sessão. Os destinatários podem partilhar os seus emblemas nas redes sociais, por correio eletrónico ou copiando uma ligação direta.

Os destinatários também têm o seu próprio portal

Se ganhaste um emblema através do badges.ninja, podes iniciar sessão (sem necessidade de palavra-passe) em badges.ninja/me para veres todos os teus emblemas num só sítio e construíres um perfil público em badges.ninja/u/<o-teu-handle>. Vê Portal do Destinatário.

Página pública da atribuição

Cada atribuição tem um URL público:

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

Esta página apresenta a imagem do emblema (carregada a partir do IPFS), o nome e a descrição do emblema, o nome do destinatário, o nome e o logótipo da entidade emissora, a data de emissão e a eventual data de validade, bem como os critérios que o destinatário cumpriu para obter o emblema. Qualquer pessoa com a ligação pode abrir a página para confirmar que a credencial é autêntica.

Se a entidade emissora tiver definido um ID de organização do LinkedIn, surge o botão Adicionar ao perfil do LinkedIn, para que o destinatário guarde a credencial diretamente nas suas Licenças e Certificações do LinkedIn. O botão Transferir emblema disponibiliza a imagem original do emblema (diretamente a partir do IPFS), e Transferir PDF gera, no momento, um certificado A4 pronto a imprimir.

Página pública de partilha

A página de partilha disponibiliza opções para divulgação social:

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

A partir desta página, os destinatários podem partilhar o seu emblema em:

• LinkedIn — publica no feed do LinkedIn ou adiciona a credencial diretamente ao perfil através do botão Add to LinkedIn Profile (quando a entidade emissora tem definido um ID de organização do LinkedIn)
• Twitter / X — publica um tweet com a ligação do emblema e um texto de partilha personalizado
• Facebook — partilha na cronologia do Facebook
• WhatsApp — envia uma mensagem com a ligação do emblema
• Telegram — envia uma mensagem com a ligação do emblema
• Send Email — abre uma janela modal na própria página que envia um e-mail estilizado para um ou vários destinatários (vê Partilha por e-mail mais abaixo)
• Copy Link — copia o URL de verificação para a área de transferência
• Embed snippets — copia HTML pronto (<img> e <iframe>) para colocar o emblema num sítio Web, intranet ou assinatura de correio eletrónico

Verificação por QR

Uma página dedicada à verificação apresenta um código QR digitalizável que aponta para o seu próprio URL — ideal para certificados impressos, telões de eventos ou capturas de ecrã no LinkedIn.

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

Quem digitalizar o QR com a câmara do telemóvel é levado para a página de verificação em direto, onde pode confirmar que o emblema está alojado em badges.ninja, cumpre a especificação Open Badge v2.0 e (no plano Pro) está ancorado on-chain através da Matchain. A identidade do destinatário é mostrada como um hash SHA-256, de modo a que os endereços de e-mail nunca sejam expostos publicamente.

Certificado em PDF

Cada atribuição tem um botão Download Certificate na página pública de verificação. Ao clicar, é gerado no momento um PDF A4 pronto a imprimir, com a imagem do emblema, o nome do destinatário, a entidade emissora, os critérios, a data de emissão, a validade opcional e um código QR que liga novamente para o URL de verificação em direto.

Pré-visualizações em redes sociais

Quando uma ligação de emblema é partilhada no LinkedIn, no X, no Slack, no Facebook, no WhatsApp ou por e-mail, a plataforma vai buscar o endpoint de partilha e apresenta um cartão enriquecido a partir dos metadados Open Graph emitidos pelo badges.ninja:

• A imagem do emblema como imagem de pré-visualização
• O nome do emblema como título
• Nome da entidade emissora e nome do destinatário na descrição

Assim, garante-se que os emblemas têm um aspeto profissional sempre que são partilhados — os destinatários não precisam de anexar a sua própria imagem nem de escrever texto. A pré-visualização é gerada do lado do servidor em /certify-badge/award/{guid}/share-html e fica em cache na orla da CDN, pelo que as pré-visualizações surgem de imediato logo na primeira partilha.

Partilha por e-mail

Podes enviar atribuições por correio eletrónico de duas formas:

A partir da página pública de partilha

Os destinatários podem partilhar o emblema com amigos, mentores ou potenciais empregadores clicando em Send Email na página de partilha. Abre-se uma janela modal onde introduzem um ou mais endereços de e-mail, um assunto opcional e uma mensagem pessoal:

Cada destinatário recebe um e-mail HTML estilizado com a mensagem pessoal do remetente e um botão de um clique para abrir a página pública da atribuição:

A partir do painel

As entidades emissoras podem enviar qualquer atribuição por e-mail a partir da página Awards do painel:

1. Localiza a atribuição na página Awards.
2. Clica no botão Send na linha ou abre a janela modal de detalhe e clica em Resend email.
3. Introduz o endereço de e-mail do destinatário e envia.

É utilizado o mesmo modelo de e-mail em ambos os fluxos.

Endpoints JSON do Open Badge v2.0

Para garantir interoperabilidade com outras plataformas de emblemas, o badges.ninja disponibiliza JSON padrão do Open Badge v2.0 nestes endpoints públicos:

Endpoint	Descrição
/certify-badge/issuer/{guid}	JSON do perfil da entidade emissora
/certify-badge/badge/{guid}	JSON da BadgeClass
/certify-badge/award/{guid}	JSON da Assertion (a atribuição)

Estes endpoints devolvem JSON-LD em conformidade com a especificação Open Badge v2.0. Outras plataformas de emblemas e verificadores podem consumir estes dados para validar credenciais.

Exemplo — verificar uma atribuição:

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

URLs de imagens no IPFS

As imagens dos emblemas são fixadas no IPFS (o InterPlanetary File System) através do nosso próprio gateway, ipfs.ninja. Isto significa que:

• As imagens são permanentes e endereçadas por conteúdo — não podem ser adulteradas nem substituídas em silêncio
• Os URLs das imagens no JSON do Open Badge têm a forma https://ipfs.ninja/ipfs/{cid}
• O mesmo content-ID é resolvido por qualquer gateway IPFS público (cloudflare-ipfs.com, ipfs.io, etc.) — os teus emblemas não ficam presos a um único fornecedor

Como a imagem faz parte da assertion do Open Badge, substituir a arte do emblema mais tarde não quebra as atribuições já emitidas: o antigo CID do IPFS continua resolúvel para sempre, pelo que as atribuições históricas mantêm a sua imagem original mesmo que redesenhes o emblema para novas emissões.