البحث عن القنوات بالنص
ابحث عن القنوات باستخدام استعلام نصي.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
قم بتأخير مدخلات البحث (Debounce) لتجنب تجاوز حدود المعدل.
قم بتمييز الكلمات الرئيسية المتطابقة في واجهة نتائج البحث.
قم بتخزين مصطلحات البحث الشائعة مؤقتًا محليًا.
الدليل العالمي: البحث في قنوات واتساب
توفر نقطة النهاية /v2/channels/search/text وصولاً برمجياً إلى دليل واتساب العالمي للقنوات العامة. هذا هو نفس محرك البحث المستخدم في تطبيق واتساب.
🔍 كيف يعمل البحث
يقوم محرك البحث بمطابقة تقريبية مقابل اسم القناة و الوصف. يعطي الأولوية للقنوات الموثقة (العلامة الخضراء) وتلك ذات أعداد المتابعين العالية.
نموذج "المؤشر" للترقيم (Cursor)
يستخدم بحث واتساب سلسلة مؤشر مبهمة للترقيم للتعامل مع ملايين السجلات بكفاءة.
سير العمل:
- الطلب الأول: أرسل
startCursor="". - الاستجابة: ستتلقى قائمة بالقنوات وسلسلة
nextCursor. - الصفحة التالية: أرسل سلسلة
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) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"channels": {
},
"nextCursor": "cursor_456"
}Command Palette
Search for a command to run...