انتقل للمحتوى

    عربي أو إنجليزي · ↑↓ للتنقل · Enter للفتح · Esc للقفل

    English
    في الصفحة دي

    حماية الرقم والإحصائيات

    إحصائيات يومية

    GET/v2/numbers/{numberId}/stats
    • الصلاحية:stats:read
    • Idempotency-Key:مش مستخدم
    • قراءة بس

    المبعوت والمستلم والمقروء والفاشل والردود والإلغاءات لكل يوم (لحد 92 يوم).

    البارامترات

    المسار

    الاسمالنوعالقيودالوصف
    numberIdإجباريالنوعstringالقيود—الوصفرقم الـ id بتاع الرقم (من GET /v2/numbers).

    الاستعلام (Query)

    الاسمالنوعالقيودالوصف
    fromاختياريالنوعstringالقيود—الوصفأول يوم YYYY-MM-DD (الافتراضي: 6 أيام قبل to). حد أقصى 92 يوم.
    toاختياريالنوعstringالقيود—الوصفآخر يوم YYYY-MM-DD (الافتراضي: النهارده).
    granularityاختياريالنوعstringالقيود—الوصفday بس.

    الهيدرز

    الاسمالنوعالقيودالوصف
    X-Request-Idاختياريالنوعstringالقيود—الوصفاختياري: id الطلب بتاعك وبيرجعلك (غير كده بنعمل req_…). اديه للدعم لو احتجت.

    الطلب

    curl -X GET "https://mursilat.com/api/v2/numbers/cm1abcd2345efgh6789ijkl/stats?from=2026-10-07&to=2026-10-13" \
      -H "Authorization: Bearer $WASLA_API_KEY"

    الرد

    200مثال

    200 — application/json
    {
      "numberId": "cm1abcd2345efgh6789ijkl",
      "timezone": "Africa/Cairo",
      "granularity": "day",
      "from": "2026-10-07",
      "to": "2026-10-13",
      "data": [
        {
          "date": "2026-10-13",
          "sent": 52,
          "delivered": 50,
          "read": 31,
          "failed": 0,
          "replied": 12,
          "optOuts": 0,
          "newContacts": 20,
          "replies": 32
        }
      ]
    }

    شكل الرد

    حقول الرد في المثال. افتح الكائنات والقوايم.

    • responseobject6 حقل
      • numberIdstring "cm1abcd2345efgh6789ijkl"
      • timezonestring "Africa/Cairo"
      • granularitystring "day"
      • fromstring "2026-10-07"
      • tostring "2026-10-13"
      • dataarray1 عنصر
        • [0]object9 حقل
          • datestring "2026-10-13"
          • sentinteger 52
          • deliveredinteger 50
          • readinteger 31
          • failedinteger 0
          • repliedinteger 12
          • optOutsinteger 0
          • newContactsinteger 20
          • repliesinteger 32

    الأخطاء

    غير أخطاء المصادقة وحدود الطلبات والتحقق اللي ممكن ترجع من أي endpoint:

    الأخطاء →

    جرّب

    ابعت الطلب ده من متصفحك لـ API مرسلات.

    مثال موثّق

    معاينة — النسخة دي من التوثيق مش على mursilat.com، فالكونسول بيعرض المثال الموثّق بدل ما يكلم الـ API.

    الطلبات الحقيقية بتستخدم رقمك وباقتك الحقيقيين: ممكن تبعت رسايل واتساب وتصرف من رصيدك وتمسح بيانات. (قراءة بس)

    متخزن في ذاكرة التبويب ده بس: عمره ما بيتحفظ ولا بيتحط في الرابط، وبيتبعت لـ mursilat.com بس. لو عملت reload بيتنسي.

    بارامترات المسار
    بارامترات الاستعلام

    تبعت الطلب ده بجد؟

    GET /v2/numbers/{numberId}/stats