جلب جميع التصنيفات

استرجاع جميع تصنيفات واتساب المتاحة في حساب واتساب بيزنس الخاص بك.

GET

https://api.wawp.net/v2/labels?access_token=123456789&instance_id=123456789

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

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

تسجيل الدخول

اختبار /v2/labels

يدعم

GET

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

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

الكتالوج

يعيد قائمة بجميع الملصقات المعرفة في الحساب.

المزامنة

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

توصيات

استطلع نقطة النهاية هذه من حين لآخر لاكتشاف الملصقات التي تم إنشاؤها على الهاتف.
اعرض الملصقات المتاحة في قائمة منسدلة لوكلائك.

دليل التصنيفات: إدارة المخزون الرئيسي

تعمل نقطة النهاية جلب جميع التصنيفات كدليل مركزي للبيانات الوصفية التنظيمية لحساب واتساب بيزنس الخاص بك. إنها الأداة الأساسية لتدقيق تصنيفك الحالي ومزامنة أنظمتك الخارجية مع واقع بيئة واتساب الخاصة بك.

🏗️ المفهوم الأساسي: مصدر الحقيقة

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

بنية البيانات الرئيسية

يمثل كل إدخال في المصفوفة المسترجعة فئة تنظيمية فريدة، محددة بمعرف دائم (ID) وتوقيع مرئي (فهرس اللون). بينما تتكرر تغييرات الأسماء، يظل المعرف (ID) نقطة المرجع الثابتة لقاعدة بياناتك.

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

1. مزامنة الحالة العامة

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

2. تخطيط تصنيف CRM

إذا كنت تقوم بدمج واتساب مع نظام CRM خارجي (مثل Salesforce أو HubSpot)، فإن هذه الواجهة تتيح لك إجراء "تدقيق للتصنيفات" ومطابقتها برمجياً.

⚡ هندسة الأداء: استراتيجيات التخزين المؤقت المتقدمة

بما أن التصنيفات يتم إنشاؤها نادراً ما تتغير في الوقت الفعلي، فإن جلب القائمة الكاملة لكل رسالة سيكون غير فعال. نوصي بنهج "التخزين المؤقت الدافئ":

الجلب الأولي: اسحب جميع التصنيفات أثناء مرحلة بدء تشغيل المتصفح أو الخادم.
تحديث التخزين: لا تستخدم وقت انتهاء صلاحية ثابت (TTL)، بل اعتمد على الويب هوك. يجب أن يقوم نظامك بتحديث التخزين المؤقت فقط عند تلقي حدث تحديث تصنيف أو حذف تصنيف.

البارامترات

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

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

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

	`string`		Your unique WhatsApp Instance ID مثال:
	`string`		Your API Access Token مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/labels";
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 === 401) {
23      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
24    }
25    if (response.status === 500) {
26      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
27    }
28
29    const errorText = await response.text();
30    console.error(`Error ${response.status}: ${errorText}`);
31  })
32  .catch((error) => console.error("Network Error:", error));

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

Ln 32, Col 1javascript

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

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

List of labels retrieved successfully

application/json

object *

Example

{
"0": {
  "id": "1",
  "name": "New Customer",
  "color": 0,
  "colorHex": "#ff9485"
  },
"1": {
  "id": "2",
  "name": "Favorites",
  "color": 1,
  "colorHex": "#64c4ff"
  }
}

غير مصرح - مفتاح الوصول غير صالح أو مفقود

خطأ في الخادم الداخلي - فشل غير متوقع