جلب الـ LID عبر الهاتف

تحويل رقم هاتف إلى معرف البحث (LID) المقابل له على واتساب.

GET
https://api.wawp.net/v2/lids/pn/{number}?access_token=123456789&instance_id=123456789&number=201234567890

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

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

تسجيل الدخول
اختبار /v2/lids/pn/{number}
GET
GET

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

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

توصيات

  • اتصل بهذا عند إعداد جهة اتصال جديدة لإكمال سجل قاعدة البيانات الخاصة بك.

  • تعامل بملطف مع الحالات التي لا يتم فيها إرجاع أي LID.

المرساة المستقرة: من الهاتف إلى LID

تجري نقطة النهاية /v2/lids/pn/{number} بحثاً أمامياً، لتحويل رقم هاتف تقليدي إلى معرف البحث المقابل له (LID) الذي يحافظ على الخصوصية.


🔮 لماذا يهم هذا؟

في نظام واتساب الحديث، أرقام الهواتف مؤقتة ولكن الهويات يجب أن تكون مستمرة.

  • المشكلة: يغير المستخدم رقمه من رقم أمريكي إلى رقم بريطاني.
  • النظام القديم: تفقد تتبعه، وتصبح سجلات الدردشة الخاصة به معزولة.
  • النظام الجديد: تستعلم عن الـ LID الخاص به باستخدام الرقم القديم وتخزنه. عندما يراسلك من الرقم الجديد، تستعلم عن الـ LID مرة أخرى وتكتشف أنه نفس الشخص!

🛠️ نمط التنفيذ: سير عمل "دمج الهوية"

  1. يراسلك المستخدم أ من الرقم 15551234567@c.us.
  2. تستدعي /v2/lids/pn/15551234567.
  3. تحصل على الـ LID: 999888777@lid.
  4. تخزن في قاعدة بياناتك: user_id = 999888777@lid.
  5. بعد 6 أشهر: يغير المستخدم رقمه ويوجه لك رسالة من الرقم الجديد.
  6. تستعلم عن الـ LID للرقم الجديد فتجده هو نفسه 999888777@lid.
  7. تم التطابق: الـ LID هو نفسه! يمكنك الحفاظ على جيس سجل الدردشة والتفضيلات وسجلات الشراء.

⚠️ التوفر

ليس لكل رقم هاتف LID. الحسابات الحديثة (بعد 2023) تمتلك LIDs غالباً، أما الحسابات القديمة جداً فقد تعيد null. تعامل مع هذه الحالة باستخدام الـ JID التقليدي (@c.us) كمفتاح أساسي إذا لزم الأمر.

البارامترات

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

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

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

Your unique WhatsApp Instance ID

مثال:
string

Your API Access Token

مثال:
string

رقم الهاتف بدون @c.us (مثال: 201234567890)

مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/lids/pn/201234567890";
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) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

LID found
النوع:
السيناريو:
application/json
string *
string *

Example

{
"lid": "1234567890@lid",
"number": "201234567890"
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
بوابة غير صالحة - فشل الاتصال بالخادم الرئيسي
الموضوع السابقجلب خريطة LIDs
الموضوع التاليجلب الهاتف عبر الـ LID

Command Palette

Search for a command to run...