{"openapi":"3.1.0","info":{"title":"MultiKolay API","version":"1.0.0","description":"MultiKolay mağazalarının açık API'si. Ayrıntı: https://docs.multikolay.com"},"servers":[{"url":"https://api.multikolay.com"}],"components":{"securitySchemes":{"anahtar":{"type":"http","scheme":"bearer","description":"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."}},"schemas":{"Magaza":{"type":"object","properties":{"id":{"description":"Mağaza kodu","example":"ornekmagaza","type":"string"},"ad":{"example":"Örnek Mağaza","type":"string"},"adres":{"description":"Vitrinin genel adresi","example":"https://www.ornekmagaza.com","type":"string"},"para_birimi":{"example":"TRY","type":"string"},"dil":{"example":"tr-TR","type":"string"},"plan":{"description":"Paket: temel, plus, pro","example":"plus","type":"string"},"anahtar":{"type":"object","properties":{"test":{"description":"Test anahtarı mı (mk_test_)","type":"boolean"},"kapsamlar":{"type":"array","items":{"type":"string","enum":["urun:okuma","urun:yazma","stok:okuma","stok:yazma","fiyat:okuma","fiyat:yazma","siparis:okuma","siparis:yazma","musteri:okuma","musteri:yazma","kampanya:okuma","kampanya:yazma","icerik:okuma","icerik:yazma","webhook:yonet"]}}},"required":["test","kapsamlar"],"additionalProperties":false},"sunucu_saati":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","adres","para_birimi","dil","plan","anahtar","sunucu_saati"],"additionalProperties":false},"Hata":{"type":"object","properties":{"hata":{"type":"object","properties":{"kod":{"example":"anahtar_gecersiz","type":"string"},"mesaj":{"example":"API anahtarı geçersiz ya da iptal edilmiş.","type":"string"}},"required":["kod","mesaj"],"additionalProperties":false}},"required":["hata"],"additionalProperties":false},"Urun":{"type":"object","properties":{"id":{"example":"urun_01JA7Z3M4K","type":"string"},"ad":{"example":"Meşe Bar Taburesi","type":"string"},"tanitici":{"description":"Adresteki kısa ad (/urun/<tanitici>)","example":"mese-bar-taburesi","type":"string"},"durum":{"type":"string","enum":["yayinda","taslak"]},"adres":{"description":"Vitrindeki adresi","type":"string"},"alt_baslik":{"anyOf":[{"type":"string"},{"type":"null"}]},"aciklama":{"description":"HTML","anyOf":[{"type":"string"},{"type":"null"}]},"tur":{"anyOf":[{"type":"string"},{"type":"null"}]},"marka_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"koleksiyon_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"kategoriler":{"description":"Kategori kimlikleri","type":"array","items":{"type":"string"}},"etiketler":{"type":"array","items":{"type":"string"}},"kapak":{"anyOf":[{"type":"string"},{"type":"null"}]},"gorseller":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"sira":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","url","sira"],"additionalProperties":false}},"secenekler":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"ad":{"type":"string"},"degerler":{"type":"array","items":{"type":"string"}}},"required":["id","ad","degerler"],"additionalProperties":false}},"varyantlar":{"type":"array","items":{"$ref":"#/components/schemas/Varyant"}},"olcu":{"description":"Kargo ölçüleri (cm)","type":"object","properties":{"agirlik":{"description":"gram","anyOf":[{"type":"number"},{"type":"null"}]},"en":{"anyOf":[{"type":"number"},{"type":"null"}]},"boy":{"anyOf":[{"type":"number"},{"type":"null"}]},"yukseklik":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["agirlik","en","boy","yukseklik"],"additionalProperties":false},"malzeme":{"anyOf":[{"type":"string"},{"type":"null"}]},"mense":{"anyOf":[{"type":"string"},{"type":"null"}]},"seo":{"type":"object","properties":{"baslik":{"anyOf":[{"type":"string"},{"type":"null"}]},"aciklama":{"anyOf":[{"type":"string"},{"type":"null"}]},"gizle":{"type":"boolean"}},"required":["baslik","aciklama","gizle"],"additionalProperties":false},"ozel":{"description":"Özel alanların değerleri (alan kodu → değer)","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","tanitici","durum","adres","alt_baslik","aciklama","tur","marka_id","koleksiyon_id","kategoriler","etiketler","kapak","gorseller","secenekler","varyantlar","olcu","malzeme","mense","seo","ozel","olusturma","guncelleme"],"additionalProperties":false},"Varyant":{"type":"object","properties":{"id":{"example":"var_01JA7Z3M5P","type":"string"},"ad":{"example":"Siyah / 65 cm","type":"string"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}]},"barkod":{"anyOf":[{"type":"string"},{"type":"null"}]},"secenekler":{"description":"Seçenek adı → değer","example":{"Renk":"Siyah","Boy":"65 cm"},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"fiyat":{"description":"Mağazanın ana para biriminde satış fiyatı","anyOf":[{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"indirimsiz_fiyat":{"anyOf":[{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"fiyatlar":{"type":"array","items":{"type":"object","properties":{"para_birimi":{"example":"TRY","type":"string"},"tutar":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"indirimsiz_tutar":{"description":"Doluysa üstü çizili gösterilen fiyat","anyOf":[{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["para_birimi","tutar","indirimsiz_tutar"],"additionalProperties":false}},"kdv_orani":{"description":"Boşsa mağazanın varsayılanı","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"stok_takibi":{"type":"boolean"},"eksi_stok":{"description":"Stok bitince de satılır","type":"boolean"},"stok":{"description":"Satılabilir adet (bütün depolar, ayrılanlar düşülmüş)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sira":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","ad","sku","barkod","secenekler","fiyat","indirimsiz_fiyat","fiyatlar","kdv_orani","stok_takibi","eksi_stok","stok","sira"],"additionalProperties":false},"Kategori":{"type":"object","properties":{"id":{"type":"string"},"ad":{"type":"string"},"tanitici":{"type":"string"},"aciklama":{"type":"string"},"ust_id":{"description":"Üst kategori; kökte null","anyOf":[{"type":"string"},{"type":"null"}]},"aktif":{"type":"boolean"},"dahili":{"description":"Vitrinde görünmez (iç gruplama)","type":"boolean"},"sira":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"adres":{"type":"string"},"urun_sayisi":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","tanitici","aciklama","ust_id","aktif","dahili","sira","adres","urun_sayisi","olusturma","guncelleme"],"additionalProperties":false},"Koleksiyon":{"type":"object","properties":{"id":{"type":"string"},"ad":{"type":"string"},"tanitici":{"type":"string"},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","tanitici","olusturma","guncelleme"],"additionalProperties":false},"Marka":{"type":"object","properties":{"id":{"type":"string"},"ad":{"type":"string"},"tanitici":{"type":"string"},"aciklama":{"type":"string"},"logo":{"anyOf":[{"type":"string"},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","tanitici","aciklama","logo","olusturma","guncelleme"],"additionalProperties":false},"Depo":{"type":"object","properties":{"id":{"type":"string"},"ad":{"type":"string"},"varsayilan":{"type":"boolean"},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","varsayilan","olusturma"],"additionalProperties":false},"Stok":{"type":"object","properties":{"varyant_id":{"type":"string"},"urun_id":{"type":"string"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}]},"stok_takibi":{"type":"boolean"},"eksi_stok":{"type":"boolean"},"satilabilir":{"description":"Bütün depolarda, ayrılanlar düşülmüş","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"depolar":{"type":"array","items":{"type":"object","properties":{"depo_id":{"type":"string"},"miktar":{"description":"Depodaki adet","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ayrilan":{"description":"Ödemesi süren sepetlere ve hazırlanan siparişlere ayrılan","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["depo_id","miktar","ayrilan"],"additionalProperties":false}},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["varyant_id","urun_id","sku","stok_takibi","eksi_stok","satilabilir","depolar","guncelleme"],"additionalProperties":false},"FiyatListesi":{"type":"object","properties":{"id":{"type":"string"},"ad":{"type":"string"},"aciklama":{"type":"string"},"durum":{"type":"string","enum":["aktif","taslak"]},"baslangic":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"bitis":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"musteri_gruplari":{"description":"Boşsa herkese","type":"array","items":{"type":"string"}},"fiyatlar":{"type":"array","items":{"type":"object","properties":{"varyant_id":{"type":"string"},"para_birimi":{"type":"string"},"tutar":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["varyant_id","para_birimi","tutar"],"additionalProperties":false}},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","aciklama","durum","baslangic","bitis","musteri_gruplari","fiyatlar","olusturma","guncelleme"],"additionalProperties":false},"UrunOlusturGirdisi":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":300},"aciklama":{"description":"HTML (zararlı etiketler temizlenir)","type":"string","maxLength":100000},"durum":{"default":"taslak","type":"string","enum":["yayinda","taslak"]},"tanitici":{"description":"Adresteki kısa ad; boşsa addan üretilir","type":"string","maxLength":200},"kategoriler":{"maxItems":50,"type":"array","items":{"type":"string"}},"etiketler":{"maxItems":50,"type":"array","items":{"type":"string","maxLength":100}},"marka_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"seo":{"type":"object","properties":{"baslik":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"aciklama":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"gizle":{"description":"Arama motorlarından gizle (noindex)","type":"boolean"}}},"gorseller":{"description":"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).","maxItems":30,"type":"array","items":{"type":"string","format":"uri"}},"secenekler":{"description":"Renk, Beden… Boşsa tek varyantlı ürün","maxItems":3,"type":"array","items":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":60},"degerler":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["ad","degerler"]}},"varyantlar":{"description":"Seçenekli üründe her kombinasyon bir kez","minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"secenekler":{"description":"Seçenek adı → değer; seçeneksiz üründe boş","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"sku":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"barkod":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"fiyat":{"description":"Kuruş, KDV dahil. Yayındaki üründe zorunlu.","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"indirimsiz_fiyat":{"description":"Üstü çizili fiyat; fiyattan büyük olmalı","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"stok":{"description":"Varsayılan depodaki adet; null = stok takibi yok (sınırsız satılır)","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}}}}},"required":["ad","varyantlar"]},"UrunGuncelleGirdisi":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":300},"aciklama":{"type":"string","maxLength":100000},"durum":{"type":"string","enum":["yayinda","taslak"]},"tanitici":{"type":"string","maxLength":200},"kategoriler":{"description":"Verilirse listenin tamamı (eskiler çıkar)","maxItems":50,"type":"array","items":{"type":"string"}},"etiketler":{"description":"Verilirse listenin tamamı","maxItems":50,"type":"array","items":{"type":"string","maxLength":100}},"marka_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"seo":{"type":"object","properties":{"baslik":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"aciklama":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"gizle":{"description":"Arama motorlarından gizle (noindex)","type":"boolean"}}},"gorseller":{"description":"Verilirse görsellerin tamamı ve sırası; mevcut adresler korunur","maxItems":30,"type":"array","items":{"type":"string","format":"uri"}}}},"VaryantGuncelleGirdisi":{"type":"object","properties":{"sku":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"barkod":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"fiyat":{"description":"Kuruş, KDV dahil. Yayındaki üründe zorunlu.","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"indirimsiz_fiyat":{"description":"Üstü çizili fiyat; fiyattan büyük olmalı","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"stok":{"description":"Varsayılan depodaki adet; null = stok takibi yok (sınırsız satılır)","anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}}},"TopluStokGirdisi":{"type":"object","properties":{"kalemler":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"varyant_id":{"type":"string"},"sku":{"type":"string"},"miktar":{"description":"Depodaki yeni adet (fark değil)","type":"integer","minimum":0,"maximum":9007199254740991},"depo_id":{"description":"Boşsa varsayılan depo","type":"string"}},"required":["miktar"]}}},"required":["kalemler"]},"TopluFiyatGirdisi":{"type":"object","properties":{"kalemler":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"varyant_id":{"type":"string"},"sku":{"type":"string"},"fiyat":{"type":"integer","minimum":0,"maximum":9007199254740991},"indirimsiz_fiyat":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"para_birimi":{"description":"Boşsa ürünün kaynak para birimi (MultiKur: diğerleri kurla hesaplanır)","type":"string","minLength":3,"maxLength":3}},"required":["fiyat"]}}},"required":["kalemler"]},"KategoriGirdisi":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"tanitici":{"type":"string","maxLength":200},"aciklama":{"type":"string","maxLength":5000},"ust_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"sira":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"aktif":{"type":"boolean"},"dahili":{"type":"boolean"}},"required":["ad"]},"Siparis":{"type":"object","properties":{"id":{"example":"order_01JA8K2Q","type":"string"},"no":{"description":"Müşterinin gördüğü numara","example":"10482","type":"string"},"durum":{"type":"string","enum":["odeme_bekliyor","hazirlaniyor","kargoda","teslim_edildi","iptal","iade"]},"para_birimi":{"example":"TRY","type":"string"},"urun_toplam":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"indirim_toplam":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"kargo_toplam":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"toplam":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"odenen":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"iade_edilen":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"indirim_kodlari":{"type":"array","items":{"type":"string"}},"musteri":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"eposta":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","eposta"],"additionalProperties":false},"teslimat_adresi":{"anyOf":[{"$ref":"#/components/schemas/Adres"},{"type":"null"}]},"fatura_adresi":{"anyOf":[{"$ref":"#/components/schemas/Adres"},{"type":"null"}]},"kalemler":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"urun_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"varyant_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"ad":{"type":"string"},"varyant_ad":{"anyOf":[{"type":"string"},{"type":"null"}]},"sku":{"anyOf":[{"type":"string"},{"type":"null"}]},"adet":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"birim_fiyat":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"indirim":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"toplam":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"kdv_orani":{"type":"number"},"gonderilen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"teslim_edilen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"iade_edilen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","urun_id","varyant_id","ad","varyant_ad","sku","adet","birim_fiyat","indirim","toplam","kdv_orani","gonderilen","teslim_edilen","iade_edilen"],"additionalProperties":false}},"odemeler":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"yontem":{"type":"string","enum":["kart","havale","kapida_nakit","kapida_kart","diger"]},"saglayici":{"type":"string"},"durum":{"description":"yetkilendi, tahsil_edildi, iptal…","type":"string"},"tutar":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","yontem","saglayici","durum","tutar","olusturma"],"additionalProperties":false}},"gonderiler":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"firma":{"anyOf":[{"type":"string"},{"type":"null"}]},"takip_no":{"anyOf":[{"type":"string"},{"type":"null"}]},"takip_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"durum":{"type":"string","enum":["hazirlaniyor","kargoda","teslim_edildi","iptal","hata"]},"kalemler":{"type":"array","items":{"type":"object","properties":{"kalem_id":{"type":"string"},"adet":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["kalem_id","adet"],"additionalProperties":false}},"sevk":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"teslim":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","firma","takip_no","takip_url","durum","kalemler","sevk","teslim","olusturma"],"additionalProperties":false}},"kaynak":{"description":"vitrin, panel (taslak sipariş), aktarim…","type":"string"},"iptal":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","no","durum","para_birimi","urun_toplam","indirim_toplam","kargo_toplam","toplam","odenen","iade_edilen","indirim_kodlari","musteri","teslimat_adresi","fatura_adresi","kalemler","odemeler","gonderiler","kaynak","iptal","olusturma","guncelleme"],"additionalProperties":false},"Adres":{"type":"object","properties":{"ad":{"anyOf":[{"type":"string"},{"type":"null"}]},"soyad":{"anyOf":[{"type":"string"},{"type":"null"}]},"sirket":{"anyOf":[{"type":"string"},{"type":"null"}]},"telefon":{"anyOf":[{"type":"string"},{"type":"null"}]},"satir1":{"anyOf":[{"type":"string"},{"type":"null"}]},"satir2":{"anyOf":[{"type":"string"},{"type":"null"}]},"ilce":{"anyOf":[{"type":"string"},{"type":"null"}]},"il":{"anyOf":[{"type":"string"},{"type":"null"}]},"posta_kodu":{"anyOf":[{"type":"string"},{"type":"null"}]},"ulke":{"anyOf":[{"type":"string"},{"type":"null"}]},"fatura_tipi":{"anyOf":[{"type":"string","enum":["bireysel","kurumsal"]},{"type":"null"}]},"tckn":{"description":"Bireysel fatura","anyOf":[{"type":"string"},{"type":"null"}]},"vergi_no":{"description":"Kurumsal fatura (VKN)","anyOf":[{"type":"string"},{"type":"null"}]},"vergi_dairesi":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["ad","soyad","sirket","telefon","satir1","satir2","ilce","il","posta_kodu","ulke","fatura_tipi","tckn","vergi_no","vergi_dairesi"],"additionalProperties":false},"Iade":{"type":"object","properties":{"id":{"type":"string"},"siparis_id":{"type":"string"},"kalemler":{"type":"array","items":{"type":"object","properties":{"kalem_id":{"type":"string"},"adet":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deger":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["kalem_id","adet","deger"],"additionalProperties":false}},"deger":{"description":"Geri gelen ürünlerin indirimli toplam değeri","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tutar":{"description":"Müşteriye iade edilen para (0 = para iadesi yok)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"stoka_geri":{"type":"boolean"},"neden":{"type":"string"},"degisim_siparis_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","siparis_id","kalemler","deger","tutar","stoka_geri","neden","degisim_siparis_id","olusturma"],"additionalProperties":false},"Musteri":{"type":"object","properties":{"id":{"type":"string"},"eposta":{"type":"string"},"ad":{"anyOf":[{"type":"string"},{"type":"null"}]},"soyad":{"anyOf":[{"type":"string"},{"type":"null"}]},"telefon":{"anyOf":[{"type":"string"},{"type":"null"}]},"sirket":{"anyOf":[{"type":"string"},{"type":"null"}]},"hesap":{"description":"Şifreyle üye mi (false: yalnız misafir siparişi)","type":"boolean"},"izinler":{"type":"object","properties":{"eposta":{"description":"Ticari elektronik ileti (e-posta) onayı","type":"boolean"},"sms":{"type":"boolean"}},"required":["eposta","sms"],"additionalProperties":false},"gruplar":{"type":"array","items":{"type":"string"}},"adresler":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"ad":{"anyOf":[{"type":"string"},{"type":"null"}]},"soyad":{"anyOf":[{"type":"string"},{"type":"null"}]},"sirket":{"anyOf":[{"type":"string"},{"type":"null"}]},"telefon":{"anyOf":[{"type":"string"},{"type":"null"}]},"satir1":{"anyOf":[{"type":"string"},{"type":"null"}]},"satir2":{"anyOf":[{"type":"string"},{"type":"null"}]},"ilce":{"anyOf":[{"type":"string"},{"type":"null"}]},"il":{"anyOf":[{"type":"string"},{"type":"null"}]},"posta_kodu":{"anyOf":[{"type":"string"},{"type":"null"}]},"ulke":{"anyOf":[{"type":"string"},{"type":"null"}]},"varsayilan_teslimat":{"type":"boolean"},"varsayilan_fatura":{"type":"boolean"}},"required":["id","ad","soyad","sirket","telefon","satir1","satir2","ilce","il","posta_kodu","ulke","varsayilan_teslimat","varsayilan_fatura"],"additionalProperties":false}},"ozel":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","eposta","ad","soyad","telefon","sirket","hesap","izinler","gruplar","adresler","ozel","olusturma","guncelleme"],"additionalProperties":false},"MusteriGrubu":{"type":"object","properties":{"id":{"type":"string"},"ad":{"type":"string"},"uye_sayisi":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","uye_sayisi","olusturma","guncelleme"],"additionalProperties":false},"Kampanya":{"type":"object","properties":{"id":{"type":"string"},"ad":{"type":"string"},"tur":{"type":"string","enum":["indirim","x_al_y_ode","kargo_bedava","ikinciye_indirim"]},"kod":{"description":"İndirim kodu (otomatik kampanyada iç kod)","type":"string"},"otomatik":{"description":"Kod girilmeden sepete uygulanır","type":"boolean"},"aktif":{"type":"boolean"},"indirim_tipi":{"type":"string","enum":["yuzde","tutar"]},"deger":{"description":"Yüzde (ör. 15) ya da kuruş tutar","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"al":{"description":"x_al_y_ode: kaç alınca","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"ode":{"description":"x_al_y_ode: kaç ödenir","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"kapsam":{"type":"string","enum":["tumu","urunler","kategoriler"]},"hedefler":{"description":"Kapsam ürün ya da kategoriyse kimlikleri","type":"array","items":{"type":"string"}},"min_sepet":{"anyOf":[{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"para_birimi":{"type":"string"},"musteri_eposta":{"description":"Yalnız bu müşteriye özel kod","anyOf":[{"type":"string"},{"type":"null"}]},"kullanim_siniri":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"kullanim":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"toplam_indirim":{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"baslangic":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"bitis":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","ad","tur","kod","otomatik","aktif","indirim_tipi","deger","al","ode","kapsam","hedefler","min_sepet","para_birimi","musteri_eposta","kullanim_siniri","kullanim","toplam_indirim","baslangic","bitis","olusturma","guncelleme"],"additionalProperties":false},"Sayfa":{"type":"object","properties":{"id":{"type":"string"},"baslik":{"type":"string"},"tanitici":{"type":"string"},"tur":{"description":"sayfa, yasal…","type":"string"},"yasal_tur":{"description":"Yasal sayfada türü (mesafeli satış, KVKK…)","anyOf":[{"type":"string"},{"type":"null"}]},"yayinda":{"type":"boolean"},"adres":{"type":"string"},"ozet":{"anyOf":[{"type":"string"},{"type":"null"}]},"govde":{"description":"HTML (bölümlerle kurulan sayfada boş olabilir)","anyOf":[{"type":"string"},{"type":"null"}]},"seo":{"type":"object","properties":{"baslik":{"anyOf":[{"type":"string"},{"type":"null"}]},"aciklama":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["baslik","aciklama"],"additionalProperties":false},"ozel":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"yayin":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","baslik","tanitici","tur","yasal_tur","yayinda","adres","ozet","govde","seo","ozel","yayin","olusturma","guncelleme"],"additionalProperties":false},"__schema0":{"type":"object","properties":{"id":{"type":"string"},"type":{"description":"category, collection, product, page, url, none","type":"string"},"label":{"description":"Boşsa bağlı kaydın adı gösterilir","anyOf":[{"type":"string"},{"type":"null"}]},"target_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"children":{"type":"array","items":{"$ref":"#/components/schemas/__schema0"}}},"required":["type"],"additionalProperties":{}},"Menu":{"type":"object","properties":{"tanitici":{"type":"string","enum":["header","footer"]},"ogeler":{"type":"array","items":{"$ref":"#/components/schemas/__schema0"}},"guncelleme":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]}},"required":["tanitici","ogeler","guncelleme"],"additionalProperties":false},"KargoyaVerGirdisi":{"type":"object","properties":{"yol":{"description":"elle: takip numarasını siz verirsiniz. uygulama: mağazada açık kargo uygulamasıyla (Yurtiçi, Aras, DHL…) gönderi açılır.","default":"elle","type":"string","enum":["elle","uygulama"]},"firma":{"description":"elle: firma adı (ör. \"Yurtiçi Kargo\"); uygulama: uygulama kimliği (ör. \"yurtici\")","type":"string","minLength":1,"maxLength":80},"takip_no":{"type":"string","maxLength":80},"takip_url":{"type":"string","format":"uri"},"musteriye_bildir":{"description":"\"Kargoya verildi\" e-postası gitsin mi","default":true,"type":"boolean"},"desi":{"type":"number","exclusiveMinimum":0},"kg":{"type":"number","exclusiveMinimum":0},"paket_adedi":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["firma"]},"MusteriOlusturGirdisi":{"type":"object","properties":{"eposta":{"type":"string","maxLength":200,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"ad":{"type":"string","maxLength":100},"soyad":{"type":"string","maxLength":100},"telefon":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}]},"sirket":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"izinler":{"description":"Ticari elektronik ileti onayı. Yalnız müşteriden gerçekten alınmış onayı gönderin; kaynağı \"api\" diye kaydedilir.","type":"object","properties":{"eposta":{"type":"boolean"},"sms":{"type":"boolean"}},"required":["eposta","sms"]},"gruplar":{"description":"Verilirse grupların tamamı","maxItems":50,"type":"array","items":{"type":"string"}}},"required":["eposta"]},"MusteriGuncelleGirdisi":{"type":"object","properties":{"ad":{"type":"string","maxLength":100},"soyad":{"type":"string","maxLength":100},"telefon":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}]},"sirket":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"izinler":{"description":"Ticari elektronik ileti onayı. Yalnız müşteriden gerçekten alınmış onayı gönderin; kaynağı \"api\" diye kaydedilir.","type":"object","properties":{"eposta":{"type":"boolean"},"sms":{"type":"boolean"}},"required":["eposta","sms"]},"gruplar":{"description":"Verilirse grupların tamamı","maxItems":50,"type":"array","items":{"type":"string"}}}},"KampanyaOlusturGirdisi":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"tur":{"type":"string","enum":["indirim","x_al_y_ode","kargo_bedava","ikinciye_indirim"]},"kod":{"description":"Büyük harf, rakam, - ve _. Boş/null: kodsuz, sepete kendiliğinden uygulanır","anyOf":[{"type":"string","maxLength":50},{"type":"null"}]},"indirim_tipi":{"default":"yuzde","type":"string","enum":["yuzde","tutar"]},"deger":{"default":0,"description":"indirim: yüzde (1–100) ya da kuruş; ikinciye_indirim: yüzde","type":"integer","minimum":0,"maximum":9007199254740991},"al":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"ode":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"kapsam":{"default":"tumu","type":"string","enum":["tumu","urunler","kategoriler"]},"hedefler":{"description":"Kapsam ürün ya da kategoriyse kimlikleri","maxItems":500,"type":"array","items":{"type":"string"}},"min_sepet":{"anyOf":[{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"baslangic":{"anyOf":[{"type":"string"},{"type":"null"}]},"bitis":{"anyOf":[{"type":"string"},{"type":"null"}]},"kullanim_siniri":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"musteri_eposta":{"anyOf":[{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"aktif":{"default":true,"type":"boolean"}},"required":["ad","tur"]},"KampanyaGuncelleGirdisi":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"kod":{"description":"Büyük harf, rakam, - ve _. Boş/null: kodsuz, sepete kendiliğinden uygulanır","anyOf":[{"type":"string","maxLength":50},{"type":"null"}]},"indirim_tipi":{"type":"string","enum":["yuzde","tutar"]},"deger":{"description":"indirim: yüzde (1–100) ya da kuruş; ikinciye_indirim: yüzde","type":"integer","minimum":0,"maximum":9007199254740991},"al":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"ode":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"kapsam":{"type":"string","enum":["tumu","urunler","kategoriler"]},"hedefler":{"description":"Kapsam ürün ya da kategoriyse kimlikleri","maxItems":500,"type":"array","items":{"type":"string"}},"min_sepet":{"anyOf":[{"description":"Kuruş, KDV dahil (184990 = 1.849,90 ₺)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"baslangic":{"anyOf":[{"type":"string"},{"type":"null"}]},"bitis":{"anyOf":[{"type":"string"},{"type":"null"}]},"kullanim_siniri":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"musteri_eposta":{"anyOf":[{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"aktif":{"type":"boolean"}}},"FiyatListesiGirdisi":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"aciklama":{"type":"string","maxLength":1000},"durum":{"type":"string","enum":["aktif","taslak"]},"baslangic":{"anyOf":[{"type":"string"},{"type":"null"}]},"bitis":{"anyOf":[{"type":"string"},{"type":"null"}]},"musteri_gruplari":{"description":"Boş liste: herkese","maxItems":50,"type":"array","items":{"type":"string"}}},"required":["ad"]},"FiyatListesiGuncelleGirdisi":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"aciklama":{"type":"string","maxLength":1000},"durum":{"type":"string","enum":["aktif","taslak"]},"baslangic":{"anyOf":[{"type":"string"},{"type":"null"}]},"bitis":{"anyOf":[{"type":"string"},{"type":"null"}]},"musteri_gruplari":{"description":"Boş liste: herkese","maxItems":50,"type":"array","items":{"type":"string"}}}},"FiyatListesiFiyatlari":{"type":"object","properties":{"fiyatlar":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"varyant_id":{"type":"string"},"para_birimi":{"default":"TRY","type":"string","minLength":3,"maxLength":3},"tutar":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["varyant_id","tutar"]}}},"required":["fiyatlar"]},"MenuGirdisi":{"type":"object","properties":{"ogeler":{"maxItems":200,"type":"array","items":{"$ref":"#/components/schemas/__schema0"}}},"required":["ogeler"]},"SayfaGirdisi":{"type":"object","properties":{"baslik":{"type":"string","minLength":1,"maxLength":200},"tanitici":{"type":"string","maxLength":200},"govde":{"description":"HTML (zararlı etiketler temizlenir)","anyOf":[{"type":"string","maxLength":200000},{"type":"null"}]},"ozet":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"seo":{"type":"object","properties":{"baslik":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"aciklama":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}]}}},"altbilgide":{"description":"Alt bilgideki bağlantılarda görünsün","type":"boolean"}},"required":["baslik"]},"SayfaGuncelleGirdisi":{"type":"object","properties":{"baslik":{"type":"string","minLength":1,"maxLength":200},"tanitici":{"type":"string","maxLength":200},"govde":{"description":"HTML (zararlı etiketler temizlenir)","anyOf":[{"type":"string","maxLength":200000},{"type":"null"}]},"ozet":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"seo":{"type":"object","properties":{"baslik":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}]},"aciklama":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}]}}},"altbilgide":{"description":"Alt bilgideki bağlantılarda görünsün","type":"boolean"}}},"WebhookAboneligi":{"type":"object","properties":{"id":{"type":"string"},"adres":{"type":"string"},"olaylar":{"type":"array","items":{"type":"string","enum":["siparis.olusturuldu","siparis.odeme_alindi","siparis.kargoya_verildi","siparis.teslim_edildi","siparis.iptal_edildi","siparis.para_iade_edildi","iade.olusturuldu","urun.olusturuldu","urun.guncellendi","urun.silindi","stok.degisti","musteri.olusturuldu"]}},"aciklama":{"type":"string"},"aktif":{"type":"boolean"},"ardisik_hata":{"description":"Bütün denemeleri tükenen ardışık teslimat; 5 olunca abonelik kapanır","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"son_basari":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"son_hata":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"kapanma_nedeni":{"anyOf":[{"type":"string"},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","adres","olaylar","aciklama","aktif","ardisik_hata","son_basari","son_hata","kapanma_nedeni","olusturma","guncelleme"],"additionalProperties":false},"WebhookAboneligiGizli":{"type":"object","properties":{"id":{"type":"string"},"adres":{"type":"string"},"olaylar":{"type":"array","items":{"type":"string","enum":["siparis.olusturuldu","siparis.odeme_alindi","siparis.kargoya_verildi","siparis.teslim_edildi","siparis.iptal_edildi","siparis.para_iade_edildi","iade.olusturuldu","urun.olusturuldu","urun.guncellendi","urun.silindi","stok.degisti","musteri.olusturuldu"]}},"aciklama":{"type":"string"},"aktif":{"type":"boolean"},"ardisik_hata":{"description":"Bütün denemeleri tükenen ardışık teslimat; 5 olunca abonelik kapanır","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"son_basari":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"son_hata":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"kapanma_nedeni":{"anyOf":[{"type":"string"},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"gizli":{"description":"İmza sırrı (whsec_…); MK-Imza başlığını bununla doğrulayın","type":"string"}},"required":["id","adres","olaylar","aciklama","aktif","ardisik_hata","son_basari","son_hata","kapanma_nedeni","olusturma","guncelleme","gizli"],"additionalProperties":false},"WebhookGirdisi":{"type":"object","properties":{"adres":{"type":"string","maxLength":2000},"olaylar":{"minItems":1,"type":"array","items":{"type":"string","enum":["siparis.olusturuldu","siparis.odeme_alindi","siparis.kargoya_verildi","siparis.teslim_edildi","siparis.iptal_edildi","siparis.para_iade_edildi","iade.olusturuldu","urun.olusturuldu","urun.guncellendi","urun.silindi","stok.degisti","musteri.olusturuldu"]}},"aciklama":{"type":"string","maxLength":200}},"required":["adres","olaylar"]},"WebhookGuncelleGirdisi":{"type":"object","properties":{"adres":{"type":"string","maxLength":2000},"olaylar":{"minItems":1,"type":"array","items":{"type":"string","enum":["siparis.olusturuldu","siparis.odeme_alindi","siparis.kargoya_verildi","siparis.teslim_edildi","siparis.iptal_edildi","siparis.para_iade_edildi","iade.olusturuldu","urun.olusturuldu","urun.guncellendi","urun.silindi","stok.degisti","musteri.olusturuldu"]}},"aciklama":{"type":"string","maxLength":200},"aktif":{"description":"true: kapanmış aboneliği yeniden açar (hata sayacı sıfırlanır)","type":"boolean"}}},"WebhookTeslimati":{"type":"object","properties":{"id":{"type":"string"},"abonelik_id":{"type":"string"},"olay":{"type":"string"},"olay_id":{"type":"string"},"durum":{"description":"hata: yeniden denenecek; vazgecildi: denemeler bitti","type":"string","enum":["bekliyor","basarili","hata","vazgecildi"]},"deneme":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sonraki":{"anyOf":[{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},{"type":"null"}]},"son_kod":{"description":"Alıcının son HTTP durum kodu","anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"son_hata":{"anyOf":[{"type":"string"},{"type":"null"}]},"sure_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"olusturma":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"},"guncelleme":{"description":"ISO 8601, UTC","example":"2026-10-18T09:12:44Z","type":"string"}},"required":["id","abonelik_id","olay","olay_id","durum","deneme","sonraki","son_kod","son_hata","sure_ms","olusturma","guncelleme"],"additionalProperties":false}}},"x-kapsamlar":{"urun:okuma":"Ürünleri, varyantları, kategorileri ve koleksiyonları okur","urun:yazma":"Ürün, varyant, kategori ve koleksiyon ekler, değiştirir, siler","stok:okuma":"Stok seviyelerini okur","stok:yazma":"Stok günceller","fiyat:okuma":"Fiyatları ve fiyat listelerini okur","fiyat:yazma":"Fiyat ve fiyat listesi günceller","siparis:okuma":"Siparişleri ve iadeleri okur","siparis:yazma":"Siparişi kargoya verir, iptal eder, not ekler; iadeleri yönetir","musteri:okuma":"Müşterileri ve müşteri gruplarını okur","musteri:yazma":"Müşteri ve müşteri grubu ekler, değiştirir","kampanya:okuma":"Kampanyaları ve indirim kodlarını okur","kampanya:yazma":"Kampanya ve indirim kodu ekler, değiştirir, siler","icerik:okuma":"Sayfaları ve menüleri okur","icerik:yazma":"Sayfa ve menü ekler, değiştirir, siler","webhook:yonet":"Webhook aboneliklerini yönetir"},"paths":{"/v1/magaza":{"get":{"operationId":"getMagaza","summary":"Mağazayı getir","description":"Anahtarın bağlı olduğu mağaza ve anahtarın izinleri. Her anahtarla çağrılabilir; bağlantıyı denemek için ilk istek.","tags":["Mağaza"],"security":[{"anahtar":[]}],"parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Magaza"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/urunler":{"get":{"operationId":"getUrunler","summary":"Ürünleri listele","description":"Ürünleri en yeniden eskiye sayfa sayfa döner; varyantlar, fiyatlar ve stok aynı yanıtta. ERP eşitlemesinde `guncelleme_sonra` ile yalnız değişenleri çekin.","tags":["Ürünler"],"x-kapsam":"urun:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}},{"name":"durum","in":"query","required":false,"description":"Yalnız bu durumdaki ürünler","schema":{"type":"string","enum":["yayinda","taslak"]}},{"name":"sku","in":"query","required":false,"description":"Varyant stok koduna göre tam eşleşme","schema":{"type":"string","maxLength":200}},{"name":"barkod","in":"query","required":false,"description":"Varyant barkoduna göre tam eşleşme","schema":{"type":"string","maxLength":200}},{"name":"kategori","in":"query","required":false,"description":"Bu kategorideki ürünler (kategori kimliği)","schema":{"type":"string","maxLength":100}},{"name":"guncelleme_sonra","in":"query","required":false,"description":"Bu andan sonra değişen ürünler (eşitleme için)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Urun"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postUrunler","summary":"Ürün oluştur","description":"Ü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.","tags":["Ürünler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrunOlusturGirdisi"}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Urun"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/urunler/{id}":{"get":{"operationId":"getUrunlerId","summary":"Ürünü getir","tags":["Ürünler"],"x-kapsam":"urun:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Urun"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"patch":{"operationId":"patchUrunlerId","summary":"Ürünü güncelle","description":"Yalnız gönderilen alanlar değişir. Fiyat, stok ve stok kodu için varyant uçlarını kullanın.","tags":["Ürünler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrunGuncelleGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Urun"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteUrunlerId","summary":"Ürünü sil","description":"Ürün vitrinden ve panelden kalkar; geçmiş siparişlerdeki satırlar korunur. Yorumları da silinir.","tags":["Ürünler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/kategoriler":{"get":{"operationId":"getKategoriler","summary":"Kategorileri listele","description":"Bütün kategoriler (sayfasız, ağaç `ust_id` ile kurulur), sıraya göre.","tags":["Kategoriler"],"x-kapsam":"urun:okuma","security":[{"anahtar":[]}],"parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Kategori"}}},"required":["veri"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postKategoriler","summary":"Kategori oluştur","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KategoriGirdisi"}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kategori"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/koleksiyonlar":{"get":{"operationId":"getKoleksiyonlar","summary":"Koleksiyonları listele","tags":["Kategoriler"],"x-kapsam":"urun:okuma","security":[{"anahtar":[]}],"parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Koleksiyon"}}},"required":["veri"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postKoleksiyonlar","summary":"Koleksiyon oluştur","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"tanitici":{"type":"string","maxLength":200}},"required":["ad"]}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Koleksiyon"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/markalar":{"get":{"operationId":"getMarkalar","summary":"Markaları listele","tags":["Kategoriler"],"x-kapsam":"urun:okuma","security":[{"anahtar":[]}],"parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Marka"}}},"required":["veri"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postMarkalar","summary":"Marka oluştur","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"tanitici":{"type":"string","maxLength":200},"aciklama":{"type":"string","maxLength":5000}},"required":["ad"]}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Marka"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/depolar":{"get":{"operationId":"getDepolar","summary":"Depoları listele","tags":["Stok"],"x-kapsam":"stok:okuma","security":[{"anahtar":[]}],"parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Depo"}}},"required":["veri"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/stok":{"get":{"operationId":"getStok","summary":"Stok seviyelerini listele","description":"Varyant başına depo stokları. Hafif eşitleme için: ürünün tamamını çekmeden yalnız stok.","tags":["Stok"],"x-kapsam":"stok:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}},{"name":"sku","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"urun_id","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"guncelleme_sonra","in":"query","required":false,"description":"Stoğu bu andan sonra değişen varyantlar","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Stok"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/fiyat-listeleri":{"get":{"operationId":"getFiyatListeleri","summary":"Fiyat listelerini listele","description":"Süreli ya da müşteri grubuna özel indirimli fiyat listeleri.","tags":["Fiyatlar"],"x-kapsam":"fiyat:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/FiyatListesi"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postFiyatListeleri","summary":"Fiyat listesi oluştur","tags":["Fiyatlar"],"x-kapsam":"fiyat:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiyatListesiGirdisi"}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiyatListesi"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/fiyat-listeleri/{id}":{"get":{"operationId":"getFiyatListeleriId","summary":"Fiyat listesini getir","tags":["Fiyatlar"],"x-kapsam":"fiyat:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiyatListesi"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"patch":{"operationId":"patchFiyatListeleriId","summary":"Fiyat listesini güncelle","tags":["Fiyatlar"],"x-kapsam":"fiyat:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiyatListesiGuncelleGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiyatListesi"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteFiyatListeleriId","summary":"Fiyat listesini sil","tags":["Fiyatlar"],"x-kapsam":"fiyat:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/varyantlar/{id}":{"patch":{"operationId":"patchVaryantlarId","summary":"Varyantı güncelle","description":"Stok kodu, barkod, fiyat ve stok. `stok: null` stok takibini kapatır.","tags":["Ürünler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VaryantGuncelleGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Varyant"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/stok/toplu":{"post":{"operationId":"postStokToplu","summary":"Toplu stok güncelle","description":"En çok 500 varyantın depodaki adedini yazar (fark değil, yeni adet). Hepsi ya da hiçbiri: bulunamayan varyant varsa hiçbiri yazılmaz. Stok takibi kapalı varyantta açılır.","tags":["Stok"],"x-kapsam":"stok:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopluStokGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"guncellenen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"veri":{"type":"array","items":{"$ref":"#/components/schemas/Stok"}}},"required":["guncellenen","veri"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/fiyat/toplu":{"post":{"operationId":"postFiyatToplu","summary":"Toplu fiyat güncelle","description":"En çok 500 varyantın satış ve üstü çizili fiyatını yazar. Hepsi ya da hiçbiri. MultiKur açıksa diğer para birimleri kurla yeniden hesaplanır.","tags":["Fiyatlar"],"x-kapsam":"fiyat:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopluFiyatGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"guncellenen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"urunler":{"type":"array","items":{"type":"string"}}},"required":["guncellenen","urunler"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/kategoriler/{id}":{"patch":{"operationId":"patchKategorilerId","summary":"Kategori güncelle","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"tanitici":{"type":"string","maxLength":200},"aciklama":{"type":"string","maxLength":5000},"ust_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"sira":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"aktif":{"type":"boolean"},"dahili":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kategori"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteKategorilerId","summary":"Kategori sil","description":"Bağlı ürün ya da alt kategori varsa silinmez (409).","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/koleksiyonlar/{id}":{"patch":{"operationId":"patchKoleksiyonlarId","summary":"Koleksiyon güncelle","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"tanitici":{"type":"string","maxLength":200}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Koleksiyon"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteKoleksiyonlarId","summary":"Koleksiyon sil","description":"Bağlı ürün ya da alt kategori varsa silinmez (409).","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/markalar/{id}":{"patch":{"operationId":"patchMarkalarId","summary":"Marka güncelle","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":200},"tanitici":{"type":"string","maxLength":200},"aciklama":{"type":"string","maxLength":5000}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Marka"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteMarkalarId","summary":"Marka sil","description":"Bağlı ürün ya da alt kategori varsa silinmez (409).","tags":["Kategoriler"],"x-kapsam":"urun:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/siparisler":{"get":{"operationId":"getSiparisler","summary":"Siparişleri listele","description":"Siparişleri en yeniden eskiye döner. Durum paneldekiyle aynı: ödeme bekliyor (havale), hazırlanıyor, kargoda, teslim edildi, iptal, iade.","tags":["Siparişler"],"x-kapsam":"siparis:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}},{"name":"durum","in":"query","required":false,"schema":{"type":"string","enum":["odeme_bekliyor","hazirlaniyor","kargoda","teslim_edildi","iptal","iade"]}},{"name":"eposta","in":"query","required":false,"description":"Müşteri e-postası (tam eşleşme, büyük/küçük harf duyarsız)","schema":{"type":"string","maxLength":200}},{"name":"olusturma_sonra","in":"query","required":false,"schema":{"type":"string"}},{"name":"olusturma_once","in":"query","required":false,"schema":{"type":"string"}},{"name":"guncelleme_sonra","in":"query","required":false,"description":"Bu andan sonra değişen siparişler (eşitleme için)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Siparis"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/siparisler/{id}":{"get":{"operationId":"getSiparislerId","summary":"Siparişi getir","tags":["Siparişler"],"x-kapsam":"siparis:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Siparis"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/iadeler":{"get":{"operationId":"getIadeler","summary":"İadeleri listele","description":"Panelde \"İade al\" ile kaydedilen iadeler, en yeniden eskiye.","tags":["Siparişler"],"x-kapsam":"siparis:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}},{"name":"siparis_id","in":"query","required":false,"schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Iade"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/iadeler/{id}":{"get":{"operationId":"getIadelerId","summary":"İadeyi getir","tags":["Siparişler"],"x-kapsam":"siparis:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Iade"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/musteriler":{"get":{"operationId":"getMusteriler","summary":"Müşterileri listele","tags":["Müşteriler"],"x-kapsam":"musteri:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}},{"name":"eposta","in":"query","required":false,"description":"Tam eşleşme (büyük/küçük harf duyarsız)","schema":{"type":"string","maxLength":200}},{"name":"grup","in":"query","required":false,"description":"Bu gruptaki müşteriler","schema":{"type":"string","maxLength":100}},{"name":"guncelleme_sonra","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Musteri"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postMusteriler","summary":"Müşteri oluştur","description":"Şifresiz (misafir) müşteri kaydı açar; müşteri vitrinde aynı e-postayla üye olabilir. Aynı e-posta varsa 409.","tags":["Müşteriler"],"x-kapsam":"musteri:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MusteriOlusturGirdisi"}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Musteri"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/musteriler/{id}":{"get":{"operationId":"getMusterilerId","summary":"Müşteriyi getir","tags":["Müşteriler"],"x-kapsam":"musteri:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Musteri"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"patch":{"operationId":"patchMusterilerId","summary":"Müşteriyi güncelle","tags":["Müşteriler"],"x-kapsam":"musteri:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MusteriGuncelleGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Musteri"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/musteri-gruplari":{"get":{"operationId":"getMusteriGruplari","summary":"Müşteri gruplarını listele","tags":["Müşteriler"],"x-kapsam":"musteri:okuma","security":[{"anahtar":[]}],"parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/MusteriGrubu"}}},"required":["veri"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postMusteriGruplari","summary":"Müşteri grubu oluştur","tags":["Müşteriler"],"x-kapsam":"musteri:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ad":{"type":"string","minLength":1,"maxLength":100}},"required":["ad"]}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MusteriGrubu"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/kampanyalar":{"get":{"operationId":"getKampanyalar","summary":"Kampanyaları listele","tags":["Kampanyalar"],"x-kapsam":"kampanya:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}},{"name":"aktif","in":"query","required":false,"description":"Yalnız açık ya da kapalı olanlar","schema":{"type":"string","enum":["true","false"]}},{"name":"kod","in":"query","required":false,"description":"İndirim koduna göre (büyük/küçük harf duyarsız)","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Kampanya"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postKampanyalar","summary":"Kampanya oluştur","tags":["Kampanyalar"],"x-kapsam":"kampanya:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KampanyaOlusturGirdisi"}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kampanya"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/kampanyalar/{id}":{"get":{"operationId":"getKampanyalarId","summary":"Kampanyayı getir","tags":["Kampanyalar"],"x-kapsam":"kampanya:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kampanya"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"patch":{"operationId":"patchKampanyalarId","summary":"Kampanyayı güncelle","description":"Yalnız gönderilen alanlar değişir; tür değiştirilemez.","tags":["Kampanyalar"],"x-kapsam":"kampanya:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KampanyaGuncelleGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kampanya"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteKampanyalarId","summary":"Kampanyayı sil","tags":["Kampanyalar"],"x-kapsam":"kampanya:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/sayfalar":{"get":{"operationId":"getSayfalar","summary":"Sayfaları listele","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/Sayfa"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postSayfalar","summary":"Sayfa oluştur","description":"Taslak olarak açılır; vitrinde görünmesi için `/yayinla`.","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SayfaGirdisi"}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sayfa"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/sayfalar/{id}":{"get":{"operationId":"getSayfalarId","summary":"Sayfayı getir","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sayfa"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"patch":{"operationId":"patchSayfalarId","summary":"Sayfayı güncelle","description":"Taslağı değiştirir; yayındaki sürüm `/yayinla` deyince güncellenir.","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SayfaGuncelleGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sayfa"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteSayfalarId","summary":"Sayfayı sil","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/menuler/{tanitici}":{"get":{"operationId":"getMenulerTanitici","summary":"Menüyü getir","description":"`header` (üst menü) ya da `footer` (alt menü).","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:okuma","security":[{"anahtar":[]}],"parameters":[{"name":"tanitici","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Menu"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"put":{"operationId":"putMenulerTanitici","summary":"Menüyü yaz","description":"Menünün tamamını yazar (`header` ya da `footer`). Geçersiz öğeler atılır.","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"tanitici","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MenuGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Menu"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteMenulerTanitici","summary":"Menüyü temaya döndür","description":"Kayıt silinir; vitrin temanın menüsünü gösterir.","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"tanitici","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Menu"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/siparisler/{id}/kargo":{"post":{"operationId":"postSiparislerIdKargo","summary":"Kargoya ver","description":"Gönderilmemiş bütün kalemler için gönderi açar. `elle`: takip numarası sizden; `uygulama`: mağazadaki kargo uygulamasıyla firmada gönderi açılır ve takip numarası firmadan gelir.","tags":["Siparişler"],"x-kapsam":"siparis:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KargoyaVerGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Siparis"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/siparisler/{id}/teslim":{"post":{"operationId":"postSiparislerIdTeslim","summary":"Teslim edildi olarak işaretle","description":"Kargodaki bütün gönderiler teslim edildi sayılır.","tags":["Siparişler"],"x-kapsam":"siparis:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Siparis"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/siparisler/{id}/iptal":{"post":{"operationId":"postSiparislerIdIptal","summary":"Siparişi iptal et","description":"Kartla ödenmişse ödeme iade edilir, stok geri döner. Kargoya verilmiş ya da tamamlanmış sipariş iptal edilemez (409).","tags":["Siparişler"],"x-kapsam":"siparis:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"neden":{"type":"string","minLength":1,"maxLength":200}},"required":["neden"]}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Siparis"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/siparisler/{id}/not":{"post":{"operationId":"postSiparislerIdNot","summary":"Siparişe not ekle","description":"Panelde siparişin zaman çizelgesinde görünür; müşteriye gitmez.","tags":["Siparişler"],"x-kapsam":"siparis:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metin":{"type":"string","minLength":1,"maxLength":2000}},"required":["metin"]}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Siparis"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/siparisler/{id}/odeme-onayla":{"post":{"operationId":"postSiparislerIdOdemeOnayla","summary":"Havale ödemesini onayla","description":"Havale/EFT ile bekleyen siparişin parası hesaba geçtiyse.","tags":["Siparişler"],"x-kapsam":"siparis:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Siparis"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/musteri-gruplari/{id}/uyeler":{"post":{"operationId":"postMusteriGruplariIdUyeler","summary":"Gruba müşteri ekle / çıkar","tags":["Müşteriler"],"x-kapsam":"musteri:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ekle":{"default":[],"maxItems":1000,"type":"array","items":{"type":"string"}},"cikar":{"default":[],"maxItems":1000,"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MusteriGrubu"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/musteri-gruplari/{id}":{"delete":{"operationId":"deleteMusteriGruplariId","summary":"Müşteri grubunu sil","tags":["Müşteriler"],"x-kapsam":"musteri:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/fiyat-listeleri/{id}/fiyatlar":{"post":{"operationId":"postFiyatListeleriIdFiyatlar","summary":"Listeye fiyat yaz","description":"Varyant + para birimi başına bir fiyat; varsa üzerine yazılır.","tags":["Fiyatlar"],"x-kapsam":"fiyat:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiyatListesiFiyatlari"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiyatListesi"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/sayfalar/{id}/yayinla":{"post":{"operationId":"postSayfalarIdYayinla","summary":"Sayfayı yayınla","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sayfa"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/sayfalar/{id}/yayindan-kaldir":{"post":{"operationId":"postSayfalarIdYayindanKaldir","summary":"Sayfayı yayından kaldır","tags":["Sayfalar ve menüler"],"x-kapsam":"icerik:yazma","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sayfa"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/olaylar":{"get":{"operationId":"getOlaylar","summary":"Olay türlerini listele","tags":["Webhook'lar"],"security":[{"anahtar":[]}],"parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"type":"object","properties":{"olay":{"type":"string"},"aciklama":{"type":"string"}},"required":["olay","aciklama"],"additionalProperties":false}}},"required":["veri"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/webhooklar":{"get":{"operationId":"getWebhooklar","summary":"Webhook'ları listele","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/WebhookAboneligi"}}},"required":["veri"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"post":{"operationId":"postWebhooklar","summary":"Webhook oluştur","description":"Adres https:// olmalı. Yanıttaki `gizli` ile her isteğin MK-Imza başlığını doğrulayın.","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookGirdisi"}}}},"responses":{"201":{"description":"Oluşturuldu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookAboneligiGizli"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/webhooklar/{id}":{"get":{"operationId":"getWebhooklarId","summary":"Webhook'u getir","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookAboneligiGizli"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"patch":{"operationId":"patchWebhooklarId","summary":"Webhook'u güncelle","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookGuncelleGirdisi"}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookAboneligi"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}},"delete":{"operationId":"deleteWebhooklarId","summary":"Webhook'u sil","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"silindi":{"type":"boolean","const":true},"id":{"type":"string"}},"required":["silindi","id"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/webhooklar/{id}/test":{"post":{"operationId":"postWebhooklarIdTest","summary":"Test olayı gönder","description":"`test.ping` olayını hemen gönderir ve sonucu döner (yeniden denenmez).","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTeslimati"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/webhooklar/{id}/gizli-yenile":{"post":{"operationId":"postWebhooklarIdGizliYenile","summary":"İmza sırrını yenile","description":"Eski sır hemen geçersiz olur.","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"gizli":{"type":"string"}},"required":["gizli"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/webhooklar/{id}/teslimatlar":{"get":{"operationId":"getWebhooklarIdTeslimatlar","summary":"Teslimatları listele","description":"Son 30 günün teslimatları, en yeniden eskiye.","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Bir sayfadaki kayıt sayısı (1–100)","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"sonraki","in":"query","required":false,"description":"Önceki yanıttaki `sonraki` değeri; boşsa ilk sayfa","schema":{"type":"string","maxLength":200}},{"name":"durum","in":"query","required":false,"schema":{"type":"string","enum":["bekliyor","basarili","hata","vazgecildi"]}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"type":"object","properties":{"veri":{"type":"array","items":{"$ref":"#/components/schemas/WebhookTeslimati"}},"sonraki":{"description":"Sonraki sayfanın imleci; son sayfada null","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["veri","sonraki"],"additionalProperties":false}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"422":{"description":"Girdi geçersiz","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}},"/v1/webhook-teslimatlari/{id}/yeniden-gonder":{"post":{"operationId":"postWebhookTeslimatlariIdYenidenGonder","summary":"Teslimatı yeniden gönder","description":"Denemeleri tükenmiş ya da başarılı bir teslimatı hemen yeniden kuyruğa alır.","tags":["Webhook'lar"],"x-kapsam":"webhook:yonet","security":[{"anahtar":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"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.","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTeslimati"}}}},"401":{"description":"Anahtar yok, geçersiz ya da iptal edilmiş","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"403":{"description":"Anahtarın bu uç için izni yok","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}},"429":{"description":"İstek sınırı aşıldı (Retry-After başlığına bakın)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Hata"}}}}}}}}}