جلب جهات الاتصال المخزنة (قاعدة البيانات)

استرجاع جهات الاتصال المخزنة في قاعدة بيانات Wawp السحابية مع دعم التصفح والبحث الفوري دون استهلاك موارد جلسة واتساب.

GET
https://api.wawp.net/v2/contacts/stored?access_token=YOUR_ACCESS_TOKEN&instance_id=123456789&limit=50&page=1&search=2010&session_name=default&workspace_id=1

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

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

تسجيل الدخول
اختبار /v2/contacts/stored
GETPOST

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

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

توصيات

  • استخدم هذه الواجهة لعرض جداول جهات الاتصال ومحركات البحث في نظام CRM الخاص بك.

  • مرر معاملات page و limit للتنقل السلس بين الصفحات.

دليل جهات الاتصال المخزنة سحابياً

تستعلم نقطة النهاية /v2/contacts/stored مباشرة من قاعدة بيانات Wawp المفهرسة (wawp_contacts). وبخلاف /v2/contacts/all، لا تسبب هذه الواجهة أي عبء على حدود جلسة واتساب، وتدعم التصفح السريع والبحث الفوري بالاسم أو الرقم أو معرف LID.

البارامترات

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

معاملات الاستعلام والطلب (Query & Body Parameters)

تدعم التمرير عبر الرابط (Query String) أو كـ JSON Body
string

معرف الجلسة الفريد الخاص بك.

مثال:
string

رمز الوصول الخاص بواجهة البرمجة (Access Token).

مثال:
string—

اسم الجلسة الاختياري (كبديل لـ instance_id).

مثال:
number—

معرف مساحة العمل للتصفية (اختياري).

مثال:
number—

رقم الصفحة للتصفح (يبدأ من 1).

الافتراضي: 1مثال:
number—

عدد جهات الاتصال في الصفحة الواحدة (من 1 إلى 100، الافتراضي 50).

الافتراضي: 50مثال:
string—

كلمة بحث لمطابقة رقم الهاتف أو الاسم أو الاسم الظاهر أو معرف LID.

مثال:

برمج بالذكاء الاصطناعي باستخدام Wawp MCP

MCP READY

قم بربط الـ API مباشرة مع Cursor أو Windsurf أو Claude Desktop، ودع الذكاء الاصطناعي يكتب لك كود الربط وينفذه تلقائياً!

طريقة الربط والإعداد

أمثلة الكود

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

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

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

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

Stored contacts retrieved successfully
application/json
string *
number *
number *
number *
number *
array *

Example

{
"status": "success",
"total": 1,
"page": 1,
"limit": 50,
"totalPages": 1,
"data": {
  "0": {
    "id": 101,
    "phone": "201012345678",
    "lid": "123456789@lid",
    "name": "Ahmed Ali",
    "pushname": "Ahmed",
    "on_whatsapp": 1,
    "status": "active"
    }
  }
}
طلب غير صالح - معاملات مطلوبة مفقودة
غير مصرح - مفتاح الوصول غير صالح أو مفقود
غير موجود - الجلسة غير موجودة
خطأ في الخادم الداخلي - فشل غير متوقع
الموضوع السابقجلب جميع جهات الاتصال
الموضوع التاليمسح جهات الاتصال المخزنة

Command Palette

Search for a command to run...