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

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

    English
    في الصفحة دي

    الحملات (إرسال جماعي)

    عرض الحملات

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

    الأحدث الأول؛ الأرقام بس.

    البارامترات

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

    الاسمالنوعالقيودالوصف
    limitاختياريالنوعintegerالقيود—الوصفمن 1 لـ 100، الافتراضي 25.
    cursorاختياريالنوعstringالقيود—الوصفnextCursor من الصفحة اللي قبلها.
    numberIdاختياريالنوعstringالقيود—الوصفالرقم ده بس.
    statusاختياريالنوعstringالقيود—الوصففلتر: running و paused و completed و cancelled، …

    الهيدرز

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

    الطلب

    curl -X GET "https://mursilat.com/api/v2/campaigns" \
      -H "Authorization: Bearer $WASLA_API_KEY"

    الرد

    200مثال

    200 — application/json
    {
      "data": [
        {
          "id": "cm2camp0001xyz",
          "numberId": "cm1abcd2345efgh6789ijkl",
          "name": "عرض الجمعة",
          "status": "running",
          "contentType": "cta_url",
          "createdVia": "api",
          "speed": "SAFE",
          "scheduledAt": null,
          "startedAt": "2026-10-13T09:00:00.000Z",
          "pausedAt": null,
          "completedAt": null,
          "pause": null,
          "progress": {
            "total": 500,
            "queued": 380,
            "sent": 120,
            "delivered": 115,
            "read": 70,
            "replied": 9,
            "failed": 0,
            "skipped": 3,
            "optOuts": 1,
            "percent": 24
          },
          "replies": null,
          "eta": {
            "remaining": 380,
            "perDayCap": 200,
            "remainingToday": 80,
            "estimatedMinutesToday": 34,
            "extraDays": 2,
            "note": "Estimate from the number warm-up caps and pacing."
          },
          "purged": false,
          "purgedAt": null,
          "createdAt": "2026-10-13T08:55:00.000Z",
          "updatedAt": "2026-10-13T09:30:00.000Z"
        }
      ],
      "nextCursor": null
    }

    شكل الرد

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

    • responseobject2 حقل
      • dataarray1 عنصر
        • [0]object19 حقل
          • idstring "cm2camp0001xyz"
          • numberIdstring "cm1abcd2345efgh6789ijkl"
          • namestring "عرض الجمعة"
          • statusstring "running"
          • contentTypestring "cta_url"
          • createdViastring "api"
          • speedstring "SAFE"
          • scheduledAtnull null
          • startedAtstring "2026-10-13T09:00:00.000Z"
          • pausedAtnull null
          • completedAtnull null
          • pausenull null
          • progressobject10 حقل
            • totalinteger 500
            • queuedinteger 380
            • sentinteger 120
            • deliveredinteger 115
            • readinteger 70
            • repliedinteger 9
            • failedinteger 0
            • skippedinteger 3
            • optOutsinteger 1
            • percentinteger 24
          • repliesnull null
          • etaobject6 حقل
            • remaininginteger 380
            • perDayCapinteger 200
            • remainingTodayinteger 80
            • estimatedMinutesTodayinteger 34
            • extraDaysinteger 2
            • notestring "Estimate from the number warm-up caps and pacing."
          • purgedboolean false
          • purgedAtnull null
          • createdAtstring "2026-10-13T08:55:00.000Z"
          • updatedAtstring "2026-10-13T09:30:00.000Z"
      • nextCursornull null

    الأخطاء

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

    الأخطاء →

    جرّب

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

    مثال موثّق

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

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

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

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

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

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