Webhook'lar
Siz sorduğunuzda değil, olduğu anda haberiniz olur.
Bir https uç noktası kaydedin; posta geldiğinde, gittiğinde, geri döndüğünde ya da açıldığında imzalı bir POST alın.
Kısaca
E-posta webhook'u nedir?
Webhook, bir şey olduğunda bir hizmetin URL'nize gönderdiği bir HTTP isteğidir; böylece kodunuz sorgu yapmak yerine tepki verir. E-postada bu, postanın gelmesi, gitmesi, geri dönmesi ya da açılması demektir.
20
abone olunabilecek olay
10
posta kutusu başına uç nokta
5
olay başına en fazla deneme
100
art arda başarısız olay uç noktayı devre dışı bırakır
Nasıl çalışır
Her gönderim yolu, tek bir olay
Düzenleyici, salıya zamanlanmış bir gönderim ve API'nin hepsi email.sent tetikler. Zamanlama önce email.scheduled tetikler.
İmzalı, denetimi sizde
Her POST, zaman damgası ve ham gövdenin HMAC-SHA-256'sını taşır. Baytları geldikleri hâliyle denetleyin ve 300 saniyeden eski her şeyi reddedin.
Yalnızca işe yarayabilecekse yeniden denenir
Zaman aşımları, 408, 425, 429 ve 5xx; 1, 5 ve 25 dakika, ardından 2 saat sonra yeniden denenir. Diğer tüm 4xx'ler kesindir ve 410 uç noktayı kapatır.
Üç ailede yirmi olay
Hiçbirini seçmezseniz email.replied dışındaki tüm mesaj olaylarına abone olursunuz.
Bir teslimatı doğrulayın
SDK, HMAC'i sabit sürede denetler ve beş dakikadan eski teslimatları reddeder.
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 })}Neler sunar
Bugün üründe
Beş saniye, paralel
Uç noktalar aynı anda çağrılır, bu yüzden on tanesi de beş saniye sürer.
Yalnızca herkese açık https
Özel ve loopback sunucular reddedilir, yönlendirmeler asla izlenmez.
Her deneme kayıtlı
Her biri sunucunuzun ne yanıt verdiğini ve ne kadar sürdüğünü gösterir.
İyi uygulamalar
En iyi şekilde kullanmak
- 01
Önce yanıt, sonra iş
Beş saniye içinde bir 2xx döndürün, yavaş işleri sonra yapın.
- 02
Tekrarlanan id'leri atın
İşlediğiniz her X-OpenEmail-Delivery id'sini saklayın ve tekrarları atlayın.
- 03
İki gizli anahtarla yenileyin
Yenileme gizli anahtarı hemen değiştirir; dağıtımınız yayına girene kadar hem eskisiyle hem yenisiyle doğrulayın.
Sorular
Sık sorulanlar
Devam edin
Şunlarla iyi çalışır
Başlayın
Alan adınız,
postanız.
Bir alan adını OpenEmail'e yönlendirin ve postasını onun etrafında kurulmuş bir posta kutusunda okuyun. Ücretsiz plan bir alan adını kapsar.
