Webhooks

Webhooks são notificações HTTP que a Spalla envia para a sua aplicação quando eventos acontecem — vídeo transcoded, transmissão iniciada, assinatura criada e outros. Em vez de consultar a API em intervalos (polling), você recebe um POST no momento em que o evento ocorre.

1. Cadastre um webhookCopiar link da seção

curl -X POST https://api.spalla.io/v1/webhooks \
  -H "Authorization: Bearer <seu-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://minha-app.exemplo.com/webhooks/spalla",
    "events": ["video.transcoded", "live-stream.started"]
  }'

2. Receba o eventoCopiar link da seção

O corpo do POST traz o tipo do evento e o recurso relacionado:

{
  "type": "video.transcoded",
  "created_at": "2026-10-05T12:00:00Z",
  "data": {
    "key": "a1b2c3d4",
    "title": "Aula 01 — Introdução",
    "status": "ready"
  }
}

Responda com HTTP 2xx rapidamente. Se a entrega falhar, a Spalla repete com backoff exponencial por um período configurável.