جلب خريطة LIDs

يسترجع جميع خرائط LID لأرقام الهاتف المعروفة.

GET

https://api.wawp.net/v2/lids?access_token=123456789&instance_id=123456789&limit=100&offset=0

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

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

تسجيل الدخول

اختبار /v2/lids

يدعم

GET

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

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

تفريغ

يعيد جميع تعيينات LID المخزنة على الجهاز.

الحجم

يمكن أن تكون الحمولة كبيرة. قم بالتحليل بكفاءة.

توصيات

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

مستقبل الهوية: معرفات البحث (LID)

تكشف نقطة النهاية /v2/lids عن طبقة الربط بين العالم القديم (أرقام الهواتف) والعالم الجديد (المعرفات التي تحافظ على الخصوصية).

🆔 ما هو الـ LID؟

LID هو اختصار لـ Lookup ID (معرف البحث).

الصيغة: 123456789012345@lid (رقم طويل + لاحقة @lid).
الغرض: السماح للمستخدمين بالتفاعل دون الكشف عن أرقام هواتفهم.

التحول التقني

واتساب الكلاسيكي: هويتك هي رقم هاتفك (1555...@c.us). للتحدث معك، أحتاج لرقمك.
واتساب الحديث: قد يكون لديك اسم مستخدم، أو قد تكون في "مجتمع" حيث رقمك مخفي. في هذه الحالات، يستخدم واتساب الـ LID لتوجيه الرسائل.

🛡️ قيود الخصوصية

لا يمكنك ببساطة إجراء "بحث عكسي" لأي LID للحصول على رقم هاتف.

التفويض: يمكنك فقط تحويل LID إلى رقم هاتف إذا كان المستخدم قد شارك رقمه معك أو إذا كانت هناك علاقة ثقة مسبقة (مثل جهة اتصال متبادلة).
أعضاء المجتمعات: إذا كنت في مجموعة إعلان مجتمعي، فقد ترى 5000 عضو، لكن هوياتهم ستكون LIDs. لا يمكنك الحصول على أرقام هواتفهم عبر الواجهة؛ هذا تصميم مقصود للخصوصية من Meta.

🚀 حالات الاستخدام

1. الهوية المستقرة

إذا قام المستخدم بتغيير رقم هاتفه من رقم أمريكي إلى رقم بريطاني، فإن هويته (@c.us) ستتغير، لكن الـ @lid الخاص به يظل كما هو. يمكنك استخدام الـ LID كتمثيل دائم للمستخدم في قاعدة بياناتك.

2. المشاركون المخفيون

عند سحب قائمة المشاركين في مجموعة، ستجد مزيجاً من أرقام الهواتف والـ LIDs. استخدم هذه الواجهة لمعرفة ما إذا كان رقم الهاتف مخزناً لديك مسبقاً لأي من تلك المعرفات.

البارامترات

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

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

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

`string`		Your unique WhatsApp Instance ID مثال:
`string`		Your API Access Token مثال:
`string`	—	أقصى عدد من الخرائط للإرجاع مثال:
`string`	—	عدد الخرائط التي سيتم تخطيها مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/lids";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789",
6  "limit": "100",
7  "offset": "0"
8}).toString();
9
10
11fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
12  method: "GET",
13  headers: { "Content-Type": "application/json" },
14  
15})
16  .then(async (response) => {
17    if (response.ok) {
18      const data = await response.json();
19      console.log("Success:", data);
20      return data;
21    }
22    
23    // Error Handling
24    if (response.status === 401) {
25      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
26    }
27    if (response.status === 400) {
28      console.error("Error 400: طلب غير صالح - تنسيق المعامل غير صالح");
29    }
30    if (response.status === 500) {
31      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
32    }
33
34    const errorText = await response.text();
35    console.error(`Error ${response.status}: ${errorText}`);
36  })
37  .catch((error) => console.error("Network Error:", error));

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

Ln 37, Col 1javascript

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

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

LIDs mapped successfully

application/json

object *

Example

{
"0": {
  "lid": "1234567890@lid",
  "number": "1234567890"
  }
}

طلب غير صالح - تنسيق المعامل غير صالح

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

Command Palette

Search for a command to run...