Kohandatud webhookid
Ehita Analyse'i peale mida iganes: iga blogi sündmus võib jõuda sinu HTTP lõpp-punkti JSON andmekoormana, allkirjastatud HMAC-SHA256-ga, et saaksid päritolu kontrollida.
Iga blogi sündmus
Telli blog_post.published, updated, unpublished ja deleted — igaüks kohaletoimetatud HTTP POST-ina JSON kehaga.
HMAC-allkirjastatud päringud
Kui allkirjastamise saladus on seatud, sisaldab iga päring X-Analyse-Signature päist — toorkeha HMAC-SHA256 — nii et sinu lõpp-punkt saab autentsust kontrollida.
Mitu lõpp-punkti
Lisa nii palju webhooki lõpp-punkte kui vaja, igaühel oma URL, saladus ja sündmuste tellimused.
Kuidas see töötab
Suuna Analyse oma lõpp-punkti, vali sündmused ja kontrolli allkirja.
- 1
Lisa oma lõpp-punkt
Analyse'is ava Integratsioonid → Webhook ja sisesta URL, mis peaks sündmusi vastu võtma, pluss valikuline allkirjastamise saladus.
- 2
Vali oma sündmused
Vali, millised blogi sündmused kohale toimetatakse — avaldatud, uuendatud, avaldamata või kustutatud.
- 3
Kontrolli allkirja
Arvuta toorpäringu keha HMAC-SHA256 oma saladusega ja võrdle seda X-Analyse-Signature päisega.
- 4
Saada testsündmus
Toimeta näidisandmekoorem, et kinnitada, et sinu lõpp-punkt seda õigesti töötleb.
Korduma kippuvad küsimused
Milline andmekoorem välja näeb?
HTTP POST Content-Type: application/json, mis sisaldab sündmuse nime, ajatemplit ja postituse andmeid: id, pealkiri, slug, väljavõte, markdown keha, esiletõstetud pildi URL, avaldamise kuupäev, URL ja kategooriad. Avaldamata ja kustutatud sündmustel on keha null.
Millised sündmused on saadaval?
blog_post.published, blog_post.updated, blog_post.unpublished ja blog_post.deleted. Sa valid, millised iga lõpp-punkt vastu võtab.
Kuidas kontrollin, et päring tuli Analyse'ist?
Sea allkirjastamise saladus; iga kohaletoimetamine sisaldab siis X-Analyse-Signature: sha256=<hex>, toorkeha HMAC-SHA256 sinu saladusega. Lükka tagasi kõik, mis ei klapi.
Ehita Analyse sündmuste peale
Allkirjastatud JSON webhookid iga blogi sündmuse jaoks — ühenda mida iganes.