نظرة عامة
بعد الحصول على JWT، تحقق من الاتصال بطلب GET بسيط. نقطة قائمة جهات الاتصال اختبار جيد. استخدم https://app.buzzbip.com وتذكر الشرطة المائلة النهائية في بعض طلبات POST.
مثال على الطلب
أدرج الصفحة الأولى من جهات الاتصال مع الترقيم الافتراضي.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'تفسير الاستجابة
استجابة JSend ناجحة لها status success ورسالة وdata. الأخطاء تستخدم status error مع message وcode وdata. افحص JSON دائماً وليس HTTP فقط.
سجّل أجسام JSend الكاملة أثناء اختبار التكامل.
ملاحظات التكامل
عند دمج نقطة نهاية 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 api/whatsapp-messaging getting-started/errors
