Ürün oluştur
Ürünü seçenekleri, varyantları, fiyat ve stoğuyla tek istekte açar. Görsel adresleri indirilip mağazanın medyasına alınır. Aynı ürünü iki kez açmamak için Idempotency-Key gönderin.
anahtarKimlik 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.
Idempotency-Key?stringAynı 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.
length <= 255application/json- body
ad*string1 <= length <= 300aciklama?stringHTML (zararlı etiketler temizlenir)
length <= 100000durum?string"taslak""yayinda""taslak"tanitici?stringAdresteki kısa ad; boşsa addan üretilir
length <= 200kategoriler?array<string>items <= 50etiketler?array<>items <= 50marka_id?string|nullseo?gorseller?array<>Sıralı görsel adresleri, ilki kapak. Dış adresler indirilip mağazanın medyasına alınır (JPEG, PNG, WebP; en çok 10 MB).
items <= 30secenekler?array<>Renk, Beden… Boşsa tek varyantlı ürün
items <= 3varyantlar*array<>Seçenekli üründe her kombinasyon bir kez
1 <= items <= 100Oluşturuldu
application/json- response
id*stringad*stringtanitici*stringAdresteki kısa ad (/urun/)
durum*string"yayinda""taslak"adres*stringVitrindeki adresi
alt_baslik*string|nullaciklama*|HTML
tur*string|nullmarka_id*string|nullkoleksiyon_id*string|nullkategoriler*array<string>Kategori kimlikleri
etiketler*array<string>kapak*string|nullgorseller*array<>secenekler*array<>varyantlar*array<>olcu*Kargo ölçüleri (cm)
malzeme*string|nullmense*string|nullseo*ozel*Özel alanların değerleri (alan kodu → değer)
olusturma*stringISO 8601, UTC
guncelleme*stringISO 8601, UTC
curl -X POST 'https://api.multikolay.com/v1/urunler' \ -H 'Content-Type: application/json' \ -d '{ "ad": "string", "varyantlar": [ {} ]}'{ "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"}