حذف الحالة

احذف حالة معينة (قصة) عن طريق المعرف (ID).

POST
https://api.wawp.net/v2/status/delete?access_token=YOUR_ACCESS_TOKEN&id=status-msg-id&instance_id=123456789

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول
اختبار /v2/status/delete
POST
POST

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

توصيات

  • احذف المنشورات العرضية فورًا.

  • قم بأتمتة الحذف إذا أصبح المحتوى غير ذي صلة (مثل انتهاء بيع فلاش).

زر التراجع: حذف الحالة

تسمح لك نقطة النهاية /v2/status/delete بإزالة تحديث الحالة برمجياً قبل انتهاء صلاحيتها التي تستمر 24 ساعة. هذه أداة حيوية لإدارة السمعة وتصحيح الأخطاء.


🚨 بروتوكولات الطوارئ

الحالة 1: خطأ في التسعير

  • الموقف: قام البوت بنشر كود خصم "99%" بدلاً من "9%".
  • الإجراء: استدعِ /v2/status/delete فوراً.
  • التأثير: تختفي الحالة من تبويب "المستجدات" لدى جميع المستخدمين.

الحالة 2: العرض المنتهي

  • الموقف: نشرت "عرض فلاش" ينتهي في الساعة 2 ظهراً.
  • المشكلة: في الساعة 4 ظهراً، لا يزال المستخدمون يرون القصة ويغضبون لأن الكود لا يعمل.
  • الحل: جدول أمر الحذف في اللحظة التي ينتهي فيها العرض تماماً.

🏗️ السلوك التقني

هل يتم "الحذف" فعلياً؟

نعم، ولكن مع بعض الملاحظات:

  1. جهة الخادم (Server-Side): يتم وضع علامة على الوسائط للحذف فوراً على خوادم واتساب. لا يمكن للأجهزة الجديدة تحميلها.
  2. جهة العميل (Online): تتلقى الأجهزة المتصلة إشارة "سحب" (Revoke) وتخفي الحالة فجأة.
  3. جهة العميل (Offline): إذا كان هاتف المستخدم في "وضع الطيران"، فسيظل يرى الحالة حتى يعيد الاتصال بالإنترنت. لا يمكنك فرض حذف المحتوى من جهاز غير متصل.

❓ الأسئلة الشائعة

س: هل يمكنني تعديل الحالة بدلاً من حذفها؟ ج: لا. بروتوكول واتساب لا يدعم تعديل تحديثات الحالة. يجب حذف القديمة ونشر أخرى جديدة.

س: هل سيعرف المستخدمون أنني حذفتها؟ ج: لا. على عكس رسائل الدردشة التي تترك أثراً ("تم حذف هذه الرسالة")، تختفي الحالات المحذوفة دون ترك أي أثر.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

محتوى الطلب

يرسل كـ JSON
string

WhatsApp Instance ID

مثال:
string

API Access Token

مثال:
string

معرف رسالة الحالة المراد حذفها

مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/status/delete";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "YOUR_ACCESS_TOKEN"
6}).toString();
7const body = {
8 "id": "status-msg-id"
9};
10
11fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
12 method: "POST",
13 headers: { "Content-Type": "application/json" },
14 body: JSON.stringify(body)
15})
16 .then(async (response) => {
17 if (response.ok) {
18 const data = await response.json();
19 console.log("Success:", data);
20 return data;
21 }
22
23 // Error Handling
24 if (response.status === 400) {
25 console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
26 }
27 if (response.status === 400) {
28 console.error("Error 400: طلب غير صالح (تنسيق XML)");
29 }
30 if (response.status === 400) {
31 console.error("Error 400: طلب غير صالح (نص عادي)");
32 }
33 if (response.status === 401) {
34 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
35 }
36 if (response.status === 401) {
37 console.error("Error 401: غير مصرح (تنسيق XML)");
38 }
39 if (response.status === 404) {
40 console.error("Error 404: غير موجود - الجلسة غير موجودة");
41 }
42 if (response.status === 404) {
43 console.error("Error 404: غير موجود (تنسيق XML)");
44 }
45 if (response.status === 500) {
46 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
47 }
48 if (response.status === 500) {
49 console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
50 }
51 if (response.status === 502) {
52 console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
53 }
54 if (response.status === 502) {
55 console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
56 }
57
58 const errorText = await response.text();
59 console.error(`Error ${response.status}: ${errorText}`);
60 })
61 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 61, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

ناجح - تم إكمال الطلب بنجاح
النوع:
application/json
boolean *
string *

Example

{
"success": true,
"message": "Operation completed successfully"
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقالحصول على معرف حالة جديد
الموضوع التاليإدارة القنوات

Command Palette

Search for a command to run...