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

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

    English
    في الصفحة دي

    زرار الموقع وروابط واتساب

    تعديل رابط

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

    أي من name و numberId و message و utm و slug (null = اسم عشوائي جديد) و attribution و enabled (الرابط المتوقف بيرد 410).

    البارامترات

    المسار

    الاسمالنوعالقيودالوصف
    linkIdإجباريالنوعstringالقيود—الوصفid رابط واتساب.

    الهيدرز

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

    الطلب

    curl -X PATCH "https://mursilat.com/api/v2/links/linkId" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "enabled": false
    }'
    الطلب — JSON
    {
      "enabled": false
    }

    الرد

    200مثال

    200 — application/json
    {
      "id": "cm9link0001",
      "name": "Instagram bio",
      "slug": "k7m2xq9prw",
      "customSlug": false,
      "url": "https://mursilat.com/l/k7m2xq9prw",
      "numberId": "cm1abcd2345efgh6789ijkl",
      "number": {
        "name": "فرع المعادي",
        "phone": "201001234567"
      },
      "message": "عايز أعرف الأسعار",
      "utm": {
        "source": "instagram",
        "medium": "bio",
        "campaign": "",
        "content": "",
        "term": ""
      },
      "attribution": {
        "enabled": true,
        "label": "ref",
        "position": "end"
      },
      "enabled": false,
      "stats7d": {
        "clicks": 64,
        "conversations": 18
      },
      "createdAt": "2026-10-14T09:00:00.000Z",
      "updatedAt": "2026-10-14T09:00:00.000Z"
    }

    شكل الرد

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

    • responseobject14 حقل
      • idstring "cm9link0001"
      • namestring "Instagram bio"
      • slugstring "k7m2xq9prw"
      • customSlugboolean false
      • urlstring "https://mursilat.com/l/k7m2xq9prw"
      • numberIdstring "cm1abcd2345efgh6789ijkl"
      • numberobject2 حقل
        • namestring "فرع المعادي"
        • phonestring "201001234567"
      • messagestring "عايز أعرف الأسعار"
      • utmobject5 حقل
        • sourcestring "instagram"
        • mediumstring "bio"
        • campaignstring ""
        • contentstring ""
        • termstring ""
      • attributionobject3 حقل
        • enabledboolean true
        • labelstring "ref"
        • positionstring "end"
      • enabledboolean false
      • stats7dobject2 حقل
        • clicksinteger 64
        • conversationsinteger 18
      • createdAtstring "2026-10-14T09:00:00.000Z"
      • updatedAtstring "2026-10-14T09:00:00.000Z"

    الأخطاء

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

    الأخطاء →

    جرّب

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

    مثال موثّق

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

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

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

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

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

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

    PATCH /v2/links/{linkId}