API Referansı v1

DeeDe Routing API, hibrit yapay zeka motorunu kullanarak VRP (Araç Rotalama) problemlerini çözer. OSRM tabanlı gerçek yol verileri ile AI tahminlerini birleştirir.

Kimlik Doğrulama

Tüm isteklerde Authorization başlığı altında Bearer token kullanmalısınız.

BASH

curl -X POST https://routing.deede.tr/api/v1/optimize.php \
  -H "Authorization: Bearer sk_6911..." \
  -H "Content-Type: application/json" \
  -d '{...}'
            

Rota Çözücü

Hibrit motor (AI + OR-Tools) kullanarak en iyi rotayı bulur.

POST

/api/v1/optimize.php

İstek Gövdesi (JSON)

JSON

{
  // Koordinat Listesi: [Enlem, Boylam]
  // İlk nokta (Index 0) her zaman BAŞLANGIÇ (Depot) kabul edilir.
  "coords": [
    [41.0082, 28.9784], // Depot
    [41.0122, 29.0010], // Müşteri 1
    [40.9910, 29.0210]  // Müşteri 2
  ],
  "scenario_name": "Sabah Teslimatı" // Opsiyonel
}
            

Başarılı Yanıt

JSON

{
  "success": true,
  "winner": "AI", // Hangi motor kazandı? (AI veya OR-Tools)
  "best_distance": 12450.5, // Metre cinsinden
  "best_route": [0, 2, 1], // Optimize edilmiş ziyaret sırası (Indexler)
  "improvement_percentage": 12.4, // AI, standart metoda göre ne kadar iyileştirme yaptı?
  "route_geometry": { ... } // Harita çizimi için GeoJSON
}
            

Limitler

Maksimum Nokta Sayısı: 100
Zaman Aşımı: 30 Saniye

Hata Kodları

Kod	Açıklama
401	Geçersiz API Anahtarı.
400	Hatalı JSON formatı veya eksik koordinat.
500	Sunucu hatası.