حذف الجلسة

حذف الجلسة نهائياً من النظام.

DELETE

https://api.wawp.net/v2/session/delete?access_token=YOUR_ACCESS_TOKEN&instance_id=Your_Instance_ID

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

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

تسجيل الدخول

اختبار /v2/session/delete

يدعم

DELETE

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

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

لا تراجع

لا توجد 'سلة مهملات'. الجلسات المحذوفة لا يمكن استعادتها.

توصيات

اطلب دائماً التأكيد في واجهتك قبل تفعيل هذه النقطة.
استخدم /v2/logout قبل /v2/delete لضمان إغلاق الجلسة بشكل صحيح من جهة الهاتف.

نقطة اللاعودة: إتقان نقطة النهاية /v2/session/delete

تعد نقطة النهاية /v2/session/delete الإجراء الأكثر حسماً في واجهة برمجة التطبيقات الخاصة بنا. هي ليست مجرد أمر إيقاف تشغيل؛ بل هي تعليمات لـ التفكيك الذري للنسخة. هي تقوم بحذف البيئة المعزولة نهائياً، وجميع بيانات الجلسة المرتبطة بها، ورموز المصادقة من بنيتنا التحتية عالية الأداء.

تشريح الحذف النظيف

عند تفعيل الحذف، يقوم Wawp بتنفيذ عدة مهام تنظيف عالية التزامن في أجزاء من الثانية:

إنهاء الحاوية: يتم إرسال إشارة لمحرك التشغيل النشط للإغلاق الفوري.
تطهير البيانات: يتم مسح كافة الملفات المؤقتة، وطوابير الرسائل، ومفاتيح التشفير المخزنة في الدليل المعزول للنسخة من أقراصنا تماماً.
استعادة الموارد: يتم تحرير الذاكرة العشوائية (RAM) وحمل المعالج (CPU) المخصص لتلك الجلسة فوراً وإعادتهما إلى مجمع موارد السيرفر، مما يسمح بتخصيصات جديدة.
انتهاء صلاحية المعرفات: يتم فصل instance_id و session_name عن حسابك، وأي طلبات مستقبلية باستخدام هذه المعرفات ستؤدي إلى خطأ 404 Not Found.

أفضل الممارسات الاستراتيجية

1. واجهة مستخدم "منطقة الخطر"

نظرًا لأن هذا الإجراء دائم، يجب حمايته بضمانات قوية في واجهة المستخدم.

أفضل ممارسة: لا تسمح أبداً بتفعيل الحذف بنقرة واحدة. نفذ "منطقة خطر" في لوحة التحكم الخاصة بك تتطلب من المستخدم كتابة كلمة "DELETE" أو معرف النسخة لتأكيد رغبته. هذا يمنع فقدان البيانات الكارثي الناجم عن النقرات غير المقصودة.

2. نصيحة "تسجيل الخروج أولاً"

على الرغم من أن الحذف يقطع الجسر البرمجي، إلا أنه لا يرسل دائماً إشارة للهاتف لـ "فك الارتباط" إذا كان المحرك متوقفاً.

الاستراتيجية: للحصول على أفضل تجربة احترافية، استدعِ /v2/session/logout قبل استدعاء delete. هذا يضمن إزالة الجهاز بشكل نظيف من قائمة "الأجهزة المرتبطة" في هاتف المستخدم، مما يمنع ظهور مداخل "أجهزة شبحية" في واجهة تطبيق واتساب.

3. دورة حياة الاشتراك والاشتراكات الملغاة

ادمج هذه النقطة في إدارة الاشتراكات بمنصتك.

سير العمل: إذا ألغى مستخدم خطته أو فشل في الدفع، يجب أن يقوم نظامك تلقائياً باستدعاء /v2/session/delete بعد فترة سماح. هذا يضمن بقاء حصتك من الجلسات متاحة للعملاء النشطين والدافعين.

حالات استخدام معيارية

أ- الامتثال للبيانات (GDPR/SOC2)

إذا كان تطبيقك يتعامل مع بيانات حساسة للغاية، استخدم نقطة نهاية الحذف للتأكد من أنه بمجرد انتهاء تفاعل العميل، لا يتبقى أي أثر لجلسته على خوادمنا. هذا جزء أساسي من بناء بنية اتصالات قائمة على "الثقة الصفرية".

ب- التطوير والاختبار

خلال مرحلة التطوير، قد تقوم بإنشاء وتدمير النسخ بشكل متكرر أثناء اختبار التكامل. استخدام نقطة نهاية الحذف يسمح لك بإبقاء بيئة الاختبار نظيفة وتجنب بلوغ حدود حصة خطتك.

استكشاف الأخطاء وإصلاحها (Troubleshooting)

الخطأ 404: "Instance Not Found"

يحدث هذا إذا كانت عملية الحذف قد تمت بالفعل أو إذا كان المعرف المزود غير صحيح. في نظامك الخلفي، يجب أن تعامل استجابة 404 لطلب الحذف على أنها "نجاح بحكم الأمر الواقع"، مما يعني أن النسخة قد اختفت بالفعل.

هل الاستعادة ممكنة؟

لا. نحن نولي الأولوية لخصوصية البيانات وكفاءة الخادم. بمجرد تنفيذ أمر الحذف، يتم تطهير مفاتيح التشفير من وحدة التخزين الدائمة الآمنة لدينا. لا توجد "سلة مهملات" أو ميزة "استعادة". تأكد دائماً من تحديث قاعدة بياناتك الداخلية لتعكس أن الجلسة لم تعد موجودة.

ملخص الوظائف:

إنهاء دائم للمحرك المعزول.
تطهير كافة مفاتيح التشفير والبيانات المؤقتة لأقصى قدر من الخصوصية.
تحرير فجوات الجلسات ضمن حصة خطة Wawp الخاصة بك.
ضمان صفحة معمارية نظيفة للتخصيصات المستقبلية.

البارامترات

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

محتوى الطلب

يرسل كـ JSON

	`string`		معرف النسخة الفريد مثال:
	`string`		مفتاح الوصول مثال:

أمثلة الكود

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

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

عينات تفاعليةUTF-8

Ln 59, Col 1javascript

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

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

تم حذف الجلسة بنجاح

3 نسخ

النوع:

application/json

string *

Example

{
"name": "wawp-84729105",
"status": "DELETED",
"instance_id": "3EB0BCB2E3D4"
}

طلب غير صالح - معاملات مطلوبة مفقودة

3 نسخ

غير مصرح - مفتاح الوصول غير صالح أو مفقود

2 نسخ

Command Palette

Search for a command to run...