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

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

    English
    في الصفحة دي

    الرسايل

    تعديل رسالة نصية (خلال 15 دقيقة)

    PATCH/v2/messages/{messageId}
    • الصلاحية:messages:send
    • Idempotency-Key:اختياري
    • مفتاح الرقم شغال— بيقبل كمان مفتاح x-api-key القديم الخاص بالرقم، لنفس الرقم.
    • بيبعت رسايل

    رسايلك النصية بس؛ النص الجديد بيعدي على قواعد المحتوى.

    البارامترات

    المسار

    الاسمالنوعالقيودالوصف
    messageIdإجباريالنوعstringالقيود—الوصفid الرسالة اللي رجع من POST /v2/messages.

    الهيدرز

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

    الـ Body

    الاسمالنوعالقيودالوصف
    textإجباريالنوعstringالقيود—الوصفالنص الجديد (رسايلك النصية بس، خلال 15 دقيقة). قواعد المحتوى بتتراجع تاني.
    numberIdاختياريالنوعstringالقيود—الوصفللرسايل اللي ما اتبعتتش من v2 بس (غير كده السجل عارف الرقم).

    الطلب

    curl -X PATCH "https://mursilat.com/api/v2/messages/3EB0A1B2C3D4E5F60718" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "text": "الموعد اتغير لـ 5 مساءً"
    }'
    الطلب — JSON
    {
      "text": "الموعد اتغير لـ 5 مساءً"
    }

    الرد

    200مثال

    200 — application/json
    {
      "messageId": "3EB0A1B2C3D4E5F60718",
      "action": "edit"
    }

    شكل الرد

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

    • responseobject2 حقل
      • messageIdstring "3EB0A1B2C3D4E5F60718"
      • actionstring "edit"

    الأخطاء

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

    الأخطاء →

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

    النص الجديد بيعدّي على قواعد المحتوى تاني.

    جرّب

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

    مثال موثّق

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

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

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

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

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

    ده هيبعت رسالة واتساب حقيقية (أو حملة / كود) من رقمك وهيصرف من رصيد باقتك.

    PATCH /v2/messages/{messageId}