Ürünler

Ürünü güncelle

PATCH
/v1/urunler/{id}

Yalnız gönderilen alanlar değişir. Fiyat, stok ve stok kodu için varyant uçlarını kullanın.

Kimlik doğrulama

anahtar
headerKimlik doğrulamaBearer <anahtar>

Panel → Ayarlar → API anahtarları (mk_canli_…). Denemek için paylaşılan test mağazası: mk_test_… anahtarları yalnız orada; herkese açık deneme anahtarı silme yapamaz, IP başına dakikada 60 istek; mağaza her gece 03.00'te (TSİ) baştan kurulur.

Yol parametreleri

id*string

Başlık parametreleri

Idempotency-Key?string

Aynı anahtar ve aynı istek 24 saat içinde tekrar gelirse iş yeniden yapılmaz, ilk yanıt döner. Ağ hatasında güvenle yeniden denemek için.

Uzunluklength <= 255

İstek gövdesi

application/json
  1. body
ad?string
Uzunluk1 <= length <= 300
aciklama?string
Uzunluklength <= 100000
durum?string
Değerlerden biri"yayinda""taslak"
tanitici?string
Uzunluklength <= 200
kategoriler?array<string>

Verilirse listenin tamamı (eskiler çıkar)

Ögeleritems <= 50
etiketler?array<>

Verilirse listenin tamamı

Ögeleritems <= 50
marka_id?string|null
seo?
gorseller?array<>

Verilirse görsellerin tamamı ve sırası; mevcut adresler korunur

Ögeleritems <= 30

Yanıt gövdesi

Başarılı

application/json
  1. response
id*string
ad*string
tanitici*string

Adresteki kısa ad (/urun/)

durum*string
Değerlerden biri"yayinda""taslak"
adres*string

Vitrindeki adresi

alt_baslik*string|null
aciklama*|

HTML

tur*string|null
marka_id*string|null
koleksiyon_id*string|null
kategoriler*array<string>

Kategori kimlikleri

etiketler*array<string>
kapak*string|null
gorseller*array<>
secenekler*array<>
varyantlar*array<>
olcu*

Kargo ölçüleri (cm)

malzeme*string|null
mense*string|null
seo*
ozel*

Özel alanların değerleri (alan kodu → değer)

olusturma*string

ISO 8601, UTC

guncelleme*string

ISO 8601, UTC

Örnek istek
curl -X PATCH 'https://api.multikolay.com/v1/urunler/string' \  -H 'Content-Type: application/json' \  -d '{}'
Örnek yanıt
{  "id": "string",  "ad": "string",  "tanitici": "string",  "durum": "yayinda",  "adres": "string",  "alt_baslik": "string",  "aciklama": "string",  "tur": "string",  "marka_id": "string",  "koleksiyon_id": "string",  "kategoriler": [    "string"  ],  "etiketler": [    "string"  ],  "kapak": "string",  "gorseller": [    {      "id": "string",      "url": "string",      "sira": 0    }  ],  "secenekler": [    {      "id": "string",      "ad": "string",      "degerler": [        "string"      ]    }  ],  "varyantlar": [    {      "id": "string",      "ad": "string",      "sku": "string",      "barkod": "string",      "secenekler": {        "property1": "string",        "property2": "string"      },      "fiyat": 0,      "indirimsiz_fiyat": 0,      "fiyatlar": [        {          "para_birimi": "string",          "tutar": 0,          "indirimsiz_tutar": 0        }      ],      "kdv_orani": 0,      "stok_takibi": true,      "eksi_stok": true,      "stok": 0,      "sira": 0    }  ],  "olcu": {    "agirlik": 0,    "en": 0,    "boy": 0,    "yukseklik": 0  },  "malzeme": "string",  "mense": "string",  "seo": {    "baslik": "string",    "aciklama": "string",    "gizle": true  },  "ozel": {    "property1": null,    "property2": null  },  "olusturma": "string",  "guncelleme": "string"}