API Referansı — Tüm Uç Noktalar

Taban URL: https://otomovena.com/api/v1/. Tüm yanıtlar {"success": true, "data": ..., "meta": {...}} zarfında JSON olarak döner. Toplam 185 uç nokta dokümante edilmiştir, 6 tanesi şu an canlıdır.

Ortak Kurallar

Kimlik doğrulama: Kimlik Doğrulama — Authorization: Bearer <key> zorunlu.
Kapsamlar: Kapsamlar (Scopes).
Sayfalama: Sayfalama.
Hız sınırı: Hız Sınırları.
Hatalar: Hata Kodları.
Tarayıcıdan canlı deneme: API Explorer.
Her kaynak yalnızca isteği yapan key'in ait olduğu galerinin (tenant) verisini döner; başka bir galerinin verisine bu API üzerinden hiçbir şekilde erişilemez.

Kategoriler

Hesap / Account Araçlar / Envanter Araç Fotoğrafları Araç Videoları Müşteriler Kefiller Satışlar Taksit Planları Tahsilat Ödeme Sözleri Belgeler Senetler Görevler Bayi Ağı Teklifleri Takas Talepleri Bayi Ağı Açık Artırmaları Pazaryeri Açık Artırma Talepleri Canlı Açık Artırmalar Üyelik / Lisans Cüzdan Öne Çıkarma Bildirimler Döviz Kurları Raporlar & Analitik İçe Aktarma Merkezi Webhook Yönetimi API Kullanımı

Hesap / Account

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/account`	Hesap Bilgisi Bağlı API key'in ait olduğu galeri hesabının temel bilgilerini döner.	`account:read`	Okuma	Aktif
GET	`/api/v1/account/branches`	Şube Listesi Galeriye ait şubelerin listesi.	`account:read`	Okuma	Yakında
GET	`/api/v1/account/branches/{branch_id}`	Şube Detayı Belirli bir şubenin detayı.	`account:read`	Okuma	Yakında
GET	`/api/v1/account/settings`	Hesap Ayarları Galerinin genel ayarları (salt okunur).	`account:read`	Okuma	Yakında
GET	`/api/v1/account/capabilities`	Yetenekler Hesabın plana göre aktif modülleri/limitleri.	`account:read`	Okuma	Yakında

Araçlar / Envanter

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/vehicles`	Araç Listesi Envanterdeki araçları filtreli/sayfalı listeler.	`vehicles:read`	Okuma	Aktif
POST	`/api/v1/vehicles`	Araç Oluştur Yeni araç kaydı oluşturur.	`vehicles:write`	Yazma	Yakında
GET	`/api/v1/vehicles/{vehicle_id}`	Araç Detayı Tek bir aracın tüm alanlarını döner.	`vehicles:read`	Okuma	Yakında
PATCH	`/api/v1/vehicles/{vehicle_id}`	Araç Güncelle Araç alanlarını kısmi günceller.	`vehicles:write`	Yazma	Yakında
DELETE	`/api/v1/vehicles/{vehicle_id}`	Araç Sil Aracı siler (yumuşak silme).	`vehicles:write`	Yıkıcı	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/publish`	Yayınla Aracı vitrine/pazaryerine yayınlar.	`vehicles:write`	Yazma	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/unpublish`	Yayından Kaldır Aracı vitrinden kaldırır.	`vehicles:write`	Yazma	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/reserve`	Rezerve Et Aracı rezerve durumuna alır.	`vehicles:write`	Yazma	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/mark-sold`	Satıldı İşaretle Aracı satıldı durumuna alır.	`vehicles:write`	Yazma	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/restore`	Geri Yükle Silinmiş aracı geri yükler.	`vehicles:write`	Yazma	Yakında
GET	`/api/v1/vehicles/{vehicle_id}/history`	Durum Geçmişi Aracın durum/fiyat değişiklik geçmişi.	`vehicles:read`	Okuma	Yakında
GET	`/api/v1/vehicles/export`	Dışa Aktar Envanterin toplu dışa aktarımı (CSV/JSON).	`vehicles:read`	Okuma	Yakında
POST	`/api/v1/vehicles/bulk-create`	Toplu Oluştur Birden çok aracı tek istekte oluşturur.	`vehicles:write`	Yazma	Yakında
POST	`/api/v1/vehicles/bulk-update`	Toplu Güncelle Birden çok aracı tek istekte günceller.	`vehicles:write`	Yazma	Yakında

Araç Fotoğrafları

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/vehicles/{vehicle_id}/photos`	Fotoğraf Listesi Araca ait fotoğrafları listeler.	`vehicles:read`	Okuma	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/photos`	Fotoğraf Ekle Araca fotoğraf yükler.	`vehicles:write`	Yazma	Yakında
GET	`/api/v1/vehicles/{vehicle_id}/photos/{photo_id}`	Fotoğraf Detayı Tek fotoğraf meta verisi.	`vehicles:read`	Okuma	Yakında
PATCH	`/api/v1/vehicles/{vehicle_id}/photos/{photo_id}`	Fotoğraf Güncelle Sıra/etiket gibi alanları günceller.	`vehicles:write`	Yazma	Yakında
DELETE	`/api/v1/vehicles/{vehicle_id}/photos/{photo_id}`	Fotoğraf Sil Fotoğrafı kaldırır.	`vehicles:write`	Yıkıcı	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/photos/reorder`	Sırala Fotoğraf gösterim sırasını değiştirir.	`vehicles:write`	Yazma	Yakında

Araç Videoları

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/vehicles/{vehicle_id}/videos`	Video Listesi Araca ait videoları listeler.	`vehicles:read`	Okuma	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/videos`	Video Ekle Araca video/link ekler.	`vehicles:write`	Yazma	Yakında
GET	`/api/v1/vehicles/{vehicle_id}/videos/{video_id}`	Video Detayı Tek video meta verisi.	`vehicles:read`	Okuma	Yakında
PATCH	`/api/v1/vehicles/{vehicle_id}/videos/{video_id}`	Video Güncelle Video alanlarını günceller.	`vehicles:write`	Yazma	Yakında
DELETE	`/api/v1/vehicles/{vehicle_id}/videos/{video_id}`	Video Sil Videoyu kaldırır.	`vehicles:write`	Yıkıcı	Yakında
POST	`/api/v1/vehicles/{vehicle_id}/videos/reorder`	Sırala Video gösterim sırasını değiştirir.	`vehicles:write`	Yazma	Yakında

Müşteriler

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/customers`	Müşteri Listesi Müşterileri filtreli/sayfalı listeler.	`customers:read`	Okuma	Aktif
POST	`/api/v1/customers`	Müşteri Oluştur Yeni müşteri kaydı oluşturur.	`customers:write`	Yazma	Yakında
GET	`/api/v1/customers/{customer_id}`	Müşteri Detayı Tek müşteri kaydı.	`customers:read`	Okuma	Yakında
PATCH	`/api/v1/customers/{customer_id}`	Müşteri Güncelle Müşteri alanlarını günceller.	`customers:write`	Yazma	Yakında
DELETE	`/api/v1/customers/{customer_id}`	Müşteri Sil Müşteriyi siler (yumuşak silme).	`customers:write`	Yıkıcı	Yakında
GET	`/api/v1/customers/{customer_id}/sales`	Müşteri Satışları Müşteriye ait satış kayıtları.	`customers:read`	Okuma	Yakında
GET	`/api/v1/customers/{customer_id}/collections`	Müşteri Tahsilatları Müşteriye ait tahsilat kayıtları.	`collections:read`	Okuma	Yakında
GET	`/api/v1/customers/{customer_id}/documents`	Müşteri Belgeleri Müşteriye ait belge listesi.	`documents:read`	Okuma	Yakında
GET	`/api/v1/customers/{customer_id}/activity`	Aktivite Geçmişi Müşteri ile ilgili aktivite kayıtları.	`customers:read`	Okuma	Yakında
POST	`/api/v1/customers/{customer_id}/activity`	Aktivite Ekle Müşteri için not/aktivite ekler.	`customers:write`	Yazma	Yakında

Kefiller

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/customers/{customer_id}/guarantors`	Kefil Listesi Müşteriye bağlı kefiller.	`guarantors:read`	Okuma	Yakında
POST	`/api/v1/customers/{customer_id}/guarantors`	Kefil Ekle Müşteriye kefil ekler.	`guarantors:write`	Yazma	Yakında
GET	`/api/v1/guarantors/{guarantor_id}`	Kefil Detayı Tek kefil kaydı.	`guarantors:read`	Okuma	Yakında
PATCH	`/api/v1/guarantors/{guarantor_id}`	Kefil Güncelle Kefil alanlarını günceller.	`guarantors:write`	Yazma	Yakında
DELETE	`/api/v1/guarantors/{guarantor_id}`	Kefil Sil Kefili kaldırır.	`guarantors:write`	Yıkıcı	Yakında

Satışlar

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/sales`	Satış Listesi Satışları filtreli/sayfalı listeler.	`sales:read`	Okuma	Yakında
POST	`/api/v1/sales`	Satış Oluştur Yeni satış kaydı oluşturur.	`sales:write`	Yazma	Yakında
GET	`/api/v1/sales/{sale_id}`	Satış Detayı Tek satış kaydı.	`sales:read`	Okuma	Yakında
PATCH	`/api/v1/sales/{sale_id}`	Satış Güncelle Satış alanlarını günceller.	`sales:write`	Yazma	Yakında
DELETE	`/api/v1/sales/{sale_id}`	Satış İptal Satışı iptal eder (fiziksel silme değil).	`sales:write`	Yıkıcı	Yakında
GET	`/api/v1/sales/{sale_id}/installment-plan`	Taksit Planı Satışa bağlı taksit planı.	`installments:read`	Okuma	Yakında
GET	`/api/v1/sales/{sale_id}/collections`	Satış Tahsilatları Satışa bağlı tahsilat kayıtları.	`collections:read`	Okuma	Yakında
GET	`/api/v1/sales/{sale_id}/documents`	Satış Belgeleri Satışa bağlı belge listesi.	`documents:read`	Okuma	Yakında
POST	`/api/v1/sales/{sale_id}/cancel`	Satışı Sonlandır Satışı iptal/feshet.	`sales:write`	Yıkıcı	Yakında

Taksit Planları

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/installment-plans`	Plan Listesi Tüm taksit planlarını listeler.	`installments:read`	Okuma	Yakında
GET	`/api/v1/installment-plans/{plan_id}`	Plan Detayı Tek taksit planı.	`installments:read`	Okuma	Yakında
GET	`/api/v1/installment-plans/{plan_id}/installments`	Taksit Kalemleri Plana ait taksit satırları.	`installments:read`	Okuma	Yakında
PATCH	`/api/v1/installments/{installment_id}`	Taksit Güncelle Vade/tutar gibi alanları günceller.	`installments:write`	Yazma	Yakında
GET	`/api/v1/installments/overdue`	Geciken Taksitler Vadesi geçmiş tüm taksitler.	`installments:read`	Okuma	Yakında
GET	`/api/v1/installments/upcoming`	Yaklaşan Taksitler Vadesi yaklaşan taksitler.	`installments:read`	Okuma	Yakında
POST	`/api/v1/installments/{installment_id}/postpone`	Vade Ertele Taksit vadesini erteler.	`installments:write`	Yazma	Yakında
GET	`/api/v1/customers/{customer_id}/installments`	Müşteri Taksitleri Müşteriye ait tüm taksitler.	`installments:read`	Okuma	Yakında

Tahsilat

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/collections`	Tahsilat Listesi Tüm tahsilat kayıtlarını listeler.	`collections:read`	Okuma	Yakında
POST	`/api/v1/collections`	Tahsilat Oluştur Yeni tahsilat kaydı oluşturur.	`collections:write`	Yazma	Yakında
GET	`/api/v1/collections/{collection_id}`	Tahsilat Detayı Tek tahsilat kaydı.	`collections:read`	Okuma	Yakında
POST	`/api/v1/collections/{collection_id}/reverse`	Tahsilatı Ters Çevir Hatalı tahsilatı ters kayıtla iptal eder (fiziksel silme YOK).	`collections:write`	Yıkıcı	Yakında
GET	`/api/v1/collections/summary`	Tahsilat Özeti Tarih aralığına göre toplam tahsilat özeti.	`collections:read`	Okuma	Yakında

Ödeme Sözleri

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/payment-promises`	Söz Listesi Verilen ödeme sözlerini listeler.	`payment-promises:read`	Okuma	Yakında
POST	`/api/v1/payment-promises`	Söz Oluştur Yeni ödeme sözü kaydeder.	`payment-promises:write`	Yazma	Yakında
GET	`/api/v1/payment-promises/{promise_id}`	Söz Detayı Tek ödeme sözü kaydı.	`payment-promises:read`	Okuma	Yakında
PATCH	`/api/v1/payment-promises/{promise_id}`	Söz Güncelle Söz durumunu günceller (tutuldu/tutulmadı).	`payment-promises:write`	Yazma	Yakında

Belgeler

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/documents`	Belge Listesi Tüm belgeleri listeler.	`documents:read`	Okuma	Yakında
POST	`/api/v1/documents`	Belge Yükle Yeni belge yükler.	`documents:write`	Yazma	Yakında
GET	`/api/v1/documents/{document_id}`	Belge Detayı Tek belge meta verisi.	`documents:read`	Okuma	Yakında
DELETE	`/api/v1/documents/{document_id}`	Belge Sil Belgeyi kaldırır.	`documents:write`	Yıkıcı	Yakında
GET	`/api/v1/document-templates`	Belge Şablonları Kullanılabilir belge şablonları.	`documents:read`	Okuma	Yakında
GET	`/api/v1/sales/{sale_id}/sale-documents`	Satış Belgeleri Listesi Satışa özel belgeler.	`documents:read`	Okuma	Yakında
POST	`/api/v1/sales/{sale_id}/sale-documents/generate`	Belge Üret Şablondan satış belgesi üretir.	`documents:write`	Yazma	Yakında
GET	`/api/v1/sale-documents/{document_id}/signed-copy`	İmzalı Kopya Belgenin imzalı/nihai kopyasını indirir.	`documents:read`	Okuma	Yakında
GET	`/api/v1/sale-documents/{document_id}/events`	Belge Olayları Görüntülenme/imzalanma olay geçmişi.	`documents:read`	Okuma	Yakında
POST	`/api/v1/sale-documents/{document_id}/send`	Belge Gönder Belgeyi e-posta/SMS ile gönderir.	`documents:write`	Yazma	Yakında
POST	`/api/v1/sale-documents/{document_id}/void`	Belgeyi Geçersiz Kıl Belgeyi geçersiz sayar (silmeden).	`documents:write`	Yıkıcı	Yakında

Senetler

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/promissory-notes`	Senet Listesi Tüm senetleri listeler.	`promissory-notes:read`	Okuma	Yakında
POST	`/api/v1/promissory-notes`	Senet Oluştur Yeni senet kaydı oluşturur.	`promissory-notes:write`	Yazma	Yakında
GET	`/api/v1/promissory-notes/{note_id}`	Senet Detayı Tek senet kaydı.	`promissory-notes:read`	Okuma	Yakında
PATCH	`/api/v1/promissory-notes/{note_id}`	Senet Güncelle Senet durumunu günceller.	`promissory-notes:write`	Yazma	Yakında
GET	`/api/v1/promissory-notes/{note_id}/document`	Senet Belgesi Senedin belge/görsel çıktısı.	`promissory-notes:read`	Okuma	Yakında

Görevler

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/tasks`	Görev Listesi Tüm görevleri listeler.	`tasks:read`	Okuma	Yakında
POST	`/api/v1/tasks`	Görev Oluştur Yeni görev oluşturur.	`tasks:write`	Yazma	Yakında
GET	`/api/v1/tasks/{task_id}`	Görev Detayı Tek görev kaydı.	`tasks:read`	Okuma	Yakında
PATCH	`/api/v1/tasks/{task_id}`	Görev Güncelle Görev durumunu/atamasını günceller.	`tasks:write`	Yazma	Yakında
DELETE	`/api/v1/tasks/{task_id}`	Görev Sil Görevi kaldırır.	`tasks:write`	Yıkıcı	Yakında

Bayi Ağı Teklifleri

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/network-offers`	Teklif Listesi Bayi ağındaki teklifleri listeler.	`network-offers:read`	Okuma	Yakında
POST	`/api/v1/network-offers`	Teklif Oluştur Bir araç için ağ teklifi oluşturur.	`network-offers:write`	Yazma	Yakında
GET	`/api/v1/network-offers/{offer_id}`	Teklif Detayı Tek teklif kaydı.	`network-offers:read`	Okuma	Yakında
POST	`/api/v1/network-offers/{offer_id}/accept`	Teklifi Kabul Et Gelen teklifi kabul eder.	`network-offers:write`	Yazma	Yakında
POST	`/api/v1/network-offers/{offer_id}/reject`	Teklifi Reddet Gelen teklifi reddeder.	`network-offers:write`	Yazma	Yakında
POST	`/api/v1/network-offers/{offer_id}/counter`	Karşı Teklif Karşı teklif gönderir.	`network-offers:write`	Yazma	Yakında
POST	`/api/v1/network-offers/{offer_id}/withdraw`	Teklifi Geri Çek Verilen teklifi geri çeker.	`network-offers:write`	Yazma	Yakında
GET	`/api/v1/vehicles/{vehicle_id}/network-offers`	Araç Teklifleri Bir araca gelen tüm ağ teklifleri.	`network-offers:read`	Okuma	Yakında
GET	`/api/v1/network-offers/received`	Gelen Teklifler Galerinin aldığı teklifler.	`network-offers:read`	Okuma	Yakında

Takas Talepleri

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/trade-requests`	Takas Talebi Listesi Tüm takas taleplerini listeler.	`trade-requests:read`	Okuma	Yakında
POST	`/api/v1/trade-requests`	Takas Talebi Oluştur Yeni takas talebi oluşturur.	`trade-requests:write`	Yazma	Yakında
GET	`/api/v1/trade-requests/{request_id}`	Takas Talebi Detayı Tek takas talebi kaydı.	`trade-requests:read`	Okuma	Yakında
POST	`/api/v1/trade-requests/{request_id}/accept`	Talebi Kabul Et Takas talebini kabul eder.	`trade-requests:write`	Yazma	Yakında
POST	`/api/v1/trade-requests/{request_id}/reject`	Talebi Reddet Takas talebini reddeder.	`trade-requests:write`	Yazma	Yakında
DELETE	`/api/v1/trade-requests/{request_id}`	Talebi İptal Et Kendi talebini iptal eder.	`trade-requests:write`	Yıkıcı	Yakında

Bayi Ağı Açık Artırmaları

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/network-auctions`	Açık Artırma Listesi Ağ içi açık artırmaları listeler.	`network-auctions:read`	Okuma	Yakında
GET	`/api/v1/network-auctions/{auction_id}`	Açık Artırma Detayı Tek açık artırma kaydı.	`network-auctions:read`	Okuma	Yakında
GET	`/api/v1/network-auctions/{auction_id}/bids`	Teklif Geçmişi Açık artırmadaki teklifler.	`network-auctions:read`	Okuma	Yakında
POST	`/api/v1/network-auctions/{auction_id}/bid`	Teklif Ver Açık artırmaya teklif verir (özel yetkili entegrasyon gerekir).	`network-auctions:write`	Hassas	Yakında
POST	`/api/v1/network-auctions`	Açık Artırma Başlat Bir araç için ağ açık artırması başlatır.	`network-auctions:write`	Yazma	Yakında
POST	`/api/v1/network-auctions/{auction_id}/end`	Açık Artırmayı Sonlandır Açık artırmayı erken sonlandırır.	`network-auctions:write`	Hassas	Yakında
GET	`/api/v1/network-auctions/{auction_id}/winner`	Kazanan Bilgisi Açık artırmanın kazananı.	`network-auctions:read`	Okuma	Yakında
GET	`/api/v1/vehicles/{vehicle_id}/network-auction`	Araç Açık Artırması Bir araca ait açık artırma kaydı.	`network-auctions:read`	Okuma	Yakında

Pazaryeri

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/marketplace/listings`	İlan Listesi Pazaryerindeki ilanları listeler.	`marketplace:read`	Okuma	Yakında
GET	`/api/v1/marketplace/listings/{listing_id}`	İlan Detayı Tek pazaryeri ilanı.	`marketplace:read`	Okuma	Yakında
POST	`/api/v1/marketplace/listings`	İlan Yayınla Aracı pazaryerinde yayınlar.	`marketplace:write`	Yazma	Yakında
DELETE	`/api/v1/marketplace/listings/{listing_id}`	İlanı Kaldır İlanı pazaryerinden kaldırır.	`marketplace:write`	Yıkıcı	Yakında
GET	`/api/v1/marketplace/listings/{listing_id}/offers`	İlan Teklifleri İlana gelen teklifler.	`marketplace:read`	Okuma	Yakında
POST	`/api/v1/marketplace/listings/{listing_id}/offers/{offer_id}/accept`	Teklifi Kabul Et Pazaryeri teklifini kabul eder.	`marketplace:write`	Yazma	Yakında
POST	`/api/v1/marketplace/listings/{listing_id}/offers/{offer_id}/reject`	Teklifi Reddet Pazaryeri teklifini reddeder.	`marketplace:write`	Yazma	Yakında
GET	`/api/v1/marketplace/stats`	Pazaryeri İstatistikleri İlan görüntülenme/teklif istatistikleri.	`marketplace:read`	Okuma	Yakında

Açık Artırma Talepleri

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/auction-requests`	Talep Listesi Açık artırma taleplerini listeler.	`auction-requests:read`	Okuma	Yakında
POST	`/api/v1/auction-requests`	Talep Oluştur Yeni açık artırma talebi oluşturur.	`auction-requests:write`	Yazma	Yakında
GET	`/api/v1/auction-requests/{request_id}`	Talep Detayı Tek talep kaydı.	`auction-requests:read`	Okuma	Yakında
PATCH	`/api/v1/auction-requests/{request_id}`	Talebi Güncelle Talep alanlarını günceller.	`auction-requests:write`	Yazma	Yakında
DELETE	`/api/v1/auction-requests/{request_id}`	Talebi İptal Et Talebi iptal eder.	`auction-requests:write`	Yıkıcı	Yakında

Canlı Açık Artırmalar

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/live-auctions`	Canlı Etkinlik Listesi Aktif/yaklaşan canlı etkinlikleri listeler.	`live-auctions:read`	Okuma	Yakında
GET	`/api/v1/live-auctions/{event_id}`	Etkinlik Detayı Tek canlı etkinlik kaydı.	`live-auctions:read`	Okuma	Yakında
GET	`/api/v1/live-auctions/{event_id}/lots`	Lot Listesi Etkinlikteki lotları listeler.	`live-auctions:read`	Okuma	Yakında
GET	`/api/v1/live-auctions/lots/{lot_id}`	Lot Detayı Tek lot kaydı ve güncel teklif durumu.	`live-auctions:read`	Okuma	Yakında
POST	`/api/v1/live-auctions/lots/{lot_id}/start`	Lotu Başlat Lotu canlıya alır — YALNIZCA özel yetkili entegrasyonlara açılabilir.	`live-auctions:write`	Hassas	Yakında
POST	`/api/v1/live-auctions/lots/{lot_id}/bid`	Teklif Ver Canlı lota teklif verir — YALNIZCA özel yetkili entegrasyonlara açılabilir.	`live-auctions:write`	Hassas	Yakında
POST	`/api/v1/live-auctions/lots/{lot_id}/end`	Lotu Sonlandır Lotu kapatır — YALNIZCA özel yetkili entegrasyonlara açılabilir.	`live-auctions:write`	Hassas	Yakında

Üyelik / Lisans

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/membership`	Üyelik Bilgisi Galerinin güncel üyelik/lisans planı.	`membership:read`	Okuma	Yakında
GET	`/api/v1/membership/usage`	Kullanım Özeti Plan limitlerine göre güncel kullanım.	`membership:read`	Okuma	Yakında
GET	`/api/v1/membership/invoices`	Fatura Listesi Üyelik faturaları.	`membership:read`	Okuma	Yakında

Cüzdan

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/wallet`	Cüzdan Bilgisi Güncel bakiye ve limit bilgisi.	`wallet:read`	Okuma	Yakında
GET	`/api/v1/wallet/transactions`	İşlem Geçmişi Cüzdan işlem geçmişi.	`wallet:read`	Okuma	Yakında
GET	`/api/v1/wallet/transactions/{transaction_id}`	İşlem Detayı Tek cüzdan işlemi.	`wallet:read`	Okuma	Yakında
POST	`/api/v1/wallet/topup-requests`	Bakiye Yükleme Talebi Manuel bakiye yükleme talebi oluşturur (onay Süper Admin'de).	`wallet:write`	Hassas	Yakında
GET	`/api/v1/wallet/topup-requests/{request_id}`	Yükleme Talebi Durumu Yükleme talebinin onay durumu.	`wallet:read`	Okuma	Yakında

Öne Çıkarma

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/boost-orders`	Sipariş Listesi Öne çıkarma siparişlerini listeler.	`boost:read`	Okuma	Yakında
POST	`/api/v1/boost-orders`	Sipariş Oluştur Yeni öne çıkarma siparişi oluşturur.	`boost:write`	Yazma	Yakında
GET	`/api/v1/boost-orders/{order_id}`	Sipariş Detayı Tek öne çıkarma siparişi.	`boost:read`	Okuma	Yakında
DELETE	`/api/v1/boost-orders/{order_id}`	Siparişi İptal Et Aktif olmayan siparişi iptal eder.	`boost:write`	Yıkıcı	Yakında

Bildirimler

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/notifications`	Bildirim Listesi Tenant bildirimlerini listeler.	`notifications:read`	Okuma	Yakında
GET	`/api/v1/notifications/{notification_id}`	Bildirim Detayı Tek bildirim kaydı.	`notifications:read`	Okuma	Yakında
POST	`/api/v1/notifications/{notification_id}/read`	Okundu İşaretle Bildirimi okundu yapar.	`notifications:write`	Yazma	Yakında
POST	`/api/v1/notifications/read-all`	Tümünü Okundu İşaretle Tüm bildirimleri okundu yapar.	`notifications:write`	Yazma	Yakında

Döviz Kurları

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/exchange-rates`	Güncel Kurlar Platformda kullanılan güncel kurlar.	`exchange-rates:read`	Okuma	Yakında
GET	`/api/v1/exchange-rates/history`	Kur Geçmişi Tarihsel kur verisi.	`exchange-rates:read`	Okuma	Yakında
GET	`/api/v1/exchange-rates/{currency_pair}`	Belirli Kur Tek bir kur çiftinin güncel değeri.	`exchange-rates:read`	Okuma	Yakında

Raporlar & Analitik

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/reports/sales-summary`	Satış Özeti Dönemsel satış özeti raporu.	`reports:read`	Okuma	Yakında
GET	`/api/v1/reports/collections-summary`	Tahsilat Özeti Dönemsel tahsilat özeti raporu.	`reports:read`	Okuma	Yakında
GET	`/api/v1/reports/inventory-aging`	Envanter Yaşlandırma Stokta bekleme süresi raporu.	`reports:read`	Okuma	Yakında
GET	`/api/v1/reports/profit-loss`	Kâr/Zarar Raporu Satış bazlı kâr/zarar raporu.	`reports:read`	Hassas	Yakında
GET	`/api/v1/reports/salesperson-performance`	Satışçı Performansı Personel bazlı performans raporu.	`reports:read`	Okuma	Yakında
GET	`/api/v1/reports/overdue-risk`	Gecikme Riski Riskli/geciken müşteri raporu.	`reports:read`	Hassas	Yakında
GET	`/api/v1/reports/marketplace-performance`	Pazaryeri Performansı İlan görüntülenme/dönüşüm raporu.	`reports:read`	Okuma	Yakında
GET	`/api/v1/reports/custom`	Özel Rapor Parametrik özel rapor sorgusu.	`reports:read`	Okuma	Yakında

İçe Aktarma Merkezi

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/import/connectors`	Bağlayıcı Listesi Tanımlı içe aktarma bağlayıcıları (kimlik bilgileri DÖNMEZ).	`import:read`	Okuma	Yakında
POST	`/api/v1/import/connectors`	Bağlayıcı Oluştur Yeni bağlayıcı tanımlar.	`import:write`	Hassas	Yakında
GET	`/api/v1/import/connectors/{connector_id}`	Bağlayıcı Detayı Tek bağlayıcı kaydı (kimlik bilgileri DÖNMEZ).	`import:read`	Okuma	Yakında
PATCH	`/api/v1/import/connectors/{connector_id}`	Bağlayıcı Güncelle Bağlayıcı ayarlarını günceller.	`import:write`	Hassas	Yakında
DELETE	`/api/v1/import/connectors/{connector_id}`	Bağlayıcı Sil Bağlayıcıyı kaldırır.	`import:write`	Yıkıcı	Yakında
POST	`/api/v1/import/connectors/{connector_id}/run`	Senkronizasyonu Başlat Manuel içe aktarma çalıştırır.	`import:write`	Yazma	Yakında
GET	`/api/v1/import/runs`	Çalıştırma Geçmişi Geçmiş içe aktarma çalıştırmaları.	`import:read`	Okuma	Yakında
GET	`/api/v1/import/runs/{run_id}`	Çalıştırma Detayı Tek çalıştırmanın sonucu/hataları.	`import:read`	Okuma	Yakında
GET	`/api/v1/import/runs/{run_id}/errors`	Hata Listesi Çalıştırmadaki satır bazlı hatalar.	`import:read`	Okuma	Yakında

Webhook Yönetimi

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/webhooks`	Webhook Listesi Tanımlı webhook uç noktalarını listeler.	`webhooks:read`	Okuma	Yakında
POST	`/api/v1/webhooks`	Webhook Oluştur Yeni webhook uç noktası tanımlar.	`webhooks:write`	Yazma	Yakında
GET	`/api/v1/webhooks/{webhook_id}`	Webhook Detayı Tek webhook kaydı.	`webhooks:read`	Okuma	Yakında
PATCH	`/api/v1/webhooks/{webhook_id}`	Webhook Güncelle URL/olay aboneliklerini günceller.	`webhooks:write`	Yazma	Yakında
DELETE	`/api/v1/webhooks/{webhook_id}`	Webhook Sil Webhook'u kaldırır.	`webhooks:write`	Yıkıcı	Yakında
POST	`/api/v1/webhooks/{webhook_id}/rotate-secret`	Gizli Anahtarı Yenile İmza gizli anahtarını (secret) yeniler.	`webhooks:write`	Hassas	Yakında
POST	`/api/v1/webhooks/{webhook_id}/test`	Test Gönder Sentetik test.ping olayı gönderir.	`webhooks:write`	Yazma	Yakında
GET	`/api/v1/webhooks/{webhook_id}/deliveries`	Teslimat Listesi Webhook'un gönderim geçmişi.	`webhooks:read`	Okuma	Yakında
GET	`/api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}`	Teslimat Detayı Tek teslimat denemesi/yanıtı.	`webhooks:read`	Okuma	Yakında
POST	`/api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retry`	Yeniden Dene Başarısız teslimatı yeniden gönderir.	`webhooks:write`	Yazma	Yakında

API Kullanımı

Metod	Yol	Ad	Kapsam	Risk	Durum
GET	`/api/v1/developer/usage`	Kullanım İstatistiği Key bazlı istek sayısı/hata oranı.	`developer:read`	Okuma	Aktif
GET	`/api/v1/developer/request-logs`	İstek Günlükleri Son isteklerin log kaydı.	`developer:read`	Okuma	Aktif
GET	`/api/v1/developer/rate-limit`	Rate Limit Durumu Anlık rate limit tüketimi.	`developer:read`	Okuma	Aktif

Hızlı Örnek

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

Ayrıntılı kaynak dokümanları: Araçlar, Müşteriler. Diğer diller için hazır sarmalayıcı kodlar: Kod Örnekleri.