Integracions (Zapier, Make i més)

Connecta badges.ninja amb les eines que ja fas servir — emet credencials automàticament quan passa alguna cosa en un altre lloc i reacciona en temps real quan s'emeten, es lliuren, es revoquen o es visualitzen credencials. Qualsevol plataforma que parli REST i webhooks funciona; Zapier i Make són les més ràpides.

Què pots automatitzar

Activadors (badges.ninja → les teves eines) — engeguen un flux de treball quan:

• s'emet una credencial
• es lliura una credencial (s'envia el seu correu)
• es revoca una credencial
• es visualitza una credencial per primera vegada

Accions (les teves eines → badges.ninja):

• emetre una credencial — atorga una insígnia a un destinatari

Requisits previs

1. Crea una clau API al tauler, a Claus API. Fes servir una clau de lectura-escriptura per a les accions (emetre); una clau de només lectura n'hi ha prou per als activadors. Consulta Claus API.
2. Això és tot — tot funciona sobre la REST API i els webhooks.

Zapier

Un cop connectada l'app de Zapier de badges.ninja:

1. Connecta el teu compte — enganxa la teva clau API quan se't demani.
2. Tria un activador (p. ex. Credential Issued) o l'acció Issue Credential.
3. Assigna els camps i activa el Zap.

Internament, els activadors fan servir el model REST Hook de Zapier basat en la API de Webhooks: Zapier se subscriu mitjançant POST /webhooks i badges.ninja li lliura els esdeveniments en temps real, així que no hi ha retard de sondeig.

Make (Integromat) i plataformes personalitzades

No cal cap app — connecta-ho directament:

1. Autentica't amb la capçalera X-Api-Key a cada sol·licitud.
2. Subscriu-te als esdeveniments registrant el teu 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. Rep els lliuraments signats al teu endpoint. Verifica la capçalera X-Bws-Signature — consulta Webhooks.
4. Emet credencials cridant POST /awards — consulta API de credencials.

Referència

• API de Webhooks — esdeveniments, payloads, signatures, reintents
• API de credencials — emetre credencials
• Claus API — claus i àmbits d'accés

El codi font de l'app de Zapier és al repositori, a integrations/zapier/, i es pot publicar amb la CLI de Zapier.