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 الحالي.