Compartilhamento e verificação

Toda premiação no badges.ninja tem uma página pública de verificação que qualquer pessoa pode acessar sem fazer login. Os destinatários podem compartilhar seus selos nas redes sociais, por e-mail ou copiando um link direto.

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

Se você ganhou um selo pelo badges.ninja, pode entrar (sem precisar de senha) em badges.ninja/me para ver todos os seus selos em um só lugar e montar um perfil público em badges.ninja/u/<seu-handle>. Veja Portal do Destinatário.

Página pública da premiação

Cada premiação tem uma URL pública:

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

Esta página exibe a imagem do selo (carregada do IPFS), o nome e a descrição do selo, o nome do destinatário, o nome e o logotipo do emissor, a data de emissão e a eventual data de expiração, além dos critérios que o destinatário cumpriu para conquistar o selo. Qualquer pessoa com o link pode abrir a página para confirmar que a credencial é autêntica.

Se o emissor configurou um ID de organização do LinkedIn, aparece o botão Adicionar ao perfil do LinkedIn, para que o destinatário salve a credencial diretamente nas Licenças e Certificações do seu LinkedIn. O botão Baixar selo entrega a imagem original do selo (direto do IPFS), e Baixar PDF gera, na hora, um certificado A4 pronto para impressão.

Página pública de compartilhamento

A página de compartilhamento oferece opções de divulgação social:

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

Nesta página, os destinatários podem compartilhar seu selo em:

• LinkedIn — publica no feed do LinkedIn ou adiciona a credencial diretamente ao perfil pelo botão Add to LinkedIn Profile (quando o emissor configurou um ID de organização do LinkedIn)
• Twitter / X — publica um tweet com o link do selo e um texto de compartilhamento personalizado
• Facebook — compartilha na linha do tempo do Facebook
• WhatsApp — envia uma mensagem com o link do selo
• Telegram — envia uma mensagem com o link do selo
• Send Email — abre um modal na própria página que envia um e-mail estilizado para um ou vários destinatários (veja Compartilhamento por e-mail abaixo)
• Copy Link — copia a URL de verificação para a área de transferência
• Embed snippets — copia HTML pronto (<img> e <iframe>) para colar o selo em um site, intranet ou assinatura de e-mail

Verificação por QR

Uma página dedicada de verificação exibe um QR code escaneável apontando para sua própria URL — perfeito para certificados impressos, banners de eventos ou capturas de tela no LinkedIn.

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

Quem escanear o QR com a câmera do celular cai na página de verificação ao vivo, onde pode confirmar que o selo está hospedado no badges.ninja, segue a especificação Open Badge v2.0 e (no plano Pro) está ancorado on-chain via Matchain. A identidade do destinatário é mostrada como um hash SHA-256, para que e-mails nunca sejam expostos publicamente.

Certificado em PDF

Cada premiação tem um botão Download Certificate na página pública de verificação. Ao clicar, é gerado, na hora, um PDF A4 pronto para impressão, contendo a imagem do selo, o nome do destinatário, o emissor, os critérios, a data de emissão, a expiração opcional e um QR code que aponta de volta para a URL de verificação ao vivo.

Pré-visualizações em redes sociais

Quando um link de selo é compartilhado no LinkedIn, X, Slack, Facebook, WhatsApp ou e-mail, a plataforma busca o endpoint de compartilhamento e renderiza um cartão rico a partir dos metadados Open Graph que o badges.ninja emite:

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

Isso garante que os selos pareçam profissionais ao serem compartilhados em qualquer lugar — os destinatários não precisam anexar a própria imagem nem escrever um texto. A pré-visualização é gerada no servidor em /certify-badge/award/{guid}/share-html e fica em cache na borda da CDN, de modo que as pré-visualizações aparecem instantaneamente já no primeiro compartilhamento.

Compartilhamento por e-mail

Você pode enviar premiações por e-mail de duas formas:

Pela página pública de compartilhamento

Os destinatários podem compartilhar seu selo com amigos, mentores ou possíveis empregadores clicando em Send Email na página de compartilhamento. Abre-se um modal onde digitam 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 e um botão de um clique para abrir a página pública da premiação:

Pelo painel

Os emissores podem enviar qualquer premiação por e-mail a partir da página Awards no painel:

1. Localize a premiação na página Awards.
2. Clique no botão Send na linha, ou abra o modal de detalhes e clique em Resend email.
3. Informe o e-mail do destinatário e envie.

O mesmo modelo de e-mail é usado nos dois fluxos.

Endpoints JSON do Open Badge v2.0

Para interoperar com outras plataformas de selos, o badges.ninja oferece JSON padrão do Open Badge v2.0 nestes endpoints públicos:

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

Esses endpoints retornam JSON-LD em conformidade com a especificação Open Badge v2.0. Outras plataformas de selos e verificadores podem consumir esses dados para validar credenciais.

Exemplo — verificar uma premiaçã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 selos são fixadas no IPFS (o InterPlanetary File System) por meio do nosso próprio gateway, ipfs.ninja. Isso significa que:

• As imagens são permanentes e endereçadas por conteúdo — não podem ser adulteradas nem substituídas em silêncio
• As URLs de imagem 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.) — seus selos não ficam presos a um único provedor

Como a imagem faz parte da assertion do Open Badge, substituir a arte do selo depois não quebra premiações já emitidas: o CID antigo no IPFS continua resolvível para sempre, então as premiações históricas mantêm a imagem original mesmo que você redesenhe o selo para novas emissões.