تنزيل رتبة المسؤولين إلى مشاركين عاديين

تنزيل رتبة واحد أو أكثر من المسؤولين إلى مشاركين عاديين.

POST

https://api.wawp.net/v2/groups/{id}/admin/demote?access_token=123456789&id=1234567890%40g.us&instance_id=123456789&participants=%5B%7B%22id%22%3A%221234567890%40c.us%22%7D%5D

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

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

تسجيل الدخول

اختبار /v2/groups/{id}/admin/demote

يدعم

POST

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

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

حصانة المنشئ

لا يمكنك تخفيض رتبة منشئ المجموعة.

التأثير

يصبح المستخدمون الذين تم تخفيض رتبتهم مشاركين عاديين ولكنهم يظلون في المجموعة.

توصيات

قم بتخفيض رتبة المسؤولين غير النشطين لتقليل المخاطر الأمنية.
تواصل مع المستخدم قبل تخفيض الرتبة لتجنب الارتباك.
تحقق من حالة المسؤول قبل استدعاء نقطة النهاية هذه.

استعادة الحوكمة: السحب الاستراتيجي للسلطة الإدارية

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

🏗️ الفلسفة المعمارية: فرض الحالة المنضبطة

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

قوة المسؤول الرئيسي: تنزيل الرتبة هو "سلطة تصحيحية"؛ يجب أن يكون مثيل Wawp مسؤولاً (Admin) لتنفيذ هذا الطلب. وبما أن مثيلك غالباً هو المنشئ، فإنه يمتلك "حصانة إدارية" فريدة لا يمكن للمسؤولين الثانويين تحديها.
إغلاق الميزات الفوري: عند تنزيل الرتبة، يتم تحديث واجهة واتساب للمستخدم فوراً؛ فيفقد خيار "تعديل معلومات المجموعة"، والقدرة على إضافة/إزالة الأعضاء. هذا "الإلغاء الفوري" ضروري للتخفيف من أثر مسؤول مارق أو متجاوز.

🚀 حالات الاستخدام الاستراتيجي

1. بروتوكول تسليم المناوبات

في ورديات العمل العالمية، قد يتم إضافة العديد من الموظفين لمجموعة حالة طارئة. لتجنب وجود عشرات المسؤولين النشطين (ما يزيد مخاطر التغييرات غير المقصودة)، يقوم النظام بـ تنزيل رتبة المدير المغادر فور انتهاء ورديته وترقية المسؤول القادم.

2. نموذج "التصحيح التلقائي"

نوصي بتشغيل "تدقيق حوكمة" كل 60 دقيقة للمجموعات عالية القيمة. إذا وجد النظام مستخدماً تمت ترقيته يدوياً (بتجاوز منطق API الخاص بك)، يجب عليه استدعاء واجهة تنزيل الرتبة فوراً لاستعادة الحالة المصرح بها. يضمن هذا أن يبقى الـ API هو الحكم النهائي والمسيطر.

🛡️ حصانة المنشئ

في منظومة واتساب، لا يمكن تنزيل رتبة المنشئ (Creator). هذه ميزة أمنية صلبة في الشبكة. وهذا يعني أنه إذا أنشأ مثيل Wawp المجموعة، فمن المستحيل فيزيائياً على أي مسؤول آخر (بشري أو بوت) تنزيل رتبة مثيلك، مما يضمن احتفاظ عملك دائماً بالمفتاح الرئيسي للمحادثة.

البارامترات

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

محتوى الطلب

يرسل كـ JSON

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:
	`string`		The unique ID of the group مثال:
	`array`		قائمة بمعرفات الواتساب (@c.us) المراد تنزيل رتبتها مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/groups/1234567890@g.us/admin/demote";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7const body = {
8  "participants": [
9    {
10      "id": "1234567890@c.us"
11    }
12  ]
13};
14
15fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
16  method: "POST",
17  headers: { "Content-Type": "application/json" },
18  body: JSON.stringify(body)
19})
20  .then(async (response) => {
21    if (response.ok) {
22      const data = await response.json();
23      console.log("Success:", data);
24      return data;
25    }
26    
27    // Error Handling
28    
29
30    const errorText = await response.text();
31    console.error(`Error ${response.status}: ${errorText}`);
32  })
33  .catch((error) => console.error("Network Error:", error));

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

Ln 33, Col 1javascript

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

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

Participants demoted

application/json

boolean *

Example

{
"ok": true
}

الموضوع السابقترقية المشاركين إلى مسؤولين

الموضوع التالينظرة عامة على الوسائط