Integrações (Zapier, Make e mais)

Ligue o badges.ninja às ferramentas que já utiliza — emita credenciais automaticamente quando algo acontece noutro lado e reaja em tempo real quando as credenciais são emitidas, entregues, revogadas ou visualizadas. Qualquer plataforma que fale REST e webhooks funciona; o Zapier e o Make são os mais rápidos.

O que pode automatizar

Acionadores (badges.ninja → as suas ferramentas) — desencadeiam 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 (as suas ferramentas → badges.ninja):

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

Pré-requisitos

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

Zapier

Depois de a aplicação Zapier do badges.ninja estar ligada:

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

Nos bastidores, os acionadores usam o modelo REST Hook do Zapier apoiado pela API de Webhooks: o Zapier subscreve via POST /webhooks e o badges.ninja entrega-lhe os eventos em tempo real, pelo que não há atraso de polling.

Make (Integromat) e plataformas personalizadas

Não é necessária nenhuma aplicação — ligue diretamente:

1. Autentique-se com o cabeçalho X-Api-Key em cada pedido.
2. Subscreva os eventos registando 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 âmbitos de acesso

O código-fonte da aplicação Zapier encontra-se no repositório, em integrations/zapier/, e pode ser publicado com a CLI do Zapier.