Saltar al contingut principal
POST
Crea un nou secret de signatura per a un webhook. El secret anterior continua signant durant 24 hores, fins a previous_secret_expires_at. Una segona rotació dins d’aquest termini desactiva el secret més antic immediatament.
Requereix l’àmbit webhooks_manage.

Sol·licitud

Paràmetres de ruta

string
requerit
Identificador del webhook (UUID).

Paràmetres del cos

El cos és opcional.
boolean
predeterminat:"false"
true desactiva el secret actual immediatament, per exemple després d’una filtració.

Resposta

Si té èxit, l’API retorna 200 OK amb el webhook i el seu nou secret.
string
requerit
El secret de signatura, whsec_ més base64. Aniva només el mostra en aquesta resposta. Consulta Verifica la signatura.
string
requerit
Identificador del webhook (UUID).
string
requerit
L’URL HTTPS al qual Aniva envia els esdeveniments.
string
Text lliure per a la teva referència. Pot ser null.
string[]
requerit
Tipus d’esdeveniments que rep aquest webhook. * vol dir tots els tipus.
string[]
requerit
Adreces a les quals Aniva envia un correu electrònic quan els lliuraments continuen fallant.
string
requerit
enabled o disabled.
string
Instant UTC ISO 8601 en què es va desactivar el webhook. null mentre està activat.
string
Motiu pel qual es va desactivar el webhook. Consulta Avisos d’error. null mentre està activat.
string
Instant UTC ISO 8601 en què va començar la ratxa actual d’errors. null quan l’últim lliurament ha tingut èxit.
string
Instant UTC ISO 8601 en què el secret anterior deixa de signar. null quan no hi ha cap rotació en curs.
string
requerit
Instant UTC ISO 8601 en què es va crear el webhook.
string
requerit
Instant UTC ISO 8601 de l’últim canvi.

Respostes d’error