ادمج عملياتك اللوجستية
بلا حدود.
API REST شاملة بصيغة JSON-LD، توثيق OpenAPI تفاعلي، مصادقة بمفتاح API وwebhooks صادرة. اربط Swaloo بجميع أنظمتك في بضعة أسطر من الكود.
- OpenAPI
- المعيار
- مفتاح API
- المصادقة
- صادرة
- Webhooks
جميع بياناتك
متاحة عبر API.
كل مورد في المنصة مكشوف عبر API REST بصيغة JSON-LD/Hydra. أنشئ واقرأ وعدّل واحذف شحناتك وسائقيك ومركباتك وفواتيرك برمجياً مع تحكم كامل.
- ◆صيغة JSON-LD/Hydra متوافقة مع معايير الويب الدلالي
- ◆CRUD كامل على جميع الموارد: شحنات، سائقون، مركبات، مناطق
- ◆تصفية متقدمة، ترتيب وتقسيم صفحات مدمجة على كل نقطة نهاية
- ◆استجابات موحّدة برموز HTTP قياسية ورسائل خطأ منظّمة
- ◆دعم العلاقات المتداخلة وتوسيع الموارد الفرعية
curl -X POST \ "https://api.swaloo.com/api/v1/shipments" \ -H "X-API-Key: org_ak_7f3b..." \ -H "Content-Type: application/ld+json" \ -d '{ "recipient": "/api/v1/recipients/a1b2", "priority": "high", "codAmount": 45.00 }'
{
"@id": "/api/v1/shipments/c3d4e5",
"trackingNumber": "SWL-20260422-047",
"status": "pending",
"priority": "high",
"codAmount": 45.00,
"createdAt": "2026-04-22T10:30:00+01:00"
}توثيق تفاعلي
محدّث دائماً.
توثيق Swagger/OpenAPI مولّد تلقائياً من الشيفرة المصدرية. اختبر كل نقطة نهاية مباشرة من المتصفح، استكشف مخططات البيانات وولّد عملاء SDK بلغة اختيارك.
- ◆مواصفة OpenAPI 3.1 مولّدة تلقائياً من سمات PHP
- ◆واجهة Swagger UI تفاعلية لاختبار نقاط النهاية مباشرة
- ◆مخططات طلب واستجابة مفصّلة مع أمثلة
- ◆توليد تلقائي لعملاء SDK (TypeScript، Python، PHP، إلخ)
- ◆إصدارات API لضمان التوافق التصاعدي
مفتاح API آمن
لكل مؤسسة.
تمتلك كل مؤسسة مفتاح API فريداً لمصادقة تكاملاتها الخارجية. يطبّق النظام تحديد معدل لكل مفتاح، يسجّل كل استدعاء ويتيح تدوير المفاتيح بدون انقطاع الخدمة.
- ◆مفتاح API فريد مولّد تلقائياً لكل مؤسسة
- ◆تحديد معدل قابل للتكوين للحماية من الإساءة
- ◆تسجيل كامل لكل استدعاء API (نقطة النهاية، الطابع الزمني، عنوان IP)
- ◆تدوير المفتاح بنقرة واحدة بدون انقطاع التكاملات النشطة
- ◆مصادقة JWT تكميلية لجلسات المستخدم
أحداث في الوقت الفعلي
نحو أنظمتك.
كوّن webhooks صادرة لاستقبال إشعارات فورية عند كل حدث مهم: إنشاء شحنة، توصيل، إرجاع، إلخ. كل استدعاء موقّع ويُعاد تلقائياً في حالة الفشل.
- ◆webhooks صادرة لجميع الأحداث الرئيسية (إنشاء، توصيل، إرجاع، إلغاء)
- ◆عناوين URL للوجهة قابلة للتكوين حسب المؤسسة ونوع الحدث
- ◆توقيع HMAC-SHA256 للتحقق من صحة كل إشعار
- ◆منطق إعادة محاولة تلقائي مع تراجع أسّي (3 محاولات)
- ◆سجل webhooks المرسلة مع حالة التسليم وزمن الاستجابة
انظر أيضا
ميزات تكميلية
تعدد المنظمات
تعدد مستأجرين أصلي، أدوار دقيقة، موافقة، مفتاح API وتبديل المنظمات.
إشعارات متعددة القنوات
البريد الإلكتروني، الرسائل القصيرة، الإشعارات الفورية و webhooks. قوالب قابلة للتخصيص مع متغيرات ديناميكية.
الفوترة والاشتراكات
اشتراكات متعددة المستويات، فواتير PDF تلقائية، متعدد العملات وفترة سماح.
ودّع فوضى العمليات..
واستقبل عصر اللوجستيات الذكية.
جهّز أول جولة توصيل محسّنة في أقل من 5 دقائق. انضم إلينا اليوم مجاناً وبدون أي التزامات.