منصة سوالو للعمليات
الحالة: تعمل
··
API REST والتكاملات

ادمج عملياتك اللوجستية
بلا حدود.

API REST شاملة بصيغة JSON-LD، توثيق OpenAPI تفاعلي، مصادقة بمفتاح API وwebhooks صادرة. اربط Swaloo بجميع أنظمتك في بضعة أسطر من الكود.

OpenAPI
المعيار
مفتاح API
المصادقة
صادرة
Webhooks
طلب الوصول
API REST شاملة

جميع بياناتك
متاحة عبر API.

كل مورد في المنصة مكشوف عبر API REST بصيغة JSON-LD/Hydra. أنشئ واقرأ وعدّل واحذف شحناتك وسائقيك ومركباتك وفواتيرك برمجياً مع تحكم كامل.

  • صيغة JSON-LD/Hydra متوافقة مع معايير الويب الدلالي
  • CRUD كامل على جميع الموارد: شحنات، سائقون، مركبات، مناطق
  • تصفية متقدمة، ترتيب وتقسيم صفحات مدمجة على كل نقطة نهاية
  • استجابات موحّدة برموز HTTP قياسية ورسائل خطأ منظّمة
  • دعم العلاقات المتداخلة وتوسيع الموارد الفرعية
PREVIEW · /API/DOCS
إنشاء شحنة
POST
الطلب
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 }'
الاستجابة201 Created
{
  "@id": "/api/v1/shipments/c3d4e5",
  "trackingNumber": "SWL-20260422-047",
  "status": "pending",
  "priority": "high",
  "codAmount": 45.00,
  "createdAt": "2026-04-22T10:30:00+01:00"
}
توثيق OpenAPI

توثيق تفاعلي
محدّث دائماً.

توثيق Swagger/OpenAPI مولّد تلقائياً من الشيفرة المصدرية. اختبر كل نقطة نهاية مباشرة من المتصفح، استكشف مخططات البيانات وولّد عملاء SDK بلغة اختيارك.

  • مواصفة OpenAPI 3.1 مولّدة تلقائياً من سمات PHP
  • واجهة Swagger UI تفاعلية لاختبار نقاط النهاية مباشرة
  • مخططات طلب واستجابة مفصّلة مع أمثلة
  • توليد تلقائي لعملاء SDK (TypeScript، Python، PHP، إلخ)
  • إصدارات API لضمان التوافق التصاعدي
مصادقة بمفتاح API

مفتاح API آمن
لكل مؤسسة.

تمتلك كل مؤسسة مفتاح API فريداً لمصادقة تكاملاتها الخارجية. يطبّق النظام تحديد معدل لكل مفتاح، يسجّل كل استدعاء ويتيح تدوير المفاتيح بدون انقطاع الخدمة.

  • مفتاح API فريد مولّد تلقائياً لكل مؤسسة
  • تحديد معدل قابل للتكوين للحماية من الإساءة
  • تسجيل كامل لكل استدعاء API (نقطة النهاية، الطابع الزمني، عنوان IP)
  • تدوير المفتاح بنقرة واحدة بدون انقطاع التكاملات النشطة
  • مصادقة JWT تكميلية لجلسات المستخدم
Webhooks والتكاملات

أحداث في الوقت الفعلي
نحو أنظمتك.

كوّن webhooks صادرة لاستقبال إشعارات فورية عند كل حدث مهم: إنشاء شحنة، توصيل، إرجاع، إلخ. كل استدعاء موقّع ويُعاد تلقائياً في حالة الفشل.

  • webhooks صادرة لجميع الأحداث الرئيسية (إنشاء، توصيل، إرجاع، إلغاء)
  • عناوين URL للوجهة قابلة للتكوين حسب المؤسسة ونوع الحدث
  • توقيع HMAC-SHA256 للتحقق من صحة كل إشعار
  • منطق إعادة محاولة تلقائي مع تراجع أسّي (3 محاولات)
  • سجل webhooks المرسلة مع حالة التسليم وزمن الاستجابة

ودّع فوضى العمليات..
واستقبل عصر اللوجستيات الذكية.

جهّز أول جولة توصيل محسّنة في أقل من 5 دقائق. انضم إلينا اليوم مجاناً وبدون أي التزامات.

API REST والتكاملات | Swaloo