🕐 10 دقائق قراءة📅 آخر تحديث: أبريل 2026
واجهة البرمجة API
ادمج سيلزاوي مع أي نظام أو تطبيق خاص بك باستخدام واجهة برمجية RESTful سهلة الاستخدام.
عنوان القاعدة Base URL
https://api.salesawy.com/v1المصادقة Authentication
جميع الطلبات تحتاج إلى مفتاح API في الـ Header. يمكنك إنشاء مفتاح من الإعدادات → واجهة API → إنشاء مفتاح جديد.
HTTP Header
Authorization: Bearer YOUR_API_KEY Content-Type: application/json Accept-Language: ar
مثال — جلب قائمة العملاء
cURL — طلب
curl -X GET "https://api.salesawy.com/v1/customers" \ -H "Authorization: Bearer sk_live_xxxxx" \ -H "Content-Type: application/json"
JSON — استجابة
{
"status": "success",
"data": {
"customers": [
{
"id": "cust_01HXXXX",
"name": "أحمد محمد",
"email": "ahmed@example.com",
"phone": "+20123456789",
"stage": "interested",
"created_at": "2026-04-21T10:00:00Z"
}
],
"total": 150,
"page": 1,
"per_page": 20
}
}نقاط النهاية المتاحة
GET
/api/v1/customersجلب قائمة كل العملاءPOST
/api/v1/customersإنشاء عميل جديدGET
/api/v1/customers/:idجلب بيانات عميل محددPUT
/api/v1/customers/:idتحديث بيانات عميلDELETE
/api/v1/customers/:idحذف عميلPOST
/api/v1/messages/sendإرسال رسالة عبر القناة المحددةGET
/api/v1/analytics/overviewملخص التحليلات العامةGET
/api/v1/conversationsجلب كل المحادثاتحدود الاستخدام Rate Limits
| الخطة | طلبات / دقيقة | طلبات / يوم |
|---|---|---|
| الماسية | 60 | 5,000 |
| المقترحة | 300 | 50,000 |
| المخصصة | غير محدود | غير محدود |
رموز الأخطاء
200طلب ناجح201تم الإنشاء بنجاح400بيانات الطلب غير صحيحة401غير مصرح — تحقق من مفتاح API404المورد غير موجود429تجاوزت حد الطلبات المسموح