Salt la conținutul principal
POST
Creează un nou secret de semnare pentru un webhook. Vechiul secret continuă să semneze timp de 24 de ore, până la previous_secret_expires_at. O a doua rotație în acest interval oprește imediat cel mai vechi secret.
Necesită scope-ul webhooks_manage.

Cerere

Parametri de cale

string
obligatoriu
Identificatorul webhook-ului (UUID).

Parametri de corp

Corpul cererii este opțional.
boolean
implicit:"false"
true oprește imediat secretul curent, de exemplu după o scurgere de date.

Răspuns

În caz de succes, API-ul returnează 200 OK cu webhook-ul și noul său secret.
string
obligatoriu
Secretul de semnare, whsec_ plus base64. Aniva îl afișează doar în acest răspuns. Vezi Verifică semnătura.
string
obligatoriu
Identificatorul webhook-ului (UUID).
string
obligatoriu
URL-ul HTTPS la care Aniva trimite evenimente.
string
Text liber pentru referința ta. Poate fi null.
string[]
obligatoriu
Tipurile de evenimente pe care le primește acest webhook. * înseamnă toate tipurile.
string[]
obligatoriu
Adresele la care Aniva trimite e-mailuri când livrările continuă să eșueze.
string
obligatoriu
enabled sau disabled.
string
Momentul ISO 8601 UTC în care webhook-ul a fost dezactivat. null cât timp este activ.
string
Motivul pentru care webhook-ul a fost dezactivat. Vezi Notificări de eșec. null cât timp este activ.
string
Momentul ISO 8601 UTC în care a început seria curentă de eșecuri. null când ultima livrare a reușit.
string
Momentul ISO 8601 UTC în care secretul anterior nu mai este folosit la semnare. null când nu este în curs nicio rotație.
string
obligatoriu
Momentul ISO 8601 UTC în care webhook-ul a fost creat.
string
obligatoriu
Momentul ISO 8601 UTC al ultimei modificări.

Răspunsuri de eroare