بدء سريع - البحث عن الملف الشخصي الأول في 10 دقائق
الهدف: إرسال طلب HTTP واحد موثق إلى واجهة برمجة تطبيقات بيانات واتساب وقراءة الملف الشخصي العام لرقم هاتف. لا حاجة لتثبيت أي حزمة تطوير برمجية (SDK) - يعمل من أي لغة برمجة مزودة بعميل HTTP.
الخطوة 1 - الحصول على مفتاح API
قناتان - اختر واحدة. نفس بيانات JSON، نفس نقاط النهاية، مصدر مفتاح مختلف وعنوان URL أساسي مختلف:
| قناة | عنوان URL الأساسي | مصدر رئيسي | العناوين المطلوبة |
|---|---|---|---|
| وكيل مباشر | https://whatsapp-proxy.checkleaked.cc | عملية شراء مباشرة. يتم إدارة المفتاح من خلال لوحة التحكم الخاصة بنا. | x-rapidapi-key: <direct-key> |
| سوق RapidAPI | https://whatsapp-data1.p.rapidapi.com | لوحة تحكم RapidAPI ← "التطبيقات" ← الأمان. اشترك من خلال قائمة RapidAPI. | x-rapidapi-key: <rapidapi-key>x-rapidapi-host: whatsapp-data1.p.rapidapi.com |
لن يعمل المفتاح المباشر مع عنوان URL الأساسي لـ RapidAPI، والعكس صحيح. يُعاد استخدام اسم الترويسة x-rapidapi-key في كليهما للتوافق - مصدر القيمة هو المهم.
الخطوة الثانية - قدم طلبك الأول
الوكيل المباشر (موصى به):
curl -H "x-rapidapi-key: YOUR_DIRECT_KEY" \ "https://whatsapp-proxy.checkleaked.cc/number/13105551234"
سوق RapidAPI:
curl -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \ -H "x-rapidapi-host: whatsapp-data1.p.rapidapi.com" \ "https://whatsapp-data1.p.rapidapi.com/number/13105551234"
الخطوة 3 - اقرأ الرد
الرد عبارة عن مستند WhatsAppEntry (شكل مباشر - تم حذف الحقول الإضافية):
{
"number": "13105551234",
"countryCode": "US",
"phone": "+1 310 555 1234",
"type": "FIXED_LINE_OR_MOBILE",
"about": null,
"isWAContact": true,
"isUser": true,
"isBusiness": true,
"isGroup": false,
"isBlocked": false,
"isMyContact": false,
"isEnterprise": false,
"isVerified": false,
"id": {
"server": "c.us",
"user": "13105551234",
"_serialized": "[email protected]"
},
"businessProfile": {
"categories": [{ "id": "...", "localized_display_name": "Otra categoría" }],
"memberSinceText": "Se unió en abril, 2024.",
"isProfileLocked": true
},
"profilePic": { "success": false, "image_status": "item-not-found" },
"date": "2026-04-10T17:30:33.356Z",
"cached": true
}ملاحظات من الاختبارات المباشرة:
- profilePic هو كائن، وليس عنوان URL. عند وجود صورة، يتم جلب الملف الثنائي عبر /picture/{number}؛ أما في حالة عدم وجودها، فيتم جلب { success: false, image_status: "item-not-found" }.
- تكون قيمة "about" فارغة عند تقييدها.
- isWAContact هي العلامة الرسمية التي تشير إلى ما إذا كان هذا الرقم موجودًا على واتساب.
- لا تزال عمليات البحث الفاشلة تُرجع كائن WhatsAppEntry — تحقق من حقول الخطأ / الحقول الموجودة، وليس فقط حالة HTTP.
الخطوة الرابعة - معالجة الأخطاء
تؤدي أخطاء حد الاندفاع والمصادقة إلى إرجاع نص قصير:
{ "error": "Requests must be at least 0.5 seconds apart" }معدل الاستجابة الافتراضي: 500 مللي ثانية على الأقل بين الطلبات (طلبان/ثانية). المستوى الضخم: 250 مللي ثانية (4 طلبات/ثانية). مرجع الأخطاء الكامل.
علامات استعلام اختيارية على /number/{number}
| علَم | تأثير |
|---|---|
telegram=1 | قم بتضمين بيانات التسجيل في تطبيق تيليجرام. |
lookup=1 | قم بتضمين خاصية البحث في تطبيق TrueCaller. |
google=1 | قم بتضمين مقتطفات من نتائج بحث جوجل. |
includeCarrier=1 | قم بتضمين بيانات شركة الاتصالات/المنطقة. |
ignoreProfilePic=1 | تخطي جلب صورة الملف الشخصي (أسرع). |
forceBypassCache=1 | فرض عملية بحث جديدة (يُحتسب كطلب). |
fullAiReport=1 | إنشاء تقرير استخبارات مفتوحة المصدر باستخدام الذكاء الاصطناعي (وقت استجابة أطول). |
الخطوات التالية
ما يقوله مستخدمونا
تقييمات حقيقية من عملائنا الراضين