التحكم في القنوات

الحصول على قائمة القنوات

استرجع قائمة بقنوات واتساب المعروفة للمثيل، مصفاة حسب الدور إذا تم تحديده.

GET
https://api.wawp.net/v2/channels?access_token=123456789&instance_id=123456789&role=OWNER

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

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

تسجيل الدخول
اختبار /v2/channels
GET
GET

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

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

توصيات

  • قم بتصفية القائمة لإظهار القنوات التي لديك حقوق مسؤول فيها فقط.

  • قم بتحديث هذه القائمة بشكل دوري للمزامنة مع الإجراءات التي بدأت من الهاتف.

المخزن: سرد قنواتك

تعمل نقطة النهاية /v2/channels كسجل شخصي لك. وهي تعيد قائمة بجميع القنوات التي يتفاعل معها مثيل Wawp الخاص بك، سواء كنت منشئاً (مالكاً) أو متابعاً (مشتركاً).

📋 فهم أدوار القناة

تتضمن الاستجابة حقل role لكل قناة، والذي يحدد صلاحياتك.

1. مالك (OWNER)

  • التعريف: أنت من أنشأت هذه القناة.
  • الصلاحيات:
    • نشر التحديثات (نص، ميديا، استطلاعات).
    • تغيير الإعدادات (الاسم، الصورة، الوصف).
    • حذف القناة.

2. مشترك (SUBSCRIBER)

  • التعريف: قمت بمتابعة هذه القناة من الدليل.
  • الصلاحيات:
    • قراءة الرسائل والتفاعل معها.
    • كتم/إلغاء كتم التنبيهات.
    • لا يمكنك نشر تحديثات.

🛠️ استراتيجيات المزامنة

مزامنة بدء التشغيل

عند بدء تشغيل تطبيقك، يجب عليك استدعاء نقطة النهاية هذه لملء حالتك المحلية.

  1. الجلب: استدعِ GET /v2/channels.
  2. التصفية: افصل القائمة إلى "قنواتي" (role=OWNER) و "الاشتراكات" (role=SUBSCRIBER).

مشكلة "البيانات القديمة"

تتغير البيانات الوصفية للقناة (مثل الاسم أو الصورة) نادراً.

  • التحسين: لا تستدعي نقطة النهاية هذه عند كل تحميل للصفحة. قم بتخزين النتيجة مؤقتاً لمدة 10-60 دقيقة.
  • الإبطال: إذا قمت بإجراء عملية create أو follow، فقم بإضافة هذا العنصر الجديد يدوياً إلى مخزنك المؤقت بدلاً من إعادة جلب القائمة بالكامل.

⚠️ عثرات شائعة

  • القنوات المفقودة: إذا قمت بمتابعة قناة للتو ولكنها لا تظهر هنا فوراً، انتظر ثانية أو ثانيتين. المزامنة بين خادم واتساب ومثيل Wawp غير متزامنة.
  • الأسماء المكررة: تذكر أن قنوات متعددة يمكن أن تحمل نفس الاسم. استخدم دائماً المعرف id (@newsletter) كمفتاح فريد في واجهة المستخدم الخاصة بك.

البارامترات

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

بارامترات الرابط

جزء من مسار الرابط أو استعلام
string

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string—

تصفية حسب الدور. القيم المتاحة: OWNER, ADMIN, SUBSCRIBER

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/channels";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789",
6  "role": "OWNER"
7}).toString();
8
9
10fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
11  method: "GET",
12  headers: { "Content-Type": "application/json" },
13  
14})
15  .then(async (response) => {
16    if (response.ok) {
17      const data = await response.json();
18      console.log("Success:", data);
19      return data;
20    }
21    
22    // Error Handling
23    if (response.status === 401) {
24      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
25    }
26    if (response.status === 400) {
27      console.error("Error 400: طلب غير صالح - تنسيق المعامل غير صالح");
28    }
29    if (response.status === 500) {
30      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
31    }
32
33    const errorText = await response.text();
34    console.error(`Error ${response.status}: ${errorText}`);
35  })
36  .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 36, Col 1javascript

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

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

List of channels retrieved successfully
application/json
object *

Example

{
"0": {
  "id": "1234567890@newsletter",
  "name": "Wawp Updates",
  "role": "OWNER",
  "description": "Official updates from Wawp"
  }
}
طلب غير صالح - تنسيق المعامل غير صالح
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقإدارة القنوات
الموضوع التاليإنشاء قناة

Command Palette

Search for a command to run...