جلب تصنيف محدد

استرجاع تفاصيل تصنيف واتساب محدد.

GET
https://api.wawp.net/v2/labels/{id}?access_token=123456789&id=1&instance_id=123456789

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

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

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

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

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

توصيات

  • قم بتخزين هذا التعيين مؤقتًا لتجنب الاستدعاءات المتكررة.

  • استخدم هذا للتحقق من صحة المعرفات الخارجية قبل المعالجة.

الاكتشاف الدقيق: جلب تصنيف محدد

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


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

تعمل هذه الواجهة كـ مصدر وحيد للحقيقة (SSoT) لقطعة محددة من تصنيفك التنظيمي. تُستخدم بشكل أساسي عندما يعرف نظامك بالفعل معرف التصنيف (ربما من حدث ويب هوك أو سجل قاعدة بيانات) ويحتاج إلى التحقق من خصائصه الحالية دون جلب دليل الحساب بالكامل.


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

استراتيجية "الإماهة عند الحدث"

عندما يصل ويب هوك إضافة تصنيف لدردشة، يوفر واتساب فقط معرف التصنيف (Label ID). لكي يعرض نظامك الأمامي شارة مفيدة مثل "مبيعات" أو "VIP"، يجب "إماهة" هذا المعرف باسمه الظاهر ولونه. هذه الواجهة هي الجسر الأساسي لعملية الإماهة تلك.

توزيع الموارد الذكي

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


🛡️ الأمان وضبط الوصول

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


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

جلب معرف التصنيف خفيف، لكن تكراره لكل رسالة في محادثة مزدحمة غير فعال. نوصي بـ "التخزين المؤقت عند الطلب":

  1. فحص المخزن المحلي: ابحث دائماً عن معرف التصنيف في ذاكرة نظامك أولاً.
  2. الجلب في الوقت المناسب: إذا كان المعرف مفقوداً، استدعِ هذه الواجهة لتخزين التفاصيل.
  3. التحديث الاستباقي: قم بتحديث سجلك المحلي فقط عند استلام ويب هوك تحديث تصنيف لهذا المعرف المحدد.

البارامترات

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

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

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

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string

المعرف الفريد للتصنيف

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/labels/1";
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 === 400) {
23 console.error("Error 400: طلب غير صالح - معاملات مطلوبة مفقودة");
24 }
25 if (response.status === 400) {
26 console.error("Error 400: طلب غير صالح (تنسيق XML)");
27 }
28 if (response.status === 400) {
29 console.error("Error 400: طلب غير صالح (نص عادي)");
30 }
31 if (response.status === 401) {
32 console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
33 }
34 if (response.status === 401) {
35 console.error("Error 401: غير مصرح (تنسيق XML)");
36 }
37 if (response.status === 404) {
38 console.error("Error 404: غير موجود - الجلسة غير موجودة");
39 }
40 if (response.status === 404) {
41 console.error("Error 404: غير موجود (تنسيق XML)");
42 }
43 if (response.status === 500) {
44 console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
45 }
46 if (response.status === 500) {
47 console.error("Error 500: خطأ في الخادم الداخلي (HTML)");
48 }
49 if (response.status === 502) {
50 console.error("Error 502: بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي");
51 }
52 if (response.status === 502) {
53 console.error("Error 502: بوابة غير صالحة (تنسيق XML)");
54 }
55
56 const errorText = await response.text();
57 console.error(`Error ${response.status}: ${errorText}`);
58 })
59 .catch((error) => console.error("Network Error:", error));
عينات تفاعلية
Ln 59, Col 1javascript

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

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

Label info retrieved
النوع:
السيناريو:
application/json
string *
string *
number *
string *

Example

{
"id": "1",
"name": "New Customer",
"color": 0,
"colorHex": "#ff9485"
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقجلب جميع التصنيفات
الموضوع التاليإنشاء تصنيف

Command Palette

Search for a command to run...