Webhooks
Crie assinaturas para receber eventos relevantes da plataforma no seu backend.
#Endpoints
| Método | Caminho | Descrição |
|---|---|---|
| POST | /v1/webhooks | Cria assinatura e retorna secret. |
| POST | /v1/webhooks/:id/rotate-secret | Rotaciona secret com janela de graça. |
| POST | /v1/webhooks/:id/enable | Habilita a assinatura. |
| POST | /v1/webhooks/:id/disable | Desabilita a assinatura. |
| POST | /v1/webhooks/:id | Atualiza URL e/ou eventos. |
| DELETE | /v1/webhooks/:id | Remove a assinatura. |
| GET | /v1/webhooks/:id | Lê metadados da assinatura. |
| GET | /v1/webhooks | Lista assinaturas por cursor. |
#Criar assinatura
json
{
"url": "https://api.example.com/noorden/webhooks",
"events": ["agent.message", "session.status_idle"]
}A criação retorna o secret uma única vez. Armazene-o no seu backend para validar entregas.
#Rotacionar secret
json
{
"gracePeriodSeconds": 86400
}Durante a janela de graça, o consumidor pode aceitar assinaturas do secret antigo e do novo enquanto o deploy propaga.