تخطَّ إلى المستندات
API

قراءة النشاط مع جهة اتصال

الأرقام التي خلف تبويب النشاط في جهة اتصال في التطبيق، خلال فترة تنتهي الآن: الرسائل الواردة من العنوان والمرسلة إليه لكل فاصل، والسلاسل التي تحركت، والسلاسل التي تنتظر ردًا من الصندوق، ومتى كتب كل طرف آخر مرة، والزمن الوسيط الذي يستغرقه كل طرف ليرد.

GETapi.openemail.uk/contacts/{email}/activity

ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.

GET /contacts/{email}/activity

الأرقام التي خلف تبويب النشاط في جهة اتصال في التطبيق، خلال فترة تنتهي الآن: الرسائل الواردة من العنوان والمرسلة إليه لكل فاصل، والسلاسل التي تحركت، والسلاسل التي تنتظر ردًا من الصندوق، ومتى كتب كل طرف آخر مرة، والزمن الوسيط الذي يستغرقه كل طرف ليرد.

مثال

يتطلب threads:read. يحدد minutes إلى أي مدى تعود الفترة، وقيمته الافتراضية 90 يومًا؛ وgrain هو minute أو hour أو day؛ وoffsetMinutes هو فارق القارئ عن UTC.

curl
curl "$OE/contacts/ada%40example.com/activity?minutes=43200&grain=day&offsetMinutes=120" -H "$AUTH"
الاستجابة
{  "object": "contact_activity",  "email": "[email protected]",  "since": "2026-08-24T22:00:00.000Z",  "until": "2026-09-23T10:30:00.000Z",  "grain": "day",  "buckets": [    { "bucket": "2026-09-21", "received": 2, "sent": 1 },    { "bucket": "2026-09-22", "received": 1, "sent": 0 }  ],  "totals": {    "received": 3,    "sent": 1,    "threads": 2,    "waiting": 1,    "lastReceivedAt": "2026-09-22T16:04:11.000Z",    "lastSentAt": "2026-09-21T09:40:00.000Z"  },  "replyTime": { "yours": 5400000, "theirs": 12600000 }}

لا يحوي buckets إلا الفواصل التي فيها بريد، الأقدم أولًا، بتوقيت القارئ، ليملأ الرسم البياني الفجوات. ويعدّ waiting السلاسل التي تأتي أحدث رسائلها من هذا العنوان.

replyTime هو الوسيط بالمللي ثانية، yours لرد الصندوق عليهم وtheirs لردهم على الصندوق، وقيمته null حين لا يوجد رد يُقاس. ويُستبعد البريد الموجود في سلة المحذوفات أو في البريد المزعج.