Перейти к документации
API

Чтение сведений о том, как приходит почта

Как приходит почта, в том виде, в каком её показывает страница «Аналитика» в приложении.

GET/analytics/mailbox

Выполняет настоящий запрос в вашем рабочем пространстве.

GET /analytics/mailbox

Как приходит почта, в том виде, в каком её показывает страница «Аналитика» в приложении.

Пример

Требуется threads:read. Период равен последним 30 дням, если from и to не говорят иначе, и делится на дни, а с grain на часы или минуты. Передайте offsetMinutes, смещение читателя к востоку от UTC в минутах, чтобы день кончался там же, где у него.

curl
curl "$OE/analytics/mailbox?offsetMinutes=120" -H "$AUTH"
Ответ
{  "object": "mailbox_insights",  "from": "2026-09-02T09:00:00.000Z",  "to": "2026-10-02T09:00:00.000Z",  "grain": "day",  "offsetMinutes": 120,  "scanned": 486,  "days": [    { "day": "2026-09-30", "count": 21 },    { "day": "2026-10-01", "count": 17 }  ],  "hours": [    { "hour": 9, "count": 64 },    { "hour": 14, "count": 51 }  ],  "addresses": [{ "address": "[email protected]", "count": 301 }],  "senders": [    {      "email": "[email protected]",      "name": "Ada Lovelace",      "count": 18,      "lastAt": "2026-10-01T16:20:11.000Z"    }  ],  "senderCount": 132,  "waiting": [    { "band": 1, "count": 6 },    { "band": 3, "count": 2 },    { "band": 7, "count": 1 }  ],  "unattributed": 0,  "folders": [{ "label": "inbox", "count": 412, "unread": 9 }],  "series": []}

scanned считает переписки, пришедшие внутри периода. days распределяет их по интервалам, а hours по часам суток, addresses считает их по адресу, на который они пришли, а senders называет людей, которые писали больше всех. waiting считает переписки, всё ещё ждущие ответа через 1, 3 и 7 дней, а folders то, что лежит в каждой папке.

Ключ или приложение, ограниченные отдельными адресами, считают только почту, пришедшую на эти адреса. address сужает всё до одного адреса, а адрес, до которого ключ не дотягивается, ничего не насчитывает, вместо того чтобы завершиться ошибкой.

Справочник