الحصول على الملف الشخصي

استرجع معلومات ملفك الشخصي على واتساب (الاسم، الحالة، إلخ).

GET

https://api.wawp.net/v2/profile?access_token=YOUR_ACCESS_TOKEN&instance_id=123456789

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

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

تسجيل الدخول

اختبار /v2/profile

يدعم

GET

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

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

انعكاس الذات: تدقيق ملفك الشخصي العام

تعتبر نقطة النهاية /v2/profile بمثابة "مرآة" لحسابك على واتساب. فهي تسمح لنظامك برؤية ما يراه الجمهور بالضبط عندما ينظرون إلى ملفك الشخصي لنشاطك التجاري. وهذا أمر بالغ الأهمية للحفاظ على اتساق العلامة التجارية في البيئات الموزعة حيث قد يقوم العديد من المسؤولين أو النصوص البرمجية المؤتمتة بتحديث هويتك.

🏗️ هيكل البيانات التقني

عند الاستعلام عن نقطة النهاية هذه، يجلب محرك Wawp أحدث البيانات المتزامنة من شبكة واتساب:

اسم العرض (Push Name): الاسم المعروض حالياً لجهات الاتصال الجديدة.
JID: معرف واتساب الأساسي الخاص بك (على سبيل المثال، 123456789@s.whatsapp.net).
حول (About): نص السيرة الذاتية الحالي.
رابط صورة الملف الشخصي: الرابط العام لأفاتارك الحالي (إذا كان متاحاً).

🚀 أنماط التدقيق الاستراتيجية

1. مراقب "فحص الحالة"

إذا كنت تدير حسابات مؤسسية، فقم بإجراء هذا الفحص مرة واحدة يومياً.

السبب: أحياناً، قد يقوم مسؤول بشري بتغيير اسم الملف الشخصي عن طريق الخطأ عبر تطبيق الهاتف، أو قد يقوم نص برمجي بتحديث الحالة بشكل غير متوقع.
سير العمل:
1. استدعِ /v2/profile.
2. قارن name و status المعادة مقابل "الإعدادات الذهبية" في قاعدة بياناتك.
3. إذا تم العثور على عدم تطابق، فقم بتفعيل تنبيه أو استعادة تلقائية.

2. ما قبل التحقق

قبل التقدم بطلب للحصول على "العلامة الخضراء" (حساب نشاط تجاري رسمي)، استخدم نقطة النهاية هذه للتأكد من أن بياناتك مثالية.

قائمة التحقق:
- هل يتطابق pushName مع مستندات كيانك القانوني تماماً؟
- هل صورة الملف الشخصي عالية الدقة ومهنية؟
- هل قسم "حول" يحتوي على معلومات مفيدة؟

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

كاشف "الحظر الخفي" (Shadow Ban): في حالات نادرة، إذا وضع واتساب علامة "سبام" على حساب، فقد يقومون بصمت بإزالة معلومات ملفك الشخصي العام (إخفاء صورتك ومعلومات "حول" عن الجميع).
- الكشف: إذا أعادت نقطة النهاية هذه بيانات صالحة ولكن أفاد المستخدمون برؤية ملف شخصي فارغ، فتحقق من إعدادات الخصوصية في الهاتف. إذا كانت الإعدادات صحيحة ولكن الملف الشخصي لا يزال فارغاً للآخرين، فقد يكون رقمك محظوراً.

⚠️ اعتبارات هامة

التخزين المؤقت: قد يقوم محرك Wawp بتخزين بيانات الملف الشخصي مؤقتاً لتحسين الأداء. إذا قمت للتو بتحديث صورتك عبر تطبيق الهاتف، فقد تظهر نقطة النهاية هذه الرابط القديم لبضع دقائق.
انتهاء صلاحية رابط الصورة: رابط pictureUrl المعاد هو رابط مباشر لـ CDN واتساب. وهو رابط مؤقت. لا تقم بتخزين هذه السلسلة في قاعدة بياناتك للاستخدام طويل الأمد؛ قم دائماً بإعادة جلبها أو تنزيل ملف الصورة.

البارامترات

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

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

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

	`string`		WhatsApp Instance ID مثال:
	`string`		API Access Token مثال:

أمثلة الكود

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

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/profile";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "YOUR_ACCESS_TOKEN"
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));

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

Ln 59, Col 1javascript

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

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

ناجح - تم إكمال الطلب بنجاح

3 نسخ

النوع:

application/json

boolean *

string *

Example

{
"success": true,
"message": "Operation completed successfully"
}

طلب غير صالح - معاملات مطلوبة مفقودة

3 نسخ

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

2 نسخ

Command Palette

Search for a command to run...