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

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

    English
    في الصفحة دي

    الرسايل

    الرسايل المبعوتة (الحالة بس)

    GET/v2/messages
    • الصلاحية:messages:read
    • Idempotency-Key:مش مستخدم
    • مفتاح الرقم شغال— بيقبل كمان مفتاح x-api-key القديم الخاص بالرقم، لنفس الرقم.
    • قراءة بس

    الرسايل اللي اتبعتت بـ API v2 آخر 30 يوم — من غير محتوى.

    البارامترات

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

    الاسمالنوعالقيودالوصف
    limitاختياريالنوعintegerالقيود—الوصفمن 1 لـ 100، الافتراضي 25.
    cursorاختياريالنوعstringالقيود—الوصفnextCursor من الصفحة اللي قبلها.
    numberIdاختياريالنوعstringالقيود—الوصفالرقم ده بس.
    statusاختياريالنوعstringالقيود—الوصفscheduled | queued | sent | delivered | read | failed | cancelled
    referenceاختياريالنوعstringالقيود—الوصفالمرجع بتاعك.

    الهيدرز

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

    الطلب

    curl -X GET "https://mursilat.com/api/v2/messages?reference=order-1042" \
      -H "Authorization: Bearer $WASLA_API_KEY"

    الرد

    200مثال

    200 — application/json
    {
      "data": [
        {
          "id": "3EB0A1B2C3D4E5F60718",
          "numberId": "cm1abcd2345efgh6789ijkl",
          "type": "text",
          "reference": "order-1042",
          "to": "2010****4567",
          "status": "read",
          "scheduledAt": null,
          "error": null,
          "interactionId": null,
          "timeline": [
            {
              "status": "queued",
              "at": "2026-10-13T08:00:00.000Z"
            },
            {
              "status": "sent",
              "at": "2026-10-13T08:00:01.200Z"
            },
            {
              "status": "delivered",
              "at": "2026-10-13T08:00:02.900Z"
            },
            {
              "status": "read",
              "at": "2026-10-13T08:03:10.000Z"
            }
          ],
          "createdAt": "2026-10-13T08:00:00.000Z",
          "updatedAt": "2026-10-13T08:03:10.000Z"
        }
      ],
      "nextCursor": null
    }

    شكل الرد

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

    • responseobject2 حقل
      • dataarray1 عنصر
        • [0]object12 حقل
          • idstring "3EB0A1B2C3D4E5F60718"
          • numberIdstring "cm1abcd2345efgh6789ijkl"
          • typestring "text"
          • referencestring "order-1042"
          • tostring "2010****4567"
          • statusstring "read"
          • scheduledAtnull null
          • errornull null
          • interactionIdnull null
          • timelinearray4 عنصر
            • [0]object2 حقل
              • statusstring "queued"
              • atstring "2026-10-13T08:00:00.000Z"
          • createdAtstring "2026-10-13T08:00:00.000Z"
          • updatedAtstring "2026-10-13T08:03:10.000Z"
      • nextCursornull null

    الأخطاء

    أخطاء المصادقة وحدود الطلبات والتحقق العامة بس.

    الأخطاء →

    جرّب

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

    مثال موثّق

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

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

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

    بارامترات الاستعلام
    نفس الطلب بـ curl
    curl -X GET 'https://mursilat.com/api/v2/messages' \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H 'Accept: application/json'

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

    GET https://mursilat.com/api/v2/messages