تخطَّ إلى المستندات
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 كل شيء إلى عنوان واحد، والعنوان الواقع خارج ما يبلغه المفتاح لا يُحصي شيئًا بدل أن يفشل.

المرجع