Saltar al contenido principal
POST
Crea un nuevo secreto de firma para un webhook. El secreto anterior sigue firmando durante 24 horas, hasta previous_secret_expires_at. Una segunda rotación en ese plazo desactiva de inmediato el secreto más antiguo.
Requiere el scope webhooks_manage.

Solicitud

Parámetros de ruta

string
requerido
Identificador del webhook (UUID).

Parámetros del cuerpo

El cuerpo es opcional.
boolean
predeterminado:"false"
true desactiva de inmediato el secreto actual, por ejemplo, tras una filtración.

Respuesta

Si la petición tiene éxito, la API devuelve 200 OK con el webhook y su nuevo secreto.
string
requerido
El secreto de firma, whsec_ seguido de base64. Aniva solo lo muestra en esta respuesta. Consulta Verificar la firma.
string
requerido
Identificador del webhook (UUID).
string
requerido
La URL HTTPS a la que Aniva envía los eventos.
string
Texto libre para tu propia referencia. Puede ser null.
string[]
requerido
Tipos de evento que recibe este webhook. * significa todos los tipos.
string[]
requerido
Direcciones a las que Aniva envía un correo cuando las entregas siguen fallando.
string
requerido
enabled o disabled.
string
Instante ISO 8601 UTC en el que se desactivó el webhook. null mientras esté activado.
string
Motivo por el que se desactivó el webhook. Consulta Avisos de fallo. null mientras esté activado.
string
Instante ISO 8601 UTC en el que empezó la racha actual de fallos. null cuando la última entrega tuvo éxito.
string
Instante ISO 8601 UTC en el que el secreto anterior deja de firmar. null cuando no hay ninguna rotación en curso.
string
requerido
Instante ISO 8601 UTC en el que se creó el webhook.
string
requerido
Instante ISO 8601 UTC del último cambio.

Respuestas de error