Hızlı entegrasyon: REST ve JSON

Nasıl çalışır?

• REST/JSON: POST https://api.otodegerleme.com/v1/quotes
• API anahtarı Authorization: Bearer başlığında gönderilir.
• Sandbox anahtarıyla gerçek değerleme yapılmaz; istek ve yanıt şeması canlı ile aynıdır.
• Değerleme için kişisel veri gerekmez; yalnızca araç özellikleri gönderilir.

Örnek istek

Örnek: alan adları ve değerler gösterim amaçlıdır. Kesin şema, teklif sonrası paylaşılan teknik dokümantasyondadır.

curl -X POST https://api.otodegerleme.com/v1/quotes \
  -H "Authorization: Bearer sk_test_ORNEK_ANAHTAR" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "brand": "Marka",
      "series": "Seri",
      "model": "Model",
      "trim": "Donanım",
      "year": 2019
    },
    "km": 85000,
    "damage": {
      "parts": { "kaput": "boyali", "sag_on_camurluk": "orijinal" },
      "tramer_amount": 12000,
      "heavy_damage": false
    }
  }'

Örnek yanıt

Örnek: değerler gerçek bir değerlemeye ait değildir.

{
  "quote_id": "qt_ornek",
  "data_date": "YYYY-AA-GG",
  "market_value": { "estimate": 0, "low": 0, "high": 0 },
  "confidence": { "level": "medium", "reason": "Gerekçe metni" }
}

Sürüm politikası

• Mevcut sürüm geriye dönük uyumlu kalır.
• Kırıcı değişiklik yeni bir sürüm olarak, önceden duyurularak yayımlanır.
• Model güncellemesi API sürümü değildir; yanıttaki model sürümü değişir.

Teknik dokümantasyon

Teknik dokümantasyon teklif sonrası paylaşılır.