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

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

    English
    في الصفحة دي

    الرسايل

    حذف — أو إلغاء رسالة مجدولة

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

    الرسالة المجدولة بتتلغي ونسختها بتتمسح.

    البارامترات

    المسار

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

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

    الاسمالنوعالقيودالوصف
    forEveryoneاختياريالنوعbooleanالقيود—الوصفtrue (الافتراضي) = عند الكل (خلال 48 ساعة)؛ false = عندي بس.
    numberIdاختياريالنوعstringالقيود—الوصفللرسايل اللي ماتبعتتش بـ v2.

    الهيدرز

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

    الطلب

    curl -X DELETE "https://mursilat.com/api/v2/messages/3EB0A1B2C3D4E5F60718?forEveryone=true" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm"

    الرد

    200مثال

    200 — application/json
    {
      "messageId": "3EB0A1B2C3D4E5F60718",
      "action": "delete",
      "forEveryone": true
    }

    شكل الرد

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

    • responseobject3 حقل
      • messageIdstring "3EB0A1B2C3D4E5F60718"
      • actionstring "delete"
      • forEveryoneboolean true

    الأخطاء

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

    الأخطاء →

    جرّب

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

    مثال موثّق

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

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

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

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

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

    ده بيمسح أو يفك ربط حاجة. مينفعش يترجع.

    DELETE /v2/messages/{messageId}