Araçlar

Galerinizin araç envanterini (network_vehicles) okumak için tek uç nokta. Kapsam: vehicles:read.

GET /api/v1/vehicles.php

Yalnızca API key'inizin ait olduğu galerinin araçlarını döner — başka bir galerinin envanterine bu uç noktadan asla erişilemez.

Sorgu Parametreleri

Parametre	Tip	Açıklama
status	string	Belirli bir duruma göre filtreler. Geçerli değerler: Stokta, Rezerve, Auction'da, Satıldı.
limit	integer	Sayfa başına kayıt. Varsayılan 25, maksimum 100 — bkz. Sayfalama.
offset	integer	Atlanacak kayıt sayısı.

Yanıt Alanları

Alan	Tip	Açıklama
id	uuid	Aracın benzersiz kimliği.
brand	string	Marka.
model	string	Model.
model_year	integer	Model yılı.
km	integer	Kilometre.
fuel_type	string	Yakıt tipi.
transmission	string	Vites tipi.
body_type	string	Kasa tipi.
color	string	Renk.
plate	string	Plaka.
city	string	Şehir.
price	numeric	Satış fiyatı.
currency	string	Para birimi (TL/STG/USD/EUR).
status	string	Stok durumu (yukarıdaki değerlerden biri).
is_marketplace_visible	boolean	Araç pazaryerinde görünür mü.
created_at / updated_at	timestamp	ISO 8601 (UTC).

Bilerek yanıta dahil edilmeyenler: maliyet/alış fiyatı, gümrük bedeli, şasi/motor numarası gibi galerinin dahili finansal ve hassas verileri — bu alanlar hiçbir API key ile, hiçbir kapsamla dışarı verilmez.

Örnek İstekler

curl "https://otomovena.com/api/v1/vehicles.php?status=Stokta&limit=10" \
  -H "Authorization: Bearer otv_live_xxxxx..."

<?php
$ch = curl_init('https://otomovena.com/api/v1/vehicles.php?status=Stokta&limit=10');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer otv_live_xxxxx...']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$vehicles = json_decode(curl_exec($ch), true)['data'];

const res = await fetch('https://otomovena.com/api/v1/vehicles.php?status=Stokta&limit=10', {
  headers: { Authorization: 'Bearer otv_live_xxxxx...' }
});
const { data } = await res.json();

import requests

res = requests.get(
    "https://otomovena.com/api/v1/vehicles.php",
    params={"status": "Stokta", "limit": 10},
    headers={"Authorization": "Bearer otv_live_xxxxx..."},
)
vehicles = res.json()["data"]

Örnek Yanıt

{
  "success": true,
  "data": [
    {
      "id": "b4dcd9bc-...",
      "brand": "Audi",
      "model": "Q3 S Line",
      "model_year": 2023,
      "km": 42000,
      "fuel_type": "Dizel",
      "transmission": "Otomatik",
      "body_type": "SUV",
      "color": "Beyaz",
      "plate": "07 ABC 123",
      "city": "Girne",
      "price": "850000.00",
      "currency": "TL",
      "status": "Stokta",
      "is_marketplace_visible": true,
      "created_at": "2026-06-01T10:00:00Z",
      "updated_at": "2026-06-01T10:00:00Z"
    }
  ],
  "meta": { "limit": 10, "offset": 0, "count": 1 }
}

Bu Uç Noktaya Özel Hatalar

HTTP	Kod	Neden
403	insufficient_scope	Key'de vehicles:read kapsamı yok.
405	method_not_allowed	GET dışında bir metod denendi (ör. POST).

Genel hata kodları için: Hata Kodları & Rate Limit.