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

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

    English
    في الصفحة دي

    الأرقام

    حذف رقم

    DELETE/v2/numbers/{numberId}
    • الصلاحية:numbers:write
    • Idempotency-Key:اختياري
    • بيمسح

    نهائي. بيفضّي مكان في باقتك.

    البارامترات

    المسار

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

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

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

    الهيدرز

    الاسمالنوعالقيودالوصف
    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/numbers/cm1abcd2345efgh6789ijkl?confirm=cm1abcd2345efgh6789ijkl" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm"

    الرد

    200مثال

    200 — application/json
    {
      "id": "cm1abcd2345efgh6789ijkl",
      "deleted": true
    }

    شكل الرد

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

    • responseobject2 حقل
      • idstring "cm1abcd2345efgh6789ijkl"
      • deletedboolean true

    الأخطاء

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

    الأخطاء →

    جرّب

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

    مثال موثّق

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

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

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

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

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

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

    DELETE /v2/numbers/{numberId}