Integraciones (Zapier, Make y más)

Conecta badges.ninja con las herramientas que ya usas — emite credenciales automáticamente cuando ocurre algo en otro lugar y reacciona en tiempo real cuando se emiten, entregan, revocan o visualizan credenciales. Cualquier plataforma que hable REST y webhooks funciona; Zapier y Make son las más rápidas.

Qué puedes automatizar

Disparadores (badges.ninja → tus herramientas) — lanzan un flujo de trabajo cuando:

• se emite una credencial
• se entrega una credencial (se envía su correo)
• se revoca una credencial
• se visualiza una credencial por primera vez

Acciones (tus herramientas → badges.ninja):

• emitir una credencial — otorga una insignia a un destinatario

Requisitos previos

1. Crea una clave API en el panel, en Claves API. Usa una clave de lectura-escritura para las acciones (emitir); una clave de solo lectura basta para los disparadores. Consulta Claves API.
2. Eso es todo — todo funciona sobre la REST API y los webhooks.

Zapier

Una vez conectada la app de Zapier de badges.ninja:

1. Conecta tu cuenta — pega tu clave API cuando se te solicite.
2. Elige un disparador (p. ej. Credential Issued) o la acción Issue Credential.
3. Asigna los campos y activa el Zap.

Internamente, los disparadores usan el modelo REST Hook de Zapier respaldado por la API de Webhooks: Zapier se suscribe mediante POST /webhooks y badges.ninja le entrega los eventos en tiempo real, así que no hay retardo de sondeo.

Make (Integromat) y plataformas personalizadas

No se necesita ninguna app — conéctalo directamente:

1. Autentícate con la cabecera X-Api-Key en cada solicitud.
2. Suscríbete a los eventos registrando tu 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. Recibe las entregas firmadas en tu endpoint. Verifica la cabecera X-Bws-Signature — consulta Webhooks.
4. Emite credenciales llamando a POST /awards — consulta API de credenciales.

Referencia

• API de Webhooks — eventos, payloads, firmas, reintentos
• API de credenciales — emitir credenciales
• Claves API — claves y ámbitos de acceso

El código fuente de la app de Zapier está en el repositorio, en integrations/zapier/, y se puede publicar con la CLI de Zapier.