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

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

    English
    في الصفحة دي

    الأرقام

    تغيير اسم الرقم

    PATCH/v2/numbers/{numberId}
    • الصلاحية:numbers:write
    • Idempotency-Key:اختياري
    • بيغيّر إعدادات

    الاسم جوه مرسلات بس.

    البارامترات

    المسار

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

    الهيدرز

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

    الـ Body

    الاسمالنوعالقيودالوصف
    nameإجباريالنوعstringالقيود≤ 100 حرفالوصفاسم للعرض جوه مرسلات بس — العميل مش بيشوفه.

    الطلب

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

    الرد

    200مثال

    200 — application/json
    {
      "id": "cm1abcd2345efgh6789ijkl",
      "name": "فرع مدينة نصر",
      "phone": "201001234567",
      "status": "CONNECTED",
      "health": {
        "level": "good",
        "score": 92
      },
      "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"
    }

    شكل الرد

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

    • responseobject10 حقل
      • idstring "cm1abcd2345efgh6789ijkl"
      • namestring "فرع مدينة نصر"
      • phonestring "201001234567"
      • statusstring "CONNECTED"
      • healthobject2 حقل
        • levelstring "good"
        • scoreinteger 92
      • 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"

    الأخطاء

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

    الأخطاء →

    جرّب

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

    مثال موثّق

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

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

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

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

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

    ده بيغيّر إعدادات حسابك.

    PATCH /v2/numbers/{numberId}