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

احصل على معلومات مفصلة حول قناة معينة.

GET
https://api.wawp.net/v2/channels/{id}?access_token=123456789&id=1234567890%40newsletter&instance_id=123456789

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

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

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

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

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

توصيات

  • Cache channel metadata to reduce API usage.

  • Monitor subscriber growth trends over time.

تعمق: البيانات الوصفية للقناة

تسمح لك نقطة النهاية /v2/channels/{id} باستعادة الملف الشخصي الكامل لأي قناة عامة. هذا مفيد لتحديث البيانات الوصفية مثل عدد المشتركين أو صور الملف الشخصي.


🏗️ حمولة البيانات

بالإضافة إلى الاسم الأساسي، تعيد نقطة النهاية هذه حقولاً هامة:

1. رابط الدعوة (invite_link)

  • الاستخدام: رابط https://whatsapp.com/channel/....
  • الاستراتيجية: إذا كنت تبني دليلاً، فاعرض هذا الرابط للسماح للمستخدمين بفتح القناة مباشرة في تطبيق واتساب الرسمي.

2. المشتركون (subscribers)

  • الدقة: هذا عدد تقريبي للمشتركين للقنوات الكبيرة (مثلاً: 1.2M).

3. التوثيق (verified)

  • العلامة الخضراء: تشير إلى ما إذا كانت القناة تنتمي إلى علامة تجارية أصلية ومعروفة.
  • نصيحة: اعرض دائماً شارة التوثيق بجانب الاسم إذا كانت هذه القيمة true.

🔒 ملاحظة الخصوصية

جلب معلومات القناة هو إجراء عام. لا يعرف مالك القناة أنك طلبت هذه البيانات.

البارامترات

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

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

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

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string

The unique ID of the channel

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/channels/1234567890@newsletter";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789"
6}).toString();
7
8
9fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
10 method: "GET",
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 === 404) {
23 console.error("Error 404: غير موجود - الجلسة غير موجودة");
24 }
25 if (response.status === 401) {
26 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
27 }
28 if (response.status === 500) {
29 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
30 }
31
32 const errorText = await response.text();
33 console.error(`Error ${response.status}: ${errorText}`);
34 })
35 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 35, Col 1javascript

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

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

تم استرداد معلومات القناة بنجاح
application/json
string *
string *
string *
number *

Example

{
"id": "1234567890@newsletter",
"name": "Channel Name",
"description": "Channel Description",
"subscribers": 1500
}
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقإنشاء قناة
الموضوع التاليمعاينة رسائل القناة

Command Palette

Search for a command to run...