Webhook-e
Mësoni kur ndodh, jo kur pyesni.
Regjistroni një pikë fundore https dhe merrni një POST të nënshkruar kur posta mbërrin, niset, kthehet ose hapet.
Shkurt
Çfarë është një webhook email-i?
Një webhook është një kërkesë HTTP që një shërbim e dërgon te URL-ja juaj kur ndodh diçka, që kodi juaj të reagojë në vend që të pyesë vazhdimisht. Për email-in, kjo do të thotë postë që mbërrin, niset, kthehet ose hapet.
20
ngjarje për t'u abonuar
10
pika fundore për çdo kuti postare
5
përpjekje për ngjarje, më së shumti
100
ngjarje të dështuara me radhë çaktivizojnë pikën fundore
Si funksionon
Çdo mënyrë dërgimi, një ngjarje
Redaktuesi, një dërgim i planifikuar për të martën dhe API-ja ngrenë të gjithë email.sent. Planifikimi ngre fillimisht email.scheduled.
E nënshkruar, dhe kontrolli është i juaji
Çdo POST mbart një HMAC-SHA-256 të vulës kohore dhe trupit të papërpunuar. Kontrolloni bajtet ashtu si mbërritën dhe refuzoni çdo gjë më të vjetër se 300 sekonda.
Riprovohet vetëm kur mund të funksionojë
Skadimet e kohës, 408, 425, 429 dhe 5xx riprovohen pas 1, 5 dhe 25 minutash, pastaj pas 2 orësh. Çdo 4xx tjetër është përfundimtar, dhe 410 e fik pikën fundore.
Njëzet ngjarje në tri familje
Nëse nuk zgjidhni asnjë, abonoheni në çdo ngjarje mesazhi përveç email.replied.
Verifikoni një dorëzim
SDK-ja e kontrollon HMAC-un në kohë konstante dhe refuzon dorëzimet më të vjetra se pesë minuta.
import { verifyWebhookSignature } from '@openemail/sdk' export default async (request: Request) => { const event = await verifyWebhookSignature({ payload: await request.text(), headers: request.headers, secret: process.env.OPENEMAIL_WEBHOOK_SECRET! }) console.log(event.type, event.data) return new Response(null, { status: 204 })}Çfarë merrni
Në produkt sot
Pesë sekonda, paralelisht
Pikat fundore thirren njëkohësisht, ndaj edhe dhjetë zgjasin pesë sekonda.
Vetëm https publik
Hostet private dhe loopback refuzohen, dhe një ridrejtim nuk ndiqet kurrë.
Çdo përpjekje regjistrohet
Secila tregon çfarë u përgjigj serveri juaj dhe sa zgjati.
Praktikë e mirë
Si ta shfrytëzoni plotësisht
- 01
Përgjigjuni, pastaj punoni
Ktheni një 2xx brenda pesë sekondave dhe punën e ngadaltë bëjeni më pas.
- 02
Hidhni id-të e përsëritura
Ruani çdo id X-OpenEmail-Delivery që trajtoni dhe kapërceni përsëritjet.
- 03
Rinovoni me të dy sekretet
Rinovimi e zëvendëson sekretin menjëherë, ndaj verifikoni me të vjetrin dhe të riun derisa të përfundojë publikimi juaj.
Pyetje
Pyeten shpesh
Vazhdoni
Shkon mirë me
Filloni
Domeni juaj,
posta juaj.
Drejtojeni një domen te OpenEmail dhe lexojeni në një kuti postare të ndërtuar rreth tij. Plani falas mbulon një domen.
