Arvetrak API Dokümantasyonu

Başlangıç

Sunucunuzu firmanızın lisanslı araç verilerine bağlayın. Önce durum isteğini gönderin, ardından araçları ve verilerini sorgulayın.

1. Sunucunuzun sabit çıkış IP adresini izin listesine ekleyin.
2. Yönetim panelinden API anahtarı ve gizli anahtar oluşturun.
3. İki kimlik başlığıyla durum uç noktasını çağırın.

Kimlik doğrulama ve IP izni

Her REST isteğinde anahtar kimliği ve gizli anahtar ayrı başlıklarda gönderilir. İzin verilmeyen IP adresinden gelen istek, araç verisi okunmadan reddedilir.

Araç yetkisi ve lisans dönemleri

Yalnız bu API istemcisine açıkça tanımlanan araçlar döner. Lisans veya erişim izni sona erince anlık değerler gizlenir. Geçmiş sorguları lisans ve erişim dönemlerinin kesişimiyle sınırlandırılır.

Bağlantı durumu

Kimlik bilgilerini, istemciyi, etkin yetkileri ve limitleri doğrulayın.

Gerekli yetki: status:read

Yanıt · JSON

{
    "data": {
        "service": "Arvetrak Customer Fleet API",
        "version": "v1",
        "status": "ok",
        "client": {
            "code": "YOUR_CLIENT_CODE",
            "name": "Integration",
            "company": "Example",
            "abilities": [
                "status:read",
                "vehicles:read",
                "locations:read",
                "realtime:read"
            ]
        },
        "limits": {
            "requests_per_minute": 60,
            "history_requests_per_minute": 15,
            "max_page_size": 100,
            "max_history_days": 7,
            "max_history_points": 2000
        },
        "server_time": "2026-09-25T12:00:00Z"
    }
}

Araç listesi

Bu istemciye tanımlı araçları sayfalı döner. Süresi biten araçlar listede kalır; anlık değerleri gösterilmez.

Gerekli yetki: vehicles:read

Parametreler

Yanıt · JSON

{
    "data": [
        {
            "id": 42,
            "imei": "353742378000001",
            "plate": "34 ABC 123",
            "license": {
                "status": "active"
            },
            "live_data_available": true,
            "latitude": 41.01,
            "longitude": 28.97,
            "speed_kmh": 0,
            "ignition": false,
            "online": true
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 100,
        "total": 1,
        "last_page": 1
    },
    "links": {
        "previous": null,
        "next": null
    }
}

Araç detayı

Tanımlı bir aracın anlık özetini döner. Bilinmeyen veya izinsiz IMEI için 404 döner.

Gerekli yetki: vehicles:read

Parametreler

Yanıt · JSON

{
    "data": {
        "imei": "353742378000001",
        "plate": "34 ABC 123",
        "location_valid": true,
        "latitude": 41.01,
        "longitude": 28.97,
        "speed_kmh": 0,
        "ignition": false,
        "last_seen_at": "2026-09-25T12:00:00Z"
    },
    "meta": {
        "generated_at": "2026-09-25T12:00:01Z"
    }
}

Konum geçmişi

GPS geçmişini izinli lisans dönemleri içinde okuyun. Seçilen aralıktaki en yeni noktalar kendi içinde artan zaman sırasıyla döner. has_more true ise daha eski bir aralık sorgulayın.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [
        {
            "recorded_at": "2026-09-25T11:59:00Z",
            "latitude": 41.01,
            "longitude": 28.97,
            "speed_kmh": 31.2,
            "heading_deg": 90,
            "ignition": true
        }
    ],
    "meta": {
        "count": 1,
        "has_more": false,
        "order": "ascending"
    }
}

Rapor uç noktaları

Web Raporlar ekranındaki her kart aşağıda ayrı ayrı açıklanır. Animasyon uç noktaları video değil, canlandırmaya kaynak olan veriyi döner. Her uç nokta yetkili aracı ve sayfalamayı kullanır.

Gerekli yetki: locations:read

Yanıt · JSON

{
    "data": [
        {
            "type": "ignition",
            "label": "Kontak Açma/Kapatma",
            "endpoint": "/vehicles/{imei}/reports/ignition"
        },
        {
            "type": "alarms",
            "label": "Alarm Raporu",
            "endpoint": "/vehicles/{imei}/reports/alarms"
        },
        {
            "type": "detail",
            "label": "Detay Raporu",
            "endpoint": "/vehicles/{imei}/reports/detail"
        },
        {
            "type": "trips",
            "label": "Seyahat Raporu",
            "endpoint": "/vehicles/{imei}/reports/trips"
        },
        {
            "type": "canbus",
            "label": "CAN Bus / OBD-II",
            "endpoint": "/vehicles/{imei}/reports/canbus"
        },
        {
            "type": "current-location",
            "label": "Anlık Konum",
            "endpoint": "/vehicles/{imei}/reports/current-location"
        },
        {
            "type": "vehicles",
            "label": "Araç Listesi",
            "endpoint": "/vehicles/{imei}/reports/vehicles"
        },
        {
            "type": "vehicle-score",
            "label": "Araç Skoru",
            "endpoint": "/vehicles/{imei}/reports/vehicle-score"
        },
        {
            "type": "vehicle-summary",
            "label": "Araç Performans Özeti",
            "endpoint": "/vehicles/{imei}/reports/vehicle-summary"
        },
        {
            "type": "blockage",
            "label": "Motor Blokajı",
            "endpoint": "/vehicles/{imei}/reports/blockage"
        },
        {
            "type": "trailer",
            "label": "Dorse",
            "endpoint": "/vehicles/{imei}/reports/trailer"
        },
        {
            "type": "stops",
            "label": "Durak / Rölanti",
            "endpoint": "/vehicles/{imei}/reports/stops"
        },
        {
            "type": "geofence",
            "label": "Bölge Giriş / Çıkış",
            "endpoint": "/vehicles/{imei}/reports/geofence"
        },
        {
            "type": "day-end",
            "label": "Gün Sonu",
            "endpoint": "/vehicles/{imei}/reports/day-end"
        },
        {
            "type": "daily-km",
            "label": "Günlük KM",
            "endpoint": "/vehicles/{imei}/reports/daily-km"
        },
        {
            "type": "speed",
            "label": "Hız",
            "endpoint": "/vehicles/{imei}/reports/speed"
        },
        {
            "type": "km-limit",
            "label": "Kilometre Aşımı",
            "endpoint": "/vehicles/{imei}/reports/km-limit"
        },
        {
            "type": "distance",
            "label": "Mesafe",
            "endpoint": "/vehicles/{imei}/reports/distance"
        },
        {
            "type": "off-hours",
            "label": "Mesai Dışı Kullanım",
            "endpoint": "/vehicles/{imei}/reports/off-hours"
        },
        {
            "type": "trip-summary",
            "label": "Seyahat Özeti",
            "endpoint": "/vehicles/{imei}/reports/trip-summary"
        },
        {
            "type": "drivers",
            "label": "Sürücü Performansı",
            "endpoint": "/vehicles/{imei}/reports/drivers"
        },
        {
            "type": "driver-list",
            "label": "Sürücü Listesi",
            "endpoint": "/vehicles/{imei}/reports/driver-list"
        },
        {
            "type": "driving-dynamics",
            "label": "Sürüş Dinamikleri",
            "endpoint": "/vehicles/{imei}/reports/driving-dynamics"
        },
        {
            "type": "gsensor-cockpit",
            "label": "G-Sensör Araç İçi Animasyon Verisi",
            "endpoint": "/vehicles/{imei}/reports/gsensor-cockpit"
        },
        {
            "type": "gsensor-motion",
            "label": "G-Sensör Hareket Animasyon Verisi",
            "endpoint": "/vehicles/{imei}/reports/gsensor-motion"
        },
        {
            "type": "total-km",
            "label": "Toplam KM",
            "endpoint": "/vehicles/{imei}/reports/total-km"
        },
        {
            "type": "fuel",
            "label": "Yakıt",
            "endpoint": "/vehicles/{imei}/reports/fuel"
        },
        {
            "type": "fuel-prices",
            "label": "Yakıt Fiyatları",
            "endpoint": "/vehicles/{imei}/reports/fuel-prices"
        },
        {
            "type": "temperature-overview",
            "label": "Soğuk Zincir Uyum Özeti",
            "endpoint": "/vehicles/{imei}/reports/temperature-overview"
        },
        {
            "type": "temperature-violations",
            "label": "Sıcaklık İhlalleri",
            "endpoint": "/vehicles/{imei}/reports/temperature-violations"
        },
        {
            "type": "temperature-proof",
            "label": "Sefer Bazlı Isı Kanıtı",
            "endpoint": "/vehicles/{imei}/reports/temperature-proof"
        },
        {
            "type": "temperature-readings",
            "label": "Ölçüm Günlüğü",
            "endpoint": "/vehicles/{imei}/reports/temperature-readings"
        },
        {
            "type": "auto-service-areas",
            "label": "Oto Sanayi Bölgeleri",
            "endpoint": "/vehicles/{imei}/reports/auto-service-areas"
        },
        {
            "type": "fleet-executive",
            "label": "Filo Yönetici Özeti",
            "endpoint": "/vehicles/{imei}/reports/fleet-executive"
        },
        {
            "type": "fleet-utilization",
            "label": "Filo Kullanım ve Atıl Araç",
            "endpoint": "/vehicles/{imei}/reports/fleet-utilization"
        },
        {
            "type": "fleet-tco",
            "label": "Filo Maliyet ve TCO",
            "endpoint": "/vehicles/{imei}/reports/fleet-tco"
        },
        {
            "type": "fleet-maintenance",
            "label": "Filo Bakım ve Arıza",
            "endpoint": "/vehicles/{imei}/reports/fleet-maintenance"
        },
        {
            "type": "fleet-availability",
            "label": "Filo Kullanılabilirlik",
            "endpoint": "/vehicles/{imei}/reports/fleet-availability"
        },
        {
            "type": "fleet-groups",
            "label": "Şube ve Filo Grubu",
            "endpoint": "/vehicles/{imei}/reports/fleet-groups"
        },
        {
            "type": "fleet-contracts",
            "label": "Kontrat ve KM Tahmini",
            "endpoint": "/vehicles/{imei}/reports/fleet-contracts"
        },
        {
            "type": "fleet-renewal",
            "label": "Filo Yenileme Kararı",
            "endpoint": "/vehicles/{imei}/reports/fleet-renewal"
        }
    ]
}

Kontak olayları

Yetkili tek aracın lisans dönemlerindeki kontak durum değişimlerini döner. Her lisans aralığının ilk örneği olay değil başlangıç durumudur. Tüm sonuç için page/per_page kullanın.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [
        {
            "recorded_at": "2026-09-25T07:13:00Z",
            "event": "opened",
            "ignition": true,
            "latitude": 41.01,
            "longitude": 28.97,
            "speed_kmh": 0
        }
    ],
    "meta": {
        "report": "ignition",
        "current_page": 1,
        "per_page": 50,
        "total": 1,
        "last_page": 1,
        "has_more": false
    }
}

Alarm olayları

Yetkili tek aracın alarm kayıtlarını lisans dönemleri ve olay anındaki şirket sahipliği içinde listeler.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [
        {
            "recorded_at": "2026-09-25T07:13:00Z",
            "code": "T_MOVEMENT",
            "description": "Araç hareket ettirildi",
            "category": "alarm",
            "is_active": true,
            "latitude": 41.01,
            "longitude": 28.97,
            "speed_kmh": 0
        }
    ],
    "meta": {
        "report": "alarms",
        "current_page": 1,
        "per_page": 50,
        "total": 1,
        "last_page": 1,
        "has_more": false
    }
}

Detay / paket raporu

Lisans dönemlerindeki cihaz paketlerini konum, hız ve kontakla sayfalar. Gelmeyen telemetri null olur.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [
        {
            "recorded_at": "2026-09-25T07:13:00Z",
            "latitude": 41.01,
            "longitude": 28.97,
            "speed_kmh": 31.2,
            "ignition": true
        }
    ],
    "meta": {
        "report": "detail",
        "current_page": 1,
        "per_page": 50,
        "total": 1,
        "has_more": false
    }
}

Seyahat raporu

Tamamı lisans aralığında kalan seyahatler; lisans sınırını aşan seyahatler güvenlik gereği gösterilmez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [
        {
            "started_at": "2026-09-25T07:13:00Z",
            "ended_at": "2026-09-25T08:00:00Z",
            "distance_km": 12.4,
            "duration_sec": 2820,
            "idle_sec": 120,
            "max_speed_kmh": 72
        }
    ],
    "meta": {
        "report": "trips",
        "current_page": 1,
        "per_page": 50,
        "total": 1,
        "has_more": false
    }
}

CAN Bus / OBD-II paketleri

Yalnız gerçekten CAN/OBD verisi bulunan paketleri döner. Gelmeyen alanlara tahmini değer yazmaz.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [
        {
            "recorded_at": "2026-09-25T07:13:00Z",
            "speed_kmh": 30,
            "telemetry": {
                "io_36": 860
            }
        }
    ],
    "meta": {
        "report": "canbus",
        "current_page": 1,
        "per_page": 50,
        "total": 1,
        "has_more": false
    }
}

Anlık Konum

Aracın en son konum, hız ve kontak anlık görüntüsü; etkin lisans gerekir.

• Bu, cihazdan bilinen son anlık görüntüdür; o anda alınmış GPS konumu olduğu garanti edilmez. Aracı çevrimiçi kabul etmeden paket zamanını kontrol edin. Geçmiş anlık görüntüler verilmez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "current-location",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Araç Listesi

Plaka, cihaz ve son sinyal bilgileri; etkin lisans gerekir.

• Bu, cihazdan bilinen son anlık görüntüdür; o anda alınmış GPS konumu olduğu garanti edilmez. Aracı çevrimiçi kabul etmeden paket zamanını kontrol edin. Geçmiş anlık görüntüler verilmez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "vehicles",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Araç Skoru

Güvenlik, verimlilik ve kullanım için araç puanı.

• Puanlar ve karşılaştırmalar kaydedilmiş hareketlerden hesaplanır. Kaynak veri eksikse puan boş kalabilir; boş puanı sıfır olarak yorumlamayın.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "vehicle-score",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Araç Performans Özeti

Seçili aracın yol, sürüş, rölanti ve alarm özeti.

• Puanlar ve karşılaştırmalar kaydedilmiş hareketlerden hesaplanır. Kaynak veri eksikse puan boş kalabilir; boş puanı sıfır olarak yorumlamayın.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "vehicle-summary",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Motor Blokajı

Blokaj özelliği ve aracın son durumu; etkin lisans gerekir.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.
• Salt okunur rapordur; sorgulamak hiçbir zaman blokaj komutu göndermez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "blockage",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Dorse

Dorse modülü varsa ilişkilendirme ve takip kayıtları.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.
• İsteğe bağlı dorse modülü yapılandırılmamışsa boş sonuç beklenir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "trailer",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Durak / Rölanti

Seyahatlerdeki duruş ve rölanti süreleri.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "stops",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Bölge Giriş / Çıkış

Tanımlı bölgelere giriş ve çıkış alarm olayları.

• Yalnız kaydedilmiş giriş/çıkış alarm olayları listelenir. Cihaz olay göndermediyse bölgede bekleme süresi yeniden üretilmez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "geofence",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Gün Sonu

Günlük ilk/son kontak, mesafe ve seyahat süreleri.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "day-end",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Günlük KM

Gün bazında sayaç ve kat edilen mesafe.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "daily-km",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Hız

Seferlerin ortalama/azami hız ve aşım adetleri.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "speed",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Kilometre Aşımı

Belirtilen günlük kilometre limitini aşan kayıtlar.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.
• km_limit istenen günlük eşiktir; lisanslı toplam mesafe değildir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "km-limit",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Mesafe

Sefer ve sayaçtan türetilen günlük mesafe.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "distance",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Mesai Dışı Kullanım

Mesai dışı seyahat ve ilgili alarmlar.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.
• Sınıflandırma web raporunda tanımlı çalışma saati ayarlarını izler.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "off-hours",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Seyahat Özeti

Günlük sefer sayısı, süre ve kilometre özeti.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "trip-summary",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Sürücü Performansı

Sürücü güvenlik ve verimlilik puanları.

• Sürücü performansı kayıtlı sürücü atamalarına bağlıdır. Atanmamış seyahat bir kişiye mal edilemez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "drivers",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Sürücü Listesi

Araca ait sürücü atamalarının listesi.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "driver-list",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Sürüş Dinamikleri

Ani fren, hızlanma, viraj ve yol olayı analizi.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "driving-dynamics",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

G-Sensör Araç İçi Animasyon Verisi

Kokpit canlandırmasına kaynak olan cihaz eksen örnekleri; API animasyon görüntüsü değil veri döner.

• Animasyonun kaynak olaylarını veya örneklenmiş eksen ölçümlerini döner; görsel ya da video üretmez. Performans için eksen noktaları seyreltilmiş olabilir.
• data, kokpit canlandırmasında kullanılan eksen örneklerini içerir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "gsensor-cockpit",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

G-Sensör Hareket Animasyon Verisi

3B hareket canlandırmasına kaynak olan kasis, yol ve sürüş olayları.

• Animasyonun kaynak olaylarını veya örneklenmiş eksen ölçümlerini döner; görsel ya da video üretmez. Performans için eksen noktaları seyreltilmiş olabilir.
• data, 3B canlandırmada kullanılan zaman damgalı hareket olaylarını içerir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "gsensor-motion",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Toplam KM

Dönem başı/sonu kilometre sayacı.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "total-km",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Yakıt

Sefer mesafesi ve tüketim profiline göre hesaplanan yakıt; tahmin kaynağı belirtilir.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.
• Tüketim, mesafe ve tanımlı profile göre tahmin edilmiş olabilir; mutlaka CAN üzerinden ölçülmüş yakıt akışı değildir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fuel",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Yakıt Fiyatları

Seçili il ve tarihteki karşılaştırmalı akaryakıt fiyatları.

• Satırlar web rapor tablosuyla aynı yapıyı kullanır: cells görüntülenen değerleri, export dışa aktarım değerlerini, summary dönem toplamlarını içerir. Boş data, hata değil eşleşen kayıt olmadığı anlamına gelir.
• Fiyatlar fuel_city ve fuel_date ile seçilen karşılaştırma verisidir; araç alımı veya ölçülmüş tüketim değildir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fuel-prices",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Soğuk Zincir Uyum Özeti

Sensör ölçümlerinden sıcaklık uyumu ve risk özeti.

• Yalnız cihazdan gerçekten alınan sensör ölçümleri kullanılır. Sensörün veri göndermediği aralıklar için ölçüm üretilmez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "temperature-overview",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Sıcaklık İhlalleri

Eşik dışı ölçümlerin gruplanmış ihlal olayları.

• Yalnız cihazdan gerçekten alınan sensör ölçümleri kullanılır. Sensörün veri göndermediği aralıklar için ölçüm üretilmez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "temperature-violations",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Sefer Bazlı Isı Kanıtı

Seyahat süresince ölçülen sıcaklık aralığı ve uyum kanıtı.

• Yalnız cihazdan gerçekten alınan sensör ölçümleri kullanılır. Sensörün veri göndermediği aralıklar için ölçüm üretilmez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "temperature-proof",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Ölçüm Günlüğü

Sensörden gelen ham sıcaklık ve nem ölçümleri.

• Yalnız cihazdan gerçekten alınan sensör ölçümleri kullanılır. Sensörün veri göndermediği aralıklar için ölçüm üretilmez.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "temperature-readings",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Oto Sanayi Bölgeleri

Haritada kullanılan etkin oto sanayi bölgesi kataloğu; araç telemetrisi değildir.

• Bu liste araç telemetrisi değil, ortak harita kataloğudur. Müşteri API isteği için yine de yetkili ve güncel lisanslı IMEI gerekir.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "auto-service-areas",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Filo Yönetici Özeti

Araç, KM, maliyet ve sağlık görünümü. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

• Filo raporu, karşılaştırma toplamları dahil URL’deki tek yetkili IMEI ile sınırlıdır. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fleet-executive",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Filo Kullanım ve Atıl Araç

Kullanım, hareketsiz gün ve sürüş/rölanti karşılaştırması. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

• Filo raporu, karşılaştırma toplamları dahil URL’deki tek yetkili IMEI ile sınırlıdır. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fleet-utilization",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Filo Maliyet ve TCO

Araç ve kilometre başına toplam sahip olma maliyeti. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

• Filo raporu, karşılaştırma toplamları dahil URL’deki tek yetkili IMEI ile sınırlıdır. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fleet-tco",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Filo Bakım ve Arıza

Bakım riski, servis süresi ve arızalar. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

• Filo raporu, karşılaştırma toplamları dahil URL’deki tek yetkili IMEI ile sınırlıdır. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fleet-maintenance",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Filo Kullanılabilirlik

Hazır, serviste, arızalı ve atıl araçlar. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

• Filo raporu, karşılaştırma toplamları dahil URL’deki tek yetkili IMEI ile sınırlıdır. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fleet-availability",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Şube ve Filo Grubu

Grup bazlı araç, kilometre ve maliyet karşılaştırması. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

• Filo raporu, karşılaştırma toplamları dahil URL’deki tek yetkili IMEI ile sınırlıdır. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fleet-groups",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Kontrat ve KM Tahmini

Kontrat bitişi, kilometre limiti ve aşım tahmini. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

• Filo raporu, karşılaştırma toplamları dahil URL’deki tek yetkili IMEI ile sınırlıdır. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fleet-contracts",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

Filo Yenileme Kararı

Yaş, KM, bakım ve sağlık temelli yenileme önceliği. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

• Filo raporu, karşılaştırma toplamları dahil URL’deki tek yetkili IMEI ile sınırlıdır. Önceki karşılaştırma dönemi ve güncel anlık durum da lisanslı olmalıdır.

Gerekli yetki: locations:read

Parametreler

Yanıt · JSON

{
    "data": [],
    "summary": [],
    "meta": {
        "report": "fleet-renewal",
        "vehicle": {
            "imei": "353742378000001",
            "plate": "34 ABC 123"
        },
        "current_page": 1,
        "per_page": 20,
        "total": 0,
        "last_page": 1,
        "has_more": false
    }
}

WebSocket bileti oluştur

Sunucunuzdan kısa ömürlü bağlantı bileti alın. REST gizli anahtarını tarayıcıya vermeyin.

Gerekli yetki: realtime:read

Parametreler

Yanıt · JSON

{
    "data": {
        "url": "wss://gw.arvetrak.com/ws",
        "token": "SHORT_LIVED_TOKEN",
        "expires_in": 300,
        "vehicle_count": 1,
        "ping_interval": 30
    }
}

Veri sözlüğü

Zamanlar UTC / ISO 8601 biçimindedir. Mesafe km, hız km/sa, voltaj V olarak verilir. Null, cihazdan güvenilir bir değer alınmadığını gösterir.

Hız sınırları

İstemci için standart, geçmiş ve WebSocket kotaları ayrıdır. Güncel değerleri /status üzerinden okuyun. HTTP 429 aldığınızda bekleyin; yoğun tekrar döngüsü kurmayın.

Hata kodları

Hatalar sabit bir error koduyla JSON döner. Erişim yetkisini hata metninden tahmin etmeyin.

Yanıt · JSON

{
    "message": "Request parameters are invalid.",
    "error": "validation_error",
    "errors": {
        "from": [
            "The from field is required."
        ]
    }
}

Güvenlik

HTTPS/WSS kullanın; anahtarları yalnız sunucu sırlarında saklayın, sızanları yenileyin, IP aralıklarını dar tutun ve konum/gizli anahtarları loglamayın. Mobil API ayrı kimlik doğrulama kullanır ve bu müşteri API limitlerine tabi değildir.