مرجع API

ابنِ أي شيء فوق Zyrix

RESTful API، مصادقة JWT، ترقيم صفحات منطقي. موثّق بالكامل مع أمثلة.

الرابط الأساسي

https://api.crm.zyrix.co

ترويسة المصادقة

Authorization: Bearer <token>

حدود المعدّل

الخطة المجانية: 60 طلب/دقيقة. الخطط المدفوعة: 600+ طلب/دقيقة.

المصادقة

POST/api/auth/signupإنشاء حساب وشركة جديدة

POST/api/auth/loginتسجيل الدخول بالبريد وكلمة المرور

POST/api/auth/refreshتبديل رمز التحديث بوصول جديد

POST/api/auth/logoutإبطال الجلسة الحالية

GET/api/customersقائمة العملاء مع الترقيم والفلاترauth

POST/api/customersإنشاء سجل عميل جديدauth

GET/api/customers/:idالحصول على تفاصيل العميل بواسطة IDauth

PUT/api/customers/:idتحديث حقول العميلauth

DELETE/api/customers/:idحذف عميل (مع cascade)auth

GET/api/dealsقائمة الصفقات مع فلاتر المرحلة والقيمة والمالكauth

POST/api/dealsإنشاء صفقة جديدةauth

PUT/api/deals/:idتحديث الصفقة (الانتقال إلى won يُشغّل العمولات)auth

POST/api/whatsapp/webhookwebhook من Meta Cloud (عام بلا مصادقة)

GET/api/whatsapp/inboxمحادثات مجمعة مع ربط العملاءauth

POST/api/whatsapp/sendإرسال رسالة عبر Meta Graph APIauth

GET/api/reports/revenueالإيرادات الرابحة محولة إلى العملة الهدفauth

GET/api/reports/pipelineخط المبيعات المفتوح مرجح بالاحتماليةauth

GET/api/reports/ratesقائمة أسعار الصرف المكوّنةauth

مواصفات OpenAPI الكاملة وساحة اختبار تفاعلية قريباً.