انتقل إلى المحتوى
TLGPSالتوثيق

توثيق المطورين

REST API / V1

تفاصيل المركبة

موارد REST API V1 والمصادقة وقراءات ضمن حدود الوصول.

GET https://api.tlgps.athear.ly/v1/vehicles/{vehicle}
Authorization: Bearer <token>
Accept: application/json

استبدل بـ UUID لمركبة ظاهرة. يتطلب الطلب vehicles.view والصلاحية المقابلة. تُحل الموارد باستخدام UUID وليس مُعرّف قاعدة البيانات الرقمي. يعود 404 إذا لم تكن المركبة موجودة أو متاحة ضمن نطاق الرؤية.

الاستجابة الناجحة

{
    "data": {
        "uuid": "01900000-0000-7000-8000-000000000001",
        "plate_number": "NF-241",
        "brand": "Astra",
        "model": "M588FS",
        "company": {
            "uuid": "01900000-0000-7000-8000-000000000002",
            "name": "Northstar Fleet Operations"
        },
        "location": {
            "source": "realtime",
            "status": {
                "connection": "online",
                "movement": "moving"
            },
            "coordinates": {
                "latitude": 0.0,
                "longitude": 0.0
            },
            "geo_address": null,
            "speed": {
                "kmh": 62,
                "mps": 17.22
            },
            "gps_status": true,
            "angle": 175,
            "altitude": 12,
            "ignition": {
                "status": "on"
            },
            "oil": 81,
            "voltage": 13.7,
            "mileage": {
                "km": 2485047,
                "meters": 2485047000
            },
            "temperature": "28",
            "timestamps": {
                "gps": "2026-06-29T23:47:43+02:00",
                "received": "2026-06-29T23:47:43+02:00",
                "last_synced": null
            }
        }
    }
}

حالات الاستجابة

الحالة المعنى
200 أُعيدت المركبة
401 المصادقة مطلوبة
403 لا تسمح حدود الوصول بالعملية
404 المركبة غير موجودة أو غير متاحة

قد تكون location مساوية لـ null عند غياب جهاز تتبع أو حالة متاحة. تُفضّل الحالة الآنية المتاحة على الحالة المخزنة المستخدمة كبديل في مسار REST الحالي.

توثيق عام · يتطلب التكامل وصولًا مصرّحًا به

توثيق تديره فرق الهندسة. تستخدم الأمثلة بيانات توضيحية وقيَمًا بديلة لبيانات الاعتماد.

العودة إلى الأعلى