Webhooks

Webhooky jsou odchozí HTTP POST notifikace z Knowspread do endpointu klienta. Slouží pro scénáře, kdy klient nechce nebo nemůže pravidelně dotazovat REST API.

Eventy

Aktuální model obsahuje:

Event	Kdy dává smysl
content_assignment_created	Uživatel dostal nový studijní úkol.
content_assignment_completed	Uživatel dokončil přiřazený obsah.
content_assignment_overdue	Přiřazený obsah je po termínu.
test_attempt_completed	Uživatel dokončil testový pokus.

Nastavení endpointu

Webhook setting patří ke company space a obsahuje:

• endpoint_url,
• auth_type,
• volitelný secret pro podpis payloadu,
• konfigurační data pro OAuth2.

Endpoint URL musí být HTTPS.

Autentizace

Podporované režimy:

• žádná autentizace,
• Basic Auth,
• OAuth2 client credentials.

Pokud je nastavený secret, klient má ověřovat podpis payloadu z raw request body. Tím lze zjistit, že payload nebyl cestou změněn.