ماذا يمكنك أن تفعل باستخدام REST API؟
- القراءة: المحطات وحالة المنافذ، وجلسات الشحن الجارية والسابقة، والسائقون، وبطاقات RFID، والمركبات، والتنبيهات، ومحاولات البطاقات المرفوضة.
- الكتابة: أنشئ السائقين وبطاقات RFID والمركبات وعدّلها واحذفها — مثلاً لتسجيل الموظفين تلقائياً من نظام الموارد البشرية.
- الأوامر: أوقف جلسة عن بُعد، وأعد تشغيل جهاز شحن، وافتح قفل منفذ، وتابع نتيجة الأمر.
- التقارير: تقارير طاقة مجمّعة حسب اليوم أو الشهر أو المحطة أو السائق أو المركبة.
أحداث لحظية عبر Webhooks
بدلاً من الاستعلام المتكرر، تصل الأحداث إلى خادمك لحظة وقوعها: session.started, session.stopped, connector.status_changed, station.connected, station.disconnected, auth.rejected, alert.created وcommand.completed. كل طلب موقّع بخوارزمية HMAC-SHA256، وتُعاد محاولة الإرسال الفاشل تلقائياً.
أمان بمستوى المؤسسات
- نطاقات صلاحيات (قراءة، كتابة، أوامر) لمنح أقل قدر لازم من الوصول
- قوائم عناوين IP مسموح بها ومفاتيح بتاريخ انتهاء
- حدود لمعدّل الطلبات لكل مفتاح وتسجيل كامل للطلبات
- تُخزَّن المفاتيح على الخادم بصيغة مُجزّأة (hash)
توثيق المطورين
كل نقطة نهاية موثّقة بأمثلة cURL وPHP وNode.js وPython. أنشئ مفتاح API خلال دقائق من صفحة إعدادات API في لوحة التحكم.
الأسئلة الشائعة
هل لواجهة API تكلفة إضافية؟
لا. واجهة API وWebhooks مشمولة في كل حساب.
بأي صيغة تأتي البيانات؟
جميع الاستجابات بصيغة JSON، والطوابع الزمنية بصيغة ISO-8601 مع فارق المنطقة الزمنية.
ماذا لو لم أتمكن من استقبال Webhooks؟
يمكنك الاستعلام عن الأحداث نفسها عبر نقطة نهاية تدفق الأحداث.