پرش به مستندات
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 همه‌چیز را به یک نشانی محدود می‌کند، و نشانی‌ای که بیرون از دسترس کلید باشد به‌جای شکست خوردن، چیزی نمی‌شمارد.

مرجع