Aufix API

وصول برمجي إلى المركبات والمصروفات والتذكيرات وأعضاء الأسطول والنشاط. Base URL: https://api.aufix.app.

نظرة عامة

  • All REST routes are under /v1/….
  • Successful responses use { "data": … }.
  • Errors use { "error": { "code": "…", "message": "…" } }.
  • Operational routes require an active Fleet plan (Fleet, Fleet Pro, or Fleet Max).
  • Personal access tokens (PAT) are rate-limited; responses may include Retry-After.

المصادقة

HTTPالموردالوصف
—Authorization: Bearer …يتطلب كل مسار أدناه رمز وصول شخصي: Authorization: Bearer aufix_pat_…. أنشئ المفاتيح وألغِها من الإعدادات ← التكاملات (يظهر السر مرة واحدة فقط). read — GET فقط؛ write — جميع الطرق.

المركبات

HTTPالموردالوصف
GET/v1/vehiclesعرض قائمة المركبات المتاحة. Query: limit، المؤشر after.
POST/v1/vehiclesإنشاء مركبة في مرآبك.
GET/v1/vehicles/:vehicleIdالحصول على مركبة واحدة.
PATCH/v1/vehicles/:vehicleIdتحديث حقول المركبة.
DELETE/v1/vehicles/:vehicleIdحذف مركبة والسجلات المرتبطة بها (المالك).

تحديثات المركبة

HTTPالموردالوصف
GET/v1/vehicles/:vehicleId/updatesعرض قائمة تحديثات الحالة (عدد الكيلومترات، الوقود/الشحن، الحالة، الإطارات، التعليق). Query: limit، afterId + afterAt.
POST/v1/vehicles/:vehicleId/updatesتسجيل تحديث جديد لمركبة.

المصروفات

HTTPالموردالوصف
GET/v1/expensesعرض قائمة المصروفات (الأحدث أولاً). Query: limit، vehicleId، المؤشر afterId + afterValue.
POST/v1/expensesإنشاء مصروف لمركبة أو مصروف شخصي بدون مركبة.
PATCH/v1/expenses/:expenseIdتحديث مصروف.
DELETE/v1/expenses/:expenseIdحذف مصروف.

التذكيرات

HTTPالموردالوصف
GET/v1/remindersعرض قائمة التذكيرات حسب تاريخ الاستحقاق. Query: limit، vehicleId، المؤشر afterId + afterValue.
POST/v1/remindersإنشاء تذكير لمركبة أو تذكير شخصي.
PATCH/v1/reminders/:reminderIdتحديث حقول التذكير (بما في ذلك حالة الإنجاز حيثما كانت مدعومة).
DELETE/v1/reminders/:reminderIdحذف تذكير.

النشاط

HTTPالموردالوصف
GET/v1/activityسجل نشاط مالك الأسطول. Query: limit، المؤشر afterId + afterAt.

الأسطول

HTTPالموردالوصف
GET/v1/fleet/membersعرض أعضاء الأسطول وأدوارهم وتعيينات المركبات.
GET/v1/fleet/invitesيعرض دعوات الأسطول. يعيد الحقول inviteId, email, role, status, acceptedBy, expiresAt, createdAt, updatedAt, isExpired.