Vera Public API (1.0.0)
Filo takip verileri (araçlar, canlı konumlar, raporlar ve geçmiş) için genel (public) REST API. Eski SOAP servisinin yerini alır; aşağıdaki modernize edilmiş JSON alan adları, tüm API kullanıcıları için eski SOAP alanlarının yerini tamamen alır.
Tüm uç noktalar, HTTP Bearer token olarak gönderilen bir API anahtarı gerektirir: Authorization: Bearer <anahtar>. Anahtarlar firma bazında verilir; her anahtar yalnızca o firmanın araçlarına erişebilir.
Başarılı yanıtlar her zaman { "data": ..., "meta": { "count": N } } biçimindedir. Hatalar { "error": { "code": "...", "message": "..." } } biçimindedir; code makine tarafından okunabilir, message İngilizce ve insan tarafından okunabilir bir açıklamadır.
İstenen deviceId, çağıranın hesabına ait değilse (anahtarın araç kapsamına göre), API 404/403 döndürmez — HTTP 200 ile boş sonuç döner: { "data": [], "meta": { "count": 0 } }. Bu davranış, eski servisin yetkisiz/bilinmeyen cihazlar için "sonuç yok" davranışıyla eşleşir.
date1/date2 alan rapor ve geçmiş uç noktaları, sunucu tarafında en fazla aralık uygular:
/v1/history/tracking: 300 gün- diğer tüm tarih-aralıklı uç noktalar (
/v1/reports/mileage,/v1/reports/working-hours,/v1/reports/heat,/v1/history/alarms): 32 gün
Sınırın aşılması, date1'in date2'den sonra olması veya geçersiz bir tarih biçimi, HTTP 422 ve {"error":{"code":"INVALID_DATE_RANGE", ...}} ile sonuçlanır.