ZAITRACK للمطوّرين
الواجهة البرمجية العامة لـ ZAITRACK (الإصدار v1) واجهة HTTPS واحدة لأسطول مؤسستك: المركبات والسائقون والأجهزة، والمواقع والمسارات، والرحلات، والسياجات الجغرافية، والتنبيهات وقواعدها، ومهام التوزيع، وأوامر الأجهزة، والوقود، والصيانة، والتقارير، وخطافات الويب. كل عملية مدرجة في مرجع الواجهة البرمجية المولَّد من جدول مسارات البوابة.
ما تحتاج إليه
- مؤسسة على ZAITRACK وحساب عضو فيها. تسجّل الدخول إلى لوحة التحكم وإلى استوديو المطوّرين بالحساب نفسه.
- صندوق تجربة ومفتاح اختبار تنشئهما في استوديو المطوّرين: راجع الحصول على الوصول.
- عميل HTTP. لا توجد مكتبة SDK منشورة بعد: راجع مكتبات SDK. كل الأمثلة هنا بـ
curl.
كيف تعمل الواجهة
- أجسام الطلبات والردود بصيغة JSON بمفاتيح camelCase. المعرّفات UUID. الأوقات بصيغة RFC 3339 بتوقيت UTC.
- القوائم تعيد
{"items": [...], "nextCursor": "..."}: راجع ترقيم الصفحات. - الأخطاء بصيغة RFC 9457
application/problem+jsonمع رمز ZAITRACK: راجع الأخطاء. - التعديلات على مورد قرأته تأخذ إصداره في
If-Match: راجع الاصطلاحات. - عمليات الإنشاء والإجراءات تقبل
Idempotency-Key، وأوامر الأجهزة تشترطه: راجع منع التكرار. - لكل عملية فئة حدّ معدّل بحدود لكل مؤسسة: راجع حدود المعدّل.
- تصلك الأحداث عبر خطافات ويب موقّعة: راجع خطافات الويب.
أين تجد كل شيء
| المضيف | ما هو |
|---|---|
api.zaitrack.app | الواجهة البرمجية العامة (راجع المناطق لمضيفي المناطق) |
auth.zaitrack.app | مُصدِر OAuth 2.1 وOpenID Connect |
| developer-studio.zaitrack.app | استوديو المطوّرين: مفاتيح الواجهة، وتطبيقات OAuth، وخطافات الويب، وصناديق التجربة، والاستخدام |
| adapter-studio.zaitrack.app | استوديو المحوّلات: نشر المحوّلات |
| marketplace.zaitrack.app | السوق: المُرمِّزات والموصلات ومصادر البيانات |
| zaitrack.app | لوحة التحكم |
ما يبقى بالإنجليزية
هذه الصفحة وصفحات «ابدأ» ونظرة خطافات الويب العامة مترجمة، وكذلك صفحات المحوّلات وفهرسها. مرجع الواجهة البرمجية وفهرس الأحداث والتحقق من التسليم والأمثلة العملية وسجل التغييرات بالإنجليزية.