POST /v1/webhooks/mail-relay-events
Ingest signed delivery events from our own mail relay.
Аутентификација
Ова крајња тачка је јавна. Не захтева никакве акредитиве нити организацију — то је оно што читају наш сопствени маркетиншки сајт и машине за одговоре са вештачком интелигенцијом.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/webhooks/mail-relay-events \
-H "Content-Type: application/json" \
-d '{ "events": <object[]> }'Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Unauthenticated by design: the relay holds no Zinn® credential, so x-signature: base64(HMAC-SHA256(secret, raw body)) is the authentication. Counts remote deliveries and permanent refusals per mailbox, and suspends sending on a mailbox whose last 24 hours are at least 50 refusals and at least 20% of its outcomes. With no configured secret it answers 503 and counts nothing. Events older than two hours are ignored, so a captured request replayed later changes nothing.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
x-signature (header) | string | Да | — |
Тело захтева
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
events | object[] | Да | — |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
received | integer | Да | — |
counted | integer | Да | — |
ignored | integer | Да | — |
unknown_senders | integer | Да | — |
suspended | integer | Да | — |
Грешке које ова крајња тачка може вратити
400 · 503