جلب الـ LID عبر الهاتف
تحويل رقم هاتف إلى معرف البحث (LID) المقابل له على واتساب.
تسجيل الدخول مطلوب
سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.
تسجيل الدخوللا توجد معاملات استعلام مطلوبة
هذه النهاية الطرفية لا تتوقع بيانات في الرابط.
توصيات
اتصل بهذا عند إعداد جهة اتصال جديدة لإكمال سجل قاعدة البيانات الخاصة بك.
تعامل بملطف مع الحالات التي لا يتم فيها إرجاع أي LID.
المرساة المستقرة: من الهاتف إلى LID
تجري نقطة النهاية /v2/lids/pn/{number} بحثاً أمامياً، لتحويل رقم هاتف تقليدي إلى معرف البحث المقابل له (LID) الذي يحافظ على الخصوصية.
🔮 لماذا يهم هذا؟
في نظام واتساب الحديث، أرقام الهواتف مؤقتة ولكن الهويات يجب أن تكون مستمرة.
- المشكلة: يغير المستخدم رقمه من رقم أمريكي إلى رقم بريطاني.
- النظام القديم: تفقد تتبعه، وتصبح سجلات الدردشة الخاصة به معزولة.
- النظام الجديد: تستعلم عن الـ LID الخاص به باستخدام الرقم القديم وتخزنه. عندما يراسلك من الرقم الجديد، تستعلم عن الـ LID مرة أخرى وتكتشف أنه نفس الشخص!
🛠️ نمط التنفيذ: سير عمل "دمج الهوية"
- يراسلك المستخدم أ من الرقم
15551234567@c.us. - تستدعي
/v2/lids/pn/15551234567. - تحصل على الـ LID:
999888777@lid. - تخزن في قاعدة بياناتك:
user_id = 999888777@lid. - بعد 6 أشهر: يغير المستخدم رقمه ويوجه لك رسالة من الرقم الجديد.
- تستعلم عن الـ LID للرقم الجديد فتجده هو نفسه
999888777@lid. - تم التطابق: الـ LID هو نفسه! يمكنك الحفاظ على جيس سجل الدردشة والتفضيلات وسجلات الشراء.
⚠️ التوفر
ليس لكل رقم هاتف LID. الحسابات الحديثة (بعد 2023) تمتلك LIDs غالباً، أما الحسابات القديمة جداً فقد تعيد null. تعامل مع هذه الحالة باستخدام الـ JID التقليدي (@c.us) كمفتاح أساسي إذا لزم الأمر.
البارامترات
قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.
بارامترات الرابط
جزء من مسار الرابط أو استعلامstring | Your unique WhatsApp Instance ID مثال: | ||
string | Your API Access Token مثال: | ||
string | رقم الهاتف بدون @c.us (مثال: 201234567890) مثال: |
أمثلة الكود
استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.
الردود المتوقعة
استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.
Example
{
"lid": "1234567890@lid",
"number": "201234567890"
}Command Palette
Search for a command to run...