hosting

GET `/v1/sites/{siteId}/mail-log`

Messages the site's mail sent or received.

تصدیق‌هویت

د بیارر ټوکن په توګه یو API کي وسپارئ. دا پای ټکی په مشخصاتو کې کوم ځانګړی اجازه لیک نه بیانوي، نو خپل کیلي ته لږترلږه هغه څه ورکړئ چې ورته اړتیا لري او د فرض کولو پر ځای ځواب وپلټئ.

دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.

هڅه وکړئ

د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.

curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/mail-log \
  -H "Authorization: Bearer zdk_live_…"

ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ

تفصیلات

Paginated by the vendor, so has_more is its own answer rather than arithmetic on total. An empty page for a site with no mail is a normal state, not a failure. ⛔ Requires sites.panel_access, not sites.view — unlike every other read on this panel. Sender, recipient and subject lines are the customer's correspondence, the same class of data as their files and their database, and sites.panel_access is the key that already gates both. A principal holding only sites.view gets a 404.

پارامترونه

نوم	ډول	اړین	دا څه شی دی
`siteId (path)`	`Uuid`	هو	Site ID (UUIDv7).
`period (query)`	`string<hourly, daily, weekly, monthly>`	نه	How far back to look, in the vendor's own four buckets.
`direction (query)`	`string<incoming, outgoing>`	نه	⛔ One direction at a time — the vendor has no "both", so a client showing a combined view must make two calls and say which is which.
`search (query)`	`string`	نه	Free-text match on sender, recipient or subject.
`page (query)`	`integer`	نه	—
`page_size (query)`	`integer`	نه	—

ځواب

نوم	ډول	اړین	دا څه شی دی
`data`	`SiteMailLogEntry[]`	هو	—
`total`	`integer`	هو	—
`page`	`integer`	هو	—
`page_size`	`integer`	هو	—
`has_more`	`boolean`	هو	The vendor's own flag, not arithmetic on `total`.
`period`	`string`	هو	—
`direction`	`string`	هو	—
`periods`	`string[]`	هو	—
`directions`	`string[]`	هو	—

تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي

401 · 403 · 404 · 422 · 429 · 503

GET /v1/sites/{siteId}/mail-log