Seferi /Route API
Durum kontrol ediliyor…
API dokümantasyonu

Rota ve maliyet, tek istekte.

Türkiye karayolları için rota, mesafe, süre ve maliyet hesaplayan REST API. Bir başlangıç ve bitiş noktası verirsiniz; kilometreyi, tahmini süreyi, gişe ve yakıt maliyetini tek cevapta alırsınız.

Tüm istekler şu adrese yapılır: https://route.seferiai.com

Hızlı başlangıç

1
Anahtar alınErişim anahtarınızı Seferi ekibinden isteyin.
2
Bağlantıyı deneyinGET /health anahtar gerektirmez.
3
İlk rotanızı alınPOST /route/generate ile rota ve maliyet.

İlk isteğiniz

curl -X POST https://route.seferiai.com/route/generate \
  -H "Authorization: Bearer ERISIM_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicleTypeId": 5,
    "from": { "lat": "41.0082", "lng": "28.9784" },
    "to":   { "lat": "40.1885", "lng": "29.0610" },
    "routeType": "fast",
    "isToll": 1
  }'

Kimlik doğrulama

Her istekte erişim anahtarınızı Authorization başlığında gönderin. Anahtarsız ya da geçersiz anahtarlı istekler 401 ile döner.

HTTP
Authorization: Bearer ERISIM_ANAHTARINIZ
Anahtarınızı tarayıcıda çalışan koda ya da herkese açık depolara koymayın; istekleri kendi sunucunuzdan yapın.

Rota oluştur

POST/route/generate

İki nokta arasında rota hesaplar; mesafe, süre ve maliyeti döndürür. Ara noktalar ve kaçınılacak bölgeler eklenebilir.

Parametreler

AlanTürAçıklama
vehicleTypeId zorunluintegerAraç tipi. Liste için araç tipleri.
from zorunluobjectBaşlangıç noktası: { "lat", "lng" }
to zorunluobjectBitiş noktası: { "lat", "lng" }
routeType zorunlustring"fast" en hızlı, "short" en kısa rota.
waypoints isteğe bağlıarraySırayla uğranacak ara noktalar.
avoidPoints isteğe bağlıarrayRotanın geçmemesi gereken noktalar ya da bölgeler.
isToll isteğe bağlı0 / 1Gişe ücretleri maliyete eklensin mi.
isShip isteğe bağlı0 / 1Feribot geçişleri kullanılabilsin mi.
isGlobal isteğe bağlıbooleanRota yurt dışına çıkıyorsa true gönderin. Otomatik algılanmaz. Varsayılan false.
fuelRatio isteğe bağlınumberYakıt tüketimi (litre / 100 km).

Örnek cevap

JSON
{
  "status": true,
  "data": {
    "distance": 354.82,      // km
    "totalTime": 18540,      // saniye
    "totalCost": 2150.65,    // TL
    "routeId": "route_abc123",
    "costs": { "fuel": 1850.65, "toll": 300.00, "total": 2150.65 }
  }
}

Rota detayı

GET/route/get?routeId=…

Daha önce oluşturulan bir rotanın tüm ayrıntılarını döndürür: noktalar, bölümler, gişe noktaları ve maliyet kırılımı.

AlanTürAçıklama
routeId zorunlustringRota oluştururken dönen kimlik.

Araç tipleri

GET/route/get/vehicle/types

Rota oluştururken kullanabileceğiniz araç tiplerini ve kimliklerini listeler.

IDAraç
1Otomobil
2Minibüs
3Otobüs
4Hafif ticari
5Kamyon / TIR

Rota geçmişi

GET/route/get/history?routeKey=…

Aynı güzergâh için hesaplanmış tüm sürümleri ve şu an kullanılan (aktif) sürümü döndürür.

AlanTürAçıklama
routeKey zorunlustringGüzergâhın anahtarı.

Aktif sürümü değiştir

POST/route/change-active

Bir güzergâhın geçmişteki sürümlerinden birini aktif yapar. Sonraki istekler bu sürümü kullanır.

JSON
{ "routeKey": "rou_123456", "routeId": 1233 }

Kullanımım

GET/usage/my-stats

Anahtarınızla yapılan isteklerin özeti: rota sayısı, toplam mesafe ve maliyet, gün gün dağılım.

AlanTürAçıklama
period isteğe bağlıintegerKaç günlük veri (1–365). Varsayılan 7.
groupBy isteğe bağlıstringhour, day ya da month. Varsayılan day.

Genel istatistik yönetici

GET/usage/overall

Tüm anahtarların toplam kullanımı. Yalnızca yönetici anahtarıyla erişilir. period parametresi yukarıdakiyle aynıdır.

Sağlık kontrolü anahtar gerekmez

GET/health

Servisin ve bağlı bileşenlerinin çalışıp çalışmadığını döndürür. İzleme araçları için uygundur.

Hatalar

Hatalı isteklerde status: false ve açıklayıcı bir mesaj döner.

KodAnlamı
401Anahtar eksik ya da geçersiz.
400Parametreler eksik ya da hatalı biçimde.
500Sunucu tarafında beklenmeyen bir hata. Kısa bir süre sonra tekrar deneyin.