Geliştirici ve entegrasyon

Kendi ERP'nizi, muhasebe programınızı ya da yazılımınızı mağazaya bağlayın. Bu sayfa canlı sistemden üretilir: burada yazan kurallar, API'nin gerçekten uyguladığı kurallardır.

Kimlik doğrulama

Satıcı panelinde API anahtarları bölümünden kapsamlı (yalnız gereken izinlerle) bir anahtar oluşturun. Anahtar yalnız bir kez gösterilir; sunucuda yalnız özeti saklanır.

curl https://doravedora.com/api/v1/manage/products \
  -H "Authorization: Bearer bd_live_..." \
  -H "Content-Type: application/json" \
  -H "Accept-Language: tr" -d @urun.json

Para tutarları ondalık metin ("49.90") olarak, temel para biriminde gönderilir. Dil: Accept-Language, para birimi: X-Currency.

Ürün kuralları (kategori şablonu)

Her kategoride hangi bilginin zorunlu olduğunu kategori sorumlularımız belirler. Panel, API ve toplu yükleme aynı kurala uyar. Göndermeden önce POST /api/v1/manage/products?dryRun=1 ile kaydetmeden doğrulayabilirsiniz.

Kod	Özellik	Tür	Kural	Geçerli değerler
`attr_malzeme`	Malzeme Ürünün ana malzemesi. Kaplama varsa ana gövdenin malzemesini seçin.	tek seçim	· filtre	`bakirseramikporselencamahsapcelik`
`option_renk`	Renk	tek seçim	varyant ekseni· filtre	`lacivertturkuazkirmizibeyazsiyahbakir`
`attr_hacim-ml`	Hacim (ml) Kap ürünlerinde mililitre cinsinden.	sayı	isteğe bağlı	1–100000
`attr_el-yapimi`	El yapımı	true / false	· filtre

Varyantlar: en çok 3 eksen, eksen başına 100 değer, ürün başına 500 varyant. Her varyant tüm eksenlerde bir değer seçer; aynı kombinasyon iki kez olamaz. Barkod (GTIN-8/12/13/14) kontrol basamağıyla doğrulanır. Sözlük değerleri kimlikle ya da herhangi bir dildeki adıyla verilebilir ("lacivert", "Lacivert", "Navy").

Fatura birimleri (UN/ECE Rec 20)

C62 AdetSET TakımPR ÇiftKGM KilogramGRM GramLTR LitreMLT MililitreMTR MetreMTK MetrekareMTQ MetreküpBX KutuPK Paket

Toplu yükleme (CSV / Excel)

Excel'den "CSV (noktalı virgülle ayrılmış)" olarak kaydedebilirsiniz; Türkçe karakterler (Windows-1254) kendiliğinden tanınır.
Her satır bir varyanttır. Aynı product_key değerine sahip satırlar tek ürünün varyantlarıdır.
Aynı product_key ile yeniden yükleme yeni ürün açmaz; mevcut ürünü günceller, yeni SKU'yu varyant olarak ekler.
Önce deneme modunda yükleyin: hiçbir şey kaydedilmez, satır numaralı hata raporu alırsınız.
images sütunu: | ile ayrılmış https adresleri. Görseller indirilir, denetlenir ve yeniden kodlanır (en az 500 px).
Sabit para birimi fiyatı için price_TRY, price_USD gibi sütunlar ekleyin.

İstek sınırları

Kapsam	Yol	Sınır
Sipariş oluşturma	`POST /api/v1/checkout/orders`	600 sn'de 10
Destek talebi açma	`POST /api/v1/support/tickets`	saatte 20
Üye kaydı	`POST /api/v1/auth/register`	600 sn'de 5
Giriş denemeleri	`POST /api/v1/auth/login`	dakikada 10
Arama ve listeleme	`GET /api/v1/products`	dakikada 240
Yönetim API'si	`/api/v1/admin/`	dakikada 600
Reklam tıklamaları	`GET /api/v1/ads/c/`	dakikada 60
Besleme indirme	`GET /api/v1/feeds/`	dakikada 30
Görsel yükleme	`POST /api/v1/media`	dakikada 120
Yapay zekâ	`/api/v1/ai/`	dakikada 30
İzleme olayları	`POST /api/v1/t/`	dakikada 120
Genel API	`/api/v1/`	dakikada 600

Sınır aşılınca 429 döner; Retry-After başlığındaki süre kadar bekleyin. Yanıtta RateLimit-Policy başlığı geçerli kuralı gösterir.

Hata biçimi

{ "error": { "code": "attributes_invalid", "message": "...",
  "details": { "issues": [ { "field": "attributes.malzeme", "message": "Zorunlu: Malzeme" },
                           { "field": "variants.0.gtin", "message": "Barkod (GTIN) kontrol basamağı hatalı" } ] } } }

Doğrulama hatalarının hepsi tek yanıtta döner.

Uçlar

Makine okunur sözleşme: /api/v1/openapi.json (OpenAPI 3.1 — istemci kodunu buradan üretebilirsiniz).

Dil ve para birimi

GET /api/v1/localization Aktif diller, para birimleri ve oturumdaki seçim
GET /api/v1/localization/price Temel para birimindeki tutarı gösterim para birimine çevir

Kimlik

POST /api/v1/auth/login Giriş yap
GET /api/v1/auth/me Oturumdaki kullanıcı· anahtar gerekir
POST /api/v1/api-keys API anahtarı oluştur

Organizasyon

POST /api/v1/admin/users Personel hesabı aç· anahtar gerekir

Katalog

GET /api/v1/products Ürün listesi (vitrin)
GET /api/v1/products/{slug} Ürün detayı (dile göre adres)

Katalog yönetimi

POST /api/v1/manage/products Ürün oluştur· anahtar gerekir
PATCH /api/v1/manage/products/{id} Ürünü güncelle· anahtar gerekir

Yapay zekâ

POST /api/v1/ai/product-draft Tariften çok dilli ürün taslağı· anahtar gerekir

Destek

POST /api/v1/support/tickets Destek talebi aç· anahtar gerekir