Integrações (Zapier, Make e mais)

Conecte o badges.ninja às ferramentas que você já usa — emita credenciais automaticamente quando algo acontece em outro lugar e reaja em tempo real quando credenciais são emitidas, entregues, revogadas ou visualizadas. Qualquer plataforma que fale REST e webhooks funciona; Zapier e Make são as mais rápidas.

O que você pode automatizar

Gatilhos (badges.ninja → suas ferramentas) — disparam um fluxo de trabalho quando:

• uma credencial é emitida
• uma credencial é entregue (o e-mail dela é enviado)
• uma credencial é revogada
• uma credencial é visualizada pela primeira vez

Ações (suas ferramentas → badges.ninja):

• emitir uma credencial — conceder um distintivo a um destinatário

Pré-requisitos

1. Crie uma chave de API no painel, em Chaves de API. Use uma chave de leitura-escrita para ações (emitir); uma chave somente leitura basta apenas para gatilhos. Consulte Chaves de API.
2. É isso — tudo funciona sobre a REST API e os webhooks.

Zapier

Depois que o app Zapier do badges.ninja estiver conectado:

1. Conecte a sua conta — cole a sua chave de API quando solicitado.
2. Escolha um gatilho (por exemplo, Credential Issued) ou a ação Issue Credential.
3. Mapeie os campos e ative o Zap.

Nos bastidores, os gatilhos usam o modelo REST Hook do Zapier apoiado pela API de Webhooks: o Zapier assina via POST /webhooks e o badges.ninja entrega os eventos a ele em tempo real, então não há atraso de polling.

Make (Integromat) e plataformas personalizadas

Nenhum app é necessário — conecte diretamente:

1. Autentique-se com o cabeçalho X-Api-Key em cada requisição.
2. Assine os eventos registrando o seu endpoint:

   curl -X POST https://api.badges.ninja/webhooks \
     -H "X-Api-Key: bws_your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{ "url": "https://hook.example.com/badges", "events": ["credential.issued"] }'

3. Receba as entregas assinadas no seu endpoint. Verifique o cabeçalho X-Bws-Signature — consulte Webhooks.
4. Emita credenciais chamando POST /awards — consulte API de credenciais.

Referência

• API de Webhooks — eventos, payloads, assinaturas, retentativas
• API de credenciais — emitir credenciais
• Chaves de API — chaves e escopos de acesso

O código-fonte do app Zapier fica no repositório, em integrations/zapier/, e pode ser publicado com a CLI do Zapier.