البحث عن القنوات بالنص

ابحث عن القنوات باستخدام استعلام نصي.

GET
https://api.wawp.net/v2/channels/search/text?access_token=123456789&categories=ENTERTAINMENT&instance_id=123456789&limit=10&startCursor=value&text=Tesla

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

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

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

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

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

توصيات

  • قم بتأخير مدخلات البحث (Debounce) لتجنب تجاوز حدود المعدل.

  • قم بتمييز الكلمات الرئيسية المتطابقة في واجهة نتائج البحث.

  • قم بتخزين مصطلحات البحث الشائعة مؤقتًا محليًا.

الدليل العالمي: البحث في قنوات واتساب

توفر نقطة النهاية /v2/channels/search/text وصولاً برمجياً إلى دليل واتساب العالمي للقنوات العامة. هذا هو نفس محرك البحث المستخدم في تطبيق واتساب.


🔍 كيف يعمل البحث

يقوم محرك البحث بمطابقة تقريبية مقابل اسم القناة و الوصف. يعطي الأولوية للقنوات الموثقة (العلامة الخضراء) وتلك ذات أعداد المتابعين العالية.

نموذج "المؤشر" للترقيم (Cursor)

يستخدم بحث واتساب سلسلة مؤشر مبهمة للترقيم للتعامل مع ملايين السجلات بكفاءة.

سير العمل:

  1. الطلب الأول: أرسل startCursor="".
  2. الاستجابة: ستتلقى قائمة بالقنوات وسلسلة nextCursor.
  3. الصفحة التالية: أرسل سلسلة nextCursor كمعلمة startCursor في طلبك التالي.

🎯 استراتيجيات التصفية

1. حسب الفئة (categories)

يمكنك تصفية النتائج لمواضيع محددة.

  • القيم المتاحة:
    • ENTERTAINMENT: الترفيه.
    • SPORTS: الرياضة.
    • NEWS: الأخبار.
    • BUSINESS: الأعمال والشركات.

⚠️ ملاحظات هامة

  • تحديد المعدل: البحث عملية مكلفة. لا تستخدم نقطة النهاية هذه لميزات الإكمال التلقائي عالية التردد.

البارامترات

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

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

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

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string

نص استعلام البحث

مثال:
array[string]

التصفية حسب الفئات. مثل ENTERTAINMENT, SPORTS

مثال:
number

أقصى عدد من النتائج

مثال:
string

المؤشر للترقيم. اتركه كسلسلة فارغة للصفحة الأولى.

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/channels/search/text";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789",
6 "text": "Tesla",
7 "categories": "ENTERTAINMENT",
8 "limit": "10",
9 "startCursor": ""
10}).toString();
11
12
13fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
14 method: "GET",
15 headers: { "Content-Type": "application/json" },
16
17})
18 .then(async (response) => {
19 if (response.ok) {
20 const data = await response.json();
21 console.log("Success:", data);
22 return data;
23 }
24
25 // Error Handling
26 if (response.status === 401) {
27 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
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) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Channels retrieved successfully
application/json
array *
string *

Example

{
"channels": {
  },
"nextCursor": "cursor_456"
}
غير مصرح - مفتاح الوصول غير صالح أو مفقود
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقالبحث عن القنوات حسب العرض
الموضوع التاليالحصول على طرق عرض القنوات

Command Palette

Search for a command to run...