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

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

    English
    في الصفحة دي

    الأرقام

    إضافة رقم وبدء الربط

    POST/v2/numbers
    • الصلاحية:numbers:write
    • Idempotency-Key:اختياري
    • بيصرف رصيد

    بيعمل رقم جديد (حسب عدد الأرقام في باقتك) ويرجّع QR (نص + صورة PNG)، أو مع pairing.method = "code" والرقم بيرجّع كود من 8 حروف تكتبه في واتساب.

    البارامترات

    الهيدرز

    الاسمالنوعالقيودالوصف
    Idempotency-Keyاختياريالنوعstringالقيود≤ 191 حرفالوصفid فريد من عندك للعملية دي (حد أقصى 191 حرف ASCII). لو كررت بنفس المفتاح ونفس الـ body بيرجعلك أول رد ومعاه Idempotent-Replayed: true — عمرها ما تتنفذ مرتين. بيتحفظ 24 ساعة.
    X-Request-Idاختياريالنوعstringالقيود—الوصفاختياري: id الطلب بتاعك وبيرجعلك (غير كده بنعمل req_…). اديه للدعم لو احتجت.

    الـ Body

    الاسمالنوعالقيودالوصف
    nameإجباريالنوعstringالقيود≤ 100 حرفالوصفاسم للعرض جوه مرسلات بس — العميل مش بيشوفه.
    pairingاختياريالنوعobjectالقيود—الوصفطريقة ربط الموبايل. سيبها للـ QR.
    pairing.methodاختياريالنوعstringالقيودواحد من: qr · codeالافتراضي qrالوصفqr بيرجع QR تعمله scan؛ code بيرجع كود من 8 حروف تكتبه في واتساب (محتاج pairing.phone).
    pairing.phoneاختياريالنوعstringالقيود—الوصفإجباري مع method: "code" — الرقم اللي بيتربط، دولي أرقام بس.

    الطلب

    curl -X POST "https://mursilat.com/api/v2/numbers" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "name": "فرع المعادي",
      "pairing": {
        "method": "qr"
      }
    }'
    الطلب — JSON
    {
      "name": "فرع المعادي",
      "pairing": {
        "method": "qr"
      }
    }

    الرد

    201مثال

    201 — application/json
    {
      "number": {
        "id": "cm1abcd2345efgh6789ijkl",
        "name": "فرع المعادي",
        "phone": null,
        "status": "PAIRING",
        "health": null,
        "numberStatus": "ACTIVE",
        "warmupStage": "WEEK_2",
        "webhook": {
          "configured": true,
          "version": 2,
          "disabled": false
        },
        "createdAt": "2026-10-01T09:00:00.000Z",
        "updatedAt": "2026-10-13T08:00:00.000Z"
      },
      "pairing": {
        "method": "qr",
        "qr": {
          "raw": "2@AbCdEf…",
          "dataUrl": "data:image/png;base64,iVBORw0KGgo…"
        },
        "pairingCode": null,
        "expiresAt": "2026-10-13T08:00:20.000Z",
        "instructions": "On the phone: WhatsApp → Settings → Linked devices → Link a device, then scan."
      }
    }

    شكل الرد

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

    • responseobject2 حقل
      • numberobject10 حقل
        • idstring "cm1abcd2345efgh6789ijkl"
        • namestring "فرع المعادي"
        • phonenull null
        • statusstring "PAIRING"
        • healthnull null
        • numberStatusstring "ACTIVE"
        • warmupStagestring "WEEK_2"
        • webhookobject3 حقل
          • configuredboolean true
          • versioninteger 2
          • disabledboolean false
        • createdAtstring "2026-10-01T09:00:00.000Z"
        • updatedAtstring "2026-10-13T08:00:00.000Z"
      • pairingobject5 حقل
        • methodstring "qr"
        • qrobject2 حقل
          • rawstring "2@AbCdEf…"
          • dataUrlstring "data:image/png;base64,iVBORw0KGgo…"
        • pairingCodenull null
        • expiresAtstring "2026-10-13T08:00:20.000Z"
        • instructionsstring "On the phone: WhatsApp → Settings → Linked devices → Link a device, then scan."

    الأخطاء

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

    الأخطاء →

    حماية الرقم والسلوك

    الـ QR بيربط جهاز برقمك: اتعامل معاه كسر.

    جرّب

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

    مثال موثّق

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

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

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

    نفس الطلب بـ curl
    curl -X POST 'https://mursilat.com/api/v2/numbers' \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H 'Accept: application/json' \
      -H 'Content-Type: application/json' \
      -d '{"name":"فرع المعادي","pairing":{"method":"qr"}}'

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

    ده بيصرف من رصيد باقتك.

    POST https://mursilat.com/api/v2/numbers