mail

POST /v1/webhooks/mail-relay-events

Ingest signed delivery events from our own mail relay.

Све mail крајње тачке

Сва документација за програмере →

Аутентификација

Ова крајња тачка је јавна. Не захтева никакве акредитиве нити организацију — то је оно што читају наш сопствени маркетиншки сајт и машине за одговоре са вештачком интелигенцијом.

Ова крајња тачка не прихвата 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Да—

Тело захтева

НазивТипОбавезноШта је ово
eventsobject[]Да—

Одговор

НазивТипОбавезноШта је ово
receivedintegerДа—
countedintegerДа—
ignoredintegerДа—
unknown_sendersintegerДа—
suspendedintegerДа—

Грешке које ова крајња тачка може вратити

400 · 503