Perguntas frequentes

Dúvidas frequentes sobre o badges.ninja.

O que são distintivos digitais?

Distintivos digitais são representações visuais e verificáveis de habilidades, conquistas ou credenciais. Cada distintivo contém metadados sobre o que foi obtido, quem obteve, quem emitiu e os critérios exigidos. Diferentemente dos certificados em papel, os distintivos digitais podem ser verificados online por qualquer pessoa com a URL do distintivo.

O que é o padrão Open Badge v2.0?

Open Badge v2.0 é um padrão do setor mantido pela IMS Global (agora 1EdTech) que define como distintivos digitais são estruturados, emitidos e verificados. O badges.ninja segue esse padrão para que seus distintivos sejam interoperáveis com outras plataformas e verificadores Open Badge. O padrão define três objetos principais: Issuer (quem emite), BadgeClass (o que é concedido) e Assertion (a concessão a uma pessoa específica).

Como funciona o armazenamento IPFS?

As imagens dos distintivos ficam no IPFS (InterPlanetary File System), uma rede de armazenamento descentralizada. Depois de enviadas, as imagens são endereçadas por conteúdo — são identificadas por um hash criptográfico do conteúdo. Isso as torna permanentes, inalteráveis e acessíveis por qualquer gateway IPFS. Suas imagens permanecem disponíveis mesmo que o badges.ninja esteja fora do ar.

O que o plano gratuito inclui?

O plano Free inclui 1 emissor, 5 classes de distintivos, 100 concessões por mês, 1 chave de API, 1 GB de armazenamento para imagens e acesso completo ao designer visual, armazenamento IPFS e compatibilidade Open Badge v2.0 — sem custo e sem cartão de crédito. A cota de concessões é reiniciada no começo de cada mês.

Posso automatizar a criação de distintivos via API?

Sim. O badges.ninja oferece uma API REST completa para criar emissores, distintivos e concessões de forma programática. Gere uma chave de API no painel e inclua-a no cabeçalho X-Api-Key. Veja a Referência da API para a documentação completa com exemplos.

O que é a verificação em blockchain?

A verificação em blockchain é um recurso opcional (disponível no plano Pro) que registra as concessões on-chain para adicionar uma camada extra de autenticidade. Atualmente o badges.ninja suporta a Matchain. Esse recurso fornece um registro inalterável e verificável de forma independente para cada concessão, além da verificação hospedada padrão.

Como funcionam as concessões em massa?

As concessões em massa permitem emitir o mesmo distintivo para centenas ou milhares de destinatários enviando um arquivo CSV com nomes e e-mails. O sistema processa cada linha, mostra o progresso em tempo real e permite pausar, retomar ou cancelar. Ao terminar, você pode baixar CSVs com as concessões bem-sucedidas e as que falharam. Veja Concessões em massa para o guia completo.

Como os destinatários compartilham seus distintivos?

Cada concessão tem uma página pública de verificação e uma página de compartilhamento. Os destinatários podem compartilhar o distintivo no LinkedIn, Twitter/X, Facebook, WhatsApp, Telegram ou por e-mail. Também podem copiar a URL de verificação diretamente. O compartilhamento em redes sociais inclui prévias ricas com a imagem e a descrição do distintivo. Veja Compartilhar e verificar.

Como meus dados estão protegidos?

O badges.ninja usa infraestrutura AWS com criptografia em repouso e em trânsito. A autenticação é feita pelo Amazon Cognito com políticas de senha seguras. As chaves de API são geradas criptograficamente. As imagens no IPFS são endereçadas por conteúdo e inalteráveis. A plataforma segue as melhores práticas de segurança, incluindo proteção WAF e mitigação de DDoS.

Como obtenho suporte?

Se precisar de ajuda, abra a página Suporte na barra lateral do painel. Você pode criar um chamado descrevendo seu problema e a equipe responderá. Consulte também esta documentação e o guia de Início rápido para dúvidas comuns.