Új aláíró titkos kulcs létrehozása egy webhookhoz. A régi titkos kulcs még 24 óráig aláír,
a previous_secret_expires_at időpontig. Egy második rotálás ezen az időn belül azonnal érvényteleníti a legrégebbi titkos kulcsot.
A webhooks_manage scope szükséges hozzá.
Kérés
Útvonalparaméterek
string
kötelező
Webhook-azonosító (UUID).
Törzsparaméterek
A törzs opcionális.
boolean
alapértelmezett:"false"
A true érték azonnal érvényteleníti a jelenlegi titkos kulcsot, például szivárgás után.
Válasz
Siker esetén az API 200 OK válasszal adja vissza a webhookot és az új titkos kulcsát.
string
kötelező
Az aláíró titkos kulcs: whsec_ és base64. Az Aniva csak ebben a válaszban jeleníti meg. Lásd: Az aláírás
ellenőrzése.
string
kötelező
Webhook-azonosító (UUID).
string
kötelező
A HTTPS URL, amelyre az Aniva az eseményeket küldi.
string
Szabad szöveg saját hivatkozáshoz. Lehet null.
string[]
kötelező
Azok az eseménytípusok, amelyeket ez a webhook fogad. A * minden típust jelent.
string[]
kötelező
Címek, amelyekre az Aniva e-mailt küld, ha a kézbesítések folyamatosan sikertelenek.
string
kötelező
enabled vagy disabled.
string
A webhook letiltásának ISO 8601 UTC időpontja. null, amíg engedélyezve van.
string
A webhook letiltásának oka. Lásd: Hibaértesítések. null,
amíg engedélyezve van.
string
Az aktuális hibasorozat kezdetének ISO 8601 UTC időpontja. null, ha az utolsó kézbesítés sikeres volt.
string
Az az ISO 8601 UTC időpont, amikor az előző titkos kulcsot már nem használja aláíráshoz. null, ha nincs folyamatban kulcsrotáció.
string
kötelező
A webhook létrehozásának ISO 8601 UTC időpontja.
string
kötelező
Az utolsó módosítás ISO 8601 UTC időpontja.
Hibaválaszok
Státusz
Leírás
400
Érvénytelen kérés. Lásd az error üzenetet.
401
Érvénytelen API-kulcs.
403
Hiányzó API-kulcs, vagy webhooks_manage scope nélküli API-kulcs.
404
A webhook nem található, vagy egy másik API-kulcshoz tartozik.