نظرة عامة
استرجع قائمة مرقّمة بجهات الاتصال. استخدم معامل number للبحث عن رقم محدد. النتائج مقيدة بالمستخدم المصادق عليه. ادمج مع مهام مزامنة CRM لمطابقة المعرفات الخارجية مع معرفات جهات اتصال Buzzbip المستخدمة في إرسال WhatsApp.
GET /api/contacts/
استدعِ نقطة النهاية بـ GET ورمز bearer صالح.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'ملاحظات الاستخدام
استرجع قائمة جهات اتصال مقسمة. استخدم معامل number للبحث عن رقم محدد. احترم معاملات الترقيم الموثقة.
استخدم الترقيم والفلاتر لتقليل حجم الاستجابة.
ملاحظات التكامل
عند دمج نقطة نهاية Buzzbip هذه، استخدم https://app.buzzbip.com كمضيف إنتاج. احصل على JWT من POST /api/login_check وأرسل Authorization: Bearer في كل طلب. تأكد من تفعيل User.hasApiAccess في إدارة Buzzbip. حلّل استجابات JSend (status وmessage وdata). لإضافات التجارة الإلكترونية، أرسل أيضاً x-api-key وx-platform-type وx-base-uri. احترم الشرطة المائلة النهائية في POST /api/contacts/ وPOST /api/whatsapp/. نفّذ إعادة المحاولة مع backoff عند حدود المعدل. خزّن بيانات الاعتماد على الخادم وأعد المصادقة قبل انتهاء JWT (3600 ثانية).
الأمان
أفضل الممارسات: بيانات الاعتماد على الخادم فقط، TLS إلزامي، مراقبة فشل المصادقة. افصل حسابات التجربة والإنتاج. وثّق القوالب والأتمتة. احذف الأرقام والمحتوى من السجلات المشتركة.
ما التالي؟
صفحات ذات صلة: api/contacts/create-contact api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm