{"components":{"schemas":{"Address":{"additionalProperties":false,"properties":{"address_line":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Adres satırı; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Address Line"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İl; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"City"},"district":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İlçe; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"District"},"full_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ad soyad; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Full Name"},"neighborhood":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Mahalle; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Neighborhood"},"neighborhood_area":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Varsa bağlı köy, semt veya belde; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Neighborhood Area"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Telefon; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Phone"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Posta kodu; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Postal Code"},"village":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Köy adresi işareti; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Village"}},"title":"Address","type":"object"},"AnonymizeCustomer":{"additionalProperties":false,"properties":{"confirm":{"const":"anonymize","description":"Geri alınamaz anonimleştirme için zorunlu açık onay; tam olarak anonymize yazın.","examples":["anonymize"],"title":"Confirm","type":"string"},"reason":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"description":"İsteğe bağlı gerekçe; kişisel veri yazmayın. Denetim kaydında maskelenir, yanıtta ve olayda yayımlanmaz.","examples":["Müşterinin KVKK silme isteği."],"title":"Reason"}},"required":["confirm"],"title":"AnonymizeCustomer","type":"object"},"ApplicationIdentity":{"additionalProperties":false,"properties":{"id":{"description":"Uygulamanın app_ önekli kimliği.","examples":["app_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"installation_id":{"description":"Bu işletmedeki kurulumun ins_ önekli kimliği.","examples":["ins_1234567890abcdef1234567890abcdef"],"title":"Installation Id","type":"string"},"name":{"description":"Uygulama adı.","examples":["Örnek uygulama"],"title":"Name","type":"string"}},"required":["id","name","installation_id"],"title":"ApplicationIdentity","type":"object"},"Attempt":{"additionalProperties":false,"properties":{"attempted_at":{"description":"Teslim denemesi zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Attempted At","type":"string"},"duration_ms":{"description":"Teslim denemesinin milisaniye cinsinden süresi.","examples":[120],"title":"Duration Ms","type":"integer"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Denemenin hata kodu; başarıda null.","examples":[null],"title":"Error"},"id":{"description":"Kaynağın dış kimliği; wha_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["wha_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Alıcı HTTP durum kodu; ağ hatasında null.","examples":[200],"title":"Status Code"}},"required":["id","attempted_at","duration_ms","status_code","error"],"title":"Attempt","type":"object"},"Billing":{"additionalProperties":false,"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Fatura unvanı; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Company Name"},"tax_number":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Vergi/kimlik numarası; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Tax Number"},"tax_office":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Vergi dairesi; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Tax Office"}},"title":"Billing","type":"object"},"Box":{"additionalProperties":false,"properties":{"count":{"default":1,"description":"Aynı ölçüdeki koli sayısı.","examples":[1],"maximum":99,"minimum":1,"title":"Count","type":"integer"},"depth":{"description":"Bir kolinin boyu, cm.","examples":[20],"exclusiveMinimum":0,"maximum":1000,"title":"Depth","type":"number"},"height":{"description":"Bir kolinin yüksekliği, cm.","examples":[20],"exclusiveMinimum":0,"maximum":1000,"title":"Height","type":"number"},"weight":{"description":"Bir kolinin ağırlığı, kg.","examples":[1],"exclusiveMinimum":0,"maximum":10000,"title":"Weight","type":"number"},"width":{"description":"Bir kolinin eni, cm.","examples":[20],"exclusiveMinimum":0,"maximum":1000,"title":"Width","type":"number"}},"required":["width","depth","height","weight"],"title":"Box","type":"object"},"Brand":{"additionalProperties":false,"properties":{"id":{"description":"Kaynağın dış kimliği; sto_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"name":{"description":"Erişilebilen markanın adı.","examples":["Örnek Marka"],"title":"Name","type":"string"}},"required":["id","name"],"title":"Brand","type":"object"},"BrandFields":{"additionalProperties":false,"properties":{"logo":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"description":"Paneldeki ürün markası logosunun URL adresi; null temizler.","examples":[null],"title":"Logo"},"name":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"description":"Görünen ad; aynı ad paneldeki gibi ayrı kayıt açabilir.","examples":["Mutfak"],"title":"Name"},"sort_order":{"anyOf":[{"maximum":2147483647,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Sıra; küçük değer önce gelir.","examples":[1],"title":"Sort Order"},"status":{"anyOf":[{"enum":["active","inactive"],"type":"string"},{"type":"null"}],"description":"Vitrinde görünürlük: active açık, inactive kapalı.","examples":["active"],"title":"Status"}},"title":"BrandFields","type":"object"},"BulkErrorPage":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfadaki satır hataları.","examples":[[{"code":"not_found","detail":"Seçenek bulunamadı.","identifier":"BULUNAMAYAN-KOD","line":2}]],"items":{"$ref":"#/components/schemas/BulkRowError"},"title":"Data","type":"array"},"has_more":{"description":"Sonraki sayfa varsa true.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfanın yetkiye bağlı imleci.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"BulkErrorPage","type":"object"},"BulkInventory":{"additionalProperties":false,"properties":{"lines":{"description":"En çok 10.000 sayım satırı; her satırda expected zorunludur.","examples":[[{"expected":"10","quantity":"12","sku":"KUPA-MAVI"}]],"items":{"$ref":"#/components/schemas/BulkInventoryLine"},"maxItems":10000,"minItems":1,"title":"Lines","type":"array"},"location":{"description":"Sayımın loc_ depo kimliği.","examples":["loc_1234567890abcdef1234567890abcdef"],"maxLength":36,"minLength":1,"title":"Location","type":"string"}},"required":["location","lines"],"title":"BulkInventory","type":"object"},"BulkInventoryLine":{"additionalProperties":false,"properties":{"expected":{"anyOf":[{"maximum":100000000,"minimum":-100000000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"Zorunlu: son okunan depo miktarı; stok sayılmıyorsa null. Değişmişse satır stock_changed ile atlanır.","examples":["10"],"title":"Expected"},"quantity":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"}],"description":"Depoda sayılan miktar; sıfır olabilir, en çok üç ondalık hane.","examples":["12"],"title":"Quantity"},"sku":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"description":"Stok kodu; harf ve baş/son boşluk farkı yok sayılır.","examples":["KUPA-MAVI"],"title":"Sku"},"variant":{"anyOf":[{"maxLength":36,"minLength":1,"type":"string"},{"type":"null"}],"description":"var_ seçenek kimliği; variant veya sku alanından yalnız biri gerekir.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["quantity","expected"],"title":"BulkInventoryLine","type":"object"},"BulkJob":{"additionalProperties":false,"properties":{"created_at":{"description":"İşin açıldığı zaman; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İşin tamamını durduran sabit kod; satır hataları ayrı listelenir.","examples":[null],"title":"Error Code"},"failed":{"description":"Hatalı satır sayısı; /jobs/{id}/errors ile okunur.","examples":[0],"title":"Failed","type":"integer"},"finished_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"İşin bittiği zaman; sürüyorsa null.","examples":[null],"title":"Finished At"},"id":{"description":"Kalıcı job_ iş kimliği.","examples":["job_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"kind":{"description":"prices fiyat; inventory depo sayımı.","enum":["prices","inventory"],"examples":["prices"],"title":"Kind","type":"string"},"processed":{"description":"Sonuçlandırılan satır sayısı; başarısız satırlar dahildir.","examples":[0],"title":"Processed","type":"integer"},"status":{"description":"Sırada, çalışıyor, başarılı, başarısız veya kısmen başarısız.","enum":["queued","running","succeeded","failed","partially_failed"],"examples":["queued"],"title":"Status","type":"string"},"total":{"description":"Gönderilen toplam satır sayısı.","examples":[10000],"title":"Total","type":"integer"}},"required":["id","kind","status","total","processed","failed","created_at","finished_at","error_code"],"title":"BulkJob","type":"object"},"BulkPriceLine":{"additionalProperties":false,"properties":{"compare_at_price":{"anyOf":[{"maximum":999999999,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Üstü çizili fiyat için alternatif gösterim; sale_price ile birlikte kullanılamaz. null indirimi kaldırır. Marka fiyat sütunu indirim yazmaz.","examples":[null],"title":"Compare At Price"},"cost":{"anyOf":[{"maximum":999999999,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Excel Maliyet sütunu; costs:write gerekir. KDV hariç, muaf işletmede KDV dahil; null değiştirmez.","examples":[null],"title":"Cost"},"price":{"anyOf":[{"maximum":999999999,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Excel Fiyat sütunu: indirimsiz TRY fiyatı. compare_at_price verilirse price satış fiyatı, compare_at_price indirimsiz fiyat olarak eşlenir.","examples":["120.00"],"title":"Price"},"sale_price":{"anyOf":[{"maximum":999999999,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Excel İndirimli fiyat sütunu. Atlanırsa paneldeki oran korunur; null indirimi kaldırır. Seçenek indirimi ürünün kuralına uymalıdır.","examples":[null],"title":"Sale Price"},"sku":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"description":"Stok kodu; harf ve baş/son boşluk farkı yok sayılır.","examples":["KUPA-MAVI"],"title":"Sku"},"store":{"anyOf":[{"maxLength":36,"minLength":1,"type":"string"},{"type":"null"}],"description":"sto_ marka fiyat sütunu; atlanırsa katalog fiyatı. Ürün markaya bağlı olmalıdır. Marka sütunu yalnız satış fiyatını değiştirir.","examples":[null],"title":"Store"},"variant":{"anyOf":[{"maxLength":36,"minLength":1,"type":"string"},{"type":"null"}],"description":"var_ seçenek kimliği; variant veya sku alanından yalnız biri gerekir.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["price"],"title":"BulkPriceLine","type":"object"},"BulkPrices":{"additionalProperties":false,"properties":{"lines":{"description":"En çok 10.000 fiyat satırı; satır numaraları 1 ile başlar.","examples":[[{"price":"120.00","sku":"KUPA-MAVI"}]],"items":{"$ref":"#/components/schemas/BulkPriceLine"},"maxItems":10000,"minItems":1,"title":"Lines","type":"array"}},"required":["lines"],"title":"BulkPrices","type":"object"},"BulkRowError":{"additionalProperties":false,"properties":{"code":{"description":"Sabit hata kodu: not_found, invalid_price, invalid_stock_operation, duplicate_row, stock_changed veya row_timeout.","examples":["not_found"],"title":"Code","type":"string"},"detail":{"description":"Satırın neden uygulanmadığı.","examples":["Seçenek bulunamadı."],"title":"Detail","type":"string"},"identifier":{"description":"İstekteki var_ kimliği veya stok kodu.","examples":["BULUNAMAYAN-KOD"],"title":"Identifier","type":"string"},"line":{"description":"Gönderilen listedeki satır numarası; 1 ile başlar.","examples":[2],"title":"Line","type":"integer"}},"required":["line","identifier","code","detail"],"title":"BulkRowError","type":"object"},"Business":{"additionalProperties":false,"properties":{"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"id":{"description":"Kaynağın dış kimliği; bus_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["bus_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"kind":{"description":"İşletme türü; company: şirket, exempt: vergi muafiyetli kişi.","enum":["company","exempt"],"examples":["company"],"title":"Kind","type":"string"},"name":{"description":"Kaydın görünen adı.","examples":["Örnek Ticaret"],"title":"Name","type":"string"},"tax_status":{"description":"standard: KDV mükellefi; exempt: vergiden muaf.","enum":["standard","exempt"],"examples":["standard"],"title":"Tax Status","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","name","kind","currency","tax_status","created_at","updated_at"],"title":"Business","type":"object"},"CancelInvoice":{"additionalProperties":false,"properties":{"portal_done":{"default":false,"description":"Yalnız sağlayıcı portalında iptal gerçekten tamamlandıysa true.","examples":[false],"title":"Portal Done","type":"boolean"},"reason":{"anyOf":[{"maxLength":450,"type":"string"},{"type":"null"}],"description":"İptal gerekçesi; muhasebe kaydında korunur.","examples":["Yanlış fatura düzenlendi."],"title":"Reason"}},"title":"CancelInvoice","type":"object"},"CancelShipment":{"additionalProperties":false,"properties":{},"title":"CancelShipment","type":"object"},"CatalogAction":{"additionalProperties":false,"description":"Arşiv ve geri getirme boş JSON nesnesi alır.","properties":{},"title":"CatalogAction","type":"object"},"CatalogOption":{"additionalProperties":false,"properties":{"name":{"description":"Seçenek özelliğinin adı.","examples":["Renk"],"maxLength":100,"minLength":1,"title":"Name","type":"string"},"value":{"description":"Seçenek özelliğinin değeri.","examples":["Mavi"],"maxLength":200,"minLength":1,"title":"Value","type":"string"}},"required":["name","value"],"title":"CatalogOption","type":"object"},"CatalogReference":{"additionalProperties":false,"properties":{"id":{"description":"Kendi sisteminizdeki kimlik; grant ve kaynak türünde tekildir.","examples":["ERP-001"],"maxLength":200,"minLength":1,"title":"Id","type":"string"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kalıcı grt_ kimliği; atlanabilir, başka bağlantının ad alanı seçilemez.","examples":[null],"title":"Namespace"}},"required":["id"],"title":"CatalogReference","type":"object"},"Category":{"additionalProperties":false,"properties":{"archived":{"description":"Arşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.","examples":[false],"title":"Archived","type":"boolean"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kaynağın açıklama metni.","examples":["Seramik kupa, 300 ml."],"title":"Description"},"id":{"description":"Kaynağın dış kimliği; cat_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["cat_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Görselin genel HTTPS adresi.","examples":["https://example.com/kupa.jpg"],"title":"Image"},"name":{"description":"Kaydın görünen adı.","examples":["Mutfak"],"title":"Name","type":"string"},"parent":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Üst kategori kimliği (cat_ ve 32 küçük onaltılık karakter).","examples":[null],"title":"Parent"},"revision":{"description":"Kaydın revizyonu; If-Match için ETag ile birlikte kullanılır.","examples":[1],"title":"Revision","type":"integer"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Adreslerde kullanılan kısa ad.","examples":["ornek-kupa"],"title":"Slug"},"sort_order":{"description":"Panel ve vitrindeki sırası; küçük değer önce gelir.","examples":[0],"title":"Sort Order","type":"integer"},"status":{"description":"Kaynağın işlem durumu.","examples":["active"],"title":"Status","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["revision","sort_order","id","name","slug","parent","status","description","image","archived","created_at","updated_at"],"title":"Category","type":"object"},"CategoryFields":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"maxLength":50000,"type":"string"},{"type":"null"}],"description":"Kategori açıklaması; null temizler.","examples":["Mutfak ürünleri"],"title":"Description"},"image":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"description":"Paneldeki kategori görselinin URL adresi; null temizler.","examples":[null],"title":"Image"},"name":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"description":"Görünen ad; aynı ad paneldeki gibi ayrı kayıt açabilir.","examples":["Mutfak"],"title":"Name"},"parent":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Üst cat_ kategori kimliği; null ana kategori yapar.","examples":[null],"title":"Parent"},"sort_order":{"anyOf":[{"maximum":2147483647,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Sıra; küçük değer önce gelir.","examples":[1],"title":"Sort Order"},"status":{"anyOf":[{"enum":["active","inactive"],"type":"string"},{"type":"null"}],"description":"Vitrinde görünürlük: active açık, inactive kapalı.","examples":["active"],"title":"Status"}},"title":"CategoryFields","type":"object"},"ChangeItem":{"additionalProperties":false,"properties":{"id":{"description":"Değişen sipariş satırının lin_ kimliği.","examples":["lin_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"quantity":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"}],"description":"Yeni miktar; 0 satırı çıkarır, reason gerekir. Son ürün çıkarılamaz.","examples":["1"],"title":"Quantity"},"reason":{"default":"","description":"Ürün çıkarılırken zorunlu gerekçe.","examples":["Müşteri bir adet istedi."],"maxLength":200,"title":"Reason","type":"string"},"unit_price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Yeni TRY birim fiyatı; yalnız panelde fiyat düzeltilebilen siparişte ve orders.price izniyle.","examples":["120.00"],"title":"Unit Price"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Yeni var_ seçeneği; atlanırsa satırın seçeneği korunur.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["id","quantity"],"title":"ChangeItem","type":"object"},"CorrectOrderStatus":{"additionalProperties":false,"properties":{"expected_status":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"description":"Gördüğünüz sipariş durumu; kilit altında farklıysa 409 status_mismatch.","examples":["confirmed"],"title":"Expected Status"},"reason":{"default":"","description":"İşlemin gerekçesi; correct-status ve başka kanalda bildirilen satışın iptali için zorunlu.","examples":["Müşteri teslim aldı."],"maxLength":1000,"title":"Reason","type":"string"},"status":{"description":"Hedef durum; panelin gerekçeli düzeltme kuralları geçerlidir. refunded desteklenmez; payment_pending eski değerdir, 409 döner (ödeme durum değildir: Ödeme alındı ucunu kullanın).","enum":["pending","payment_pending","confirmed","processing","shipped","delivered","cancelled"],"examples":["confirmed"],"title":"Status","type":"string"}},"required":["status"],"title":"CorrectOrderStatus","type":"object"},"CountLine":{"additionalProperties":false,"examples":[{"expected":"10","quantity":"12","sku":"KUPA-MAVI"}],"properties":{"expected":{"anyOf":[{"maximum":100000000,"minimum":-100000000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"Zorunlu: okuduğunuz depo miktarı. Stok sayılmıyorsa açıkça null gönderin; değişmişse 409 stock_changed.","examples":["10"],"title":"Expected"},"quantity":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"}],"description":"Saydığınız depo miktarı; sıfır olabilir.","examples":["12"],"title":"Quantity"},"sku":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"description":"Stok kodu; baş/son boşluk ve harf farkı kaldırılarak tam eşleşir.","examples":["KUPA-MAVI"],"title":"Sku"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"var_ seçenek kimliği; variant veya sku alanından tam biri gerekir. Ortak stokta havuzun var_ kimliğini kullanın.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["quantity","expected"],"title":"CountLine","type":"object"},"CountStock":{"additionalProperties":false,"properties":{"lines":{"description":"Sayımın miktarı ve her satır için zorunlu expected değeri.","examples":[[{"expected":"10","quantity":"12","sku":"KUPA-MAVI"}]],"items":{"$ref":"#/components/schemas/CountLine"},"maxItems":500,"minItems":1,"title":"Lines","type":"array"},"location":{"description":"İşlemin loc_ depo kimliği; /locations listesinden seçin.","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location","type":"string"},"note":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"description":"İç açıklama; internal_notes:write gerekir, okumak için internal_notes:read gerekir.","examples":["Depoda kontrol edildi."],"title":"Note"},"reason":{"anyOf":[{"enum":["other_channel","gift","loss","count_diff","received","return","other"],"type":"string"},{"type":"null"}],"description":"İsteğe bağlı sayım nedeni; yalnız miktar değişiminin yönüne uygun satırlarda görünür.","examples":["count_diff"],"title":"Reason"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sto_ marka kimliği; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"}},"required":["location","lines"],"title":"CountStock","type":"object"},"Coupon":{"additionalProperties":false,"properties":{"archived":{"description":"Arşivdeyse true; sepette uygulanmaz.","examples":[false],"title":"Archived","type":"boolean"},"categories":{"description":"Görünür cat_ kategori kimlikleri; alt kategoriler dahil. Marka sınırı bazı kimlikleri gizleyebilir; kapsamı category_restricted belirtir.","examples":[[]],"items":{"type":"string"},"title":"Categories","type":"array"},"category_restricted":{"description":"Kupon kategoriyle sınırlıysa true; categories boş görünse de kapsam bütün ürünler olmayabilir.","examples":[false],"title":"Category Restricted","type":"boolean"},"code":{"description":"Müşterinin kullanacağı normalleştirilmiş kupon kodu.","examples":["MERHABA10"],"title":"Code","type":"string"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","description":"Tutarların para birimi.","examples":["TRY"],"title":"Currency","type":"string"},"customer_restricted":{"description":"Panelden belirli müşterilere atanmışsa true; müşteri kimlikleri ve kişisel alanlar yayımlanmaz.","examples":[false],"title":"Customer Restricted","type":"boolean"},"discount_type":{"anyOf":[{"enum":["percentage","fixed"],"type":"string"},{"type":"null"}],"description":"Yüzde veya TRY tutarı; yalnız ücretsiz kargoda boş olabilir.","examples":["percentage"],"title":"Discount Type"},"discount_value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İndirim oranı veya TRY tutarı; ondalık metin.","examples":["10.00"],"title":"Discount Value"},"exclude_discounted":{"description":"İndirimli ve kampanyalı ürünleri kapsam dışında tutar.","examples":[false],"title":"Exclude Discounted","type":"boolean"},"first_order_only":{"description":"Yalnız müşterinin ilk siparişinde geçerliyse true.","examples":[false],"title":"First Order Only","type":"boolean"},"free_shipping":{"description":"Kupon geçerliyken kargo da ücretsizse true.","examples":[false],"title":"Free Shipping","type":"boolean"},"id":{"description":"cpn_ önekli dış kupon kimliği.","examples":["cpn_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"max_uses":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Toplam kullanım sınırı; null sınırsız.","examples":[100],"title":"Max Uses"},"max_uses_per_customer":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Aynı müşteri için kullanım sınırı; null sınırsız.","examples":[1],"title":"Max Uses Per Customer"},"min_order":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kupona uygun ürünlerde en az sepet tutarı, TRY.","examples":["100.00"],"title":"Min Order"},"revision":{"description":"Kaydın revizyonu; If-Match için ETag ile birlikte kullanılır.","examples":[1],"title":"Revision","type":"integer"},"status":{"description":"active açık, inactive kapalı kupon.","enum":["active","inactive"],"examples":["active"],"title":"Status","type":"string"},"store":{"description":"Kuponun geçerli olduğu sto_ markası.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"},"used_count":{"description":"Panelin siparişlerden hesapladığı kullanım sayısı; iptal ve tam iadeler sayılmaz.","examples":[0],"title":"Used Count","type":"integer"},"valid_from":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Markanın yerel takvim günü (YYYY-MM-DD) veya dakika dahil saati (YYYY-MM-DDTHH:MM); null sınırsız.","examples":["2026-10-16"],"title":"Valid From"},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Markanın yerel bitiş günü veya saati; gün ve son dakika dahildir. null sınırsız.","examples":["2026-12-31T23:59"],"title":"Valid Until"}},"required":["id","store","revision","code","status","discount_type","discount_value","min_order","currency","max_uses","max_uses_per_customer","used_count","first_order_only","free_shipping","exclude_discounted","categories","category_restricted","customer_restricted","valid_from","valid_until","archived","created_at","updated_at"],"title":"Coupon","type":"object"},"CouponAction":{"additionalProperties":false,"description":"Arşiv eylemlerine boş JSON gönderilir.","properties":{},"title":"CouponAction","type":"object"},"CreateBrand":{"additionalProperties":false,"properties":{"logo":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"description":"Paneldeki ürün markası logosunun URL adresi; null temizler.","examples":[null],"title":"Logo"},"name":{"description":"Ürün markası adı; satıcının sto_ markasından ayrıdır.","examples":["Örnek Üretici"],"maxLength":500,"minLength":1,"title":"Name","type":"string"},"sort_order":{"anyOf":[{"maximum":2147483647,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Sıra; küçük değer önce gelir.","examples":[1],"title":"Sort Order"},"status":{"anyOf":[{"enum":["active","inactive"],"type":"string"},{"type":"null"}],"description":"Vitrinde görünürlük: active açık, inactive kapalı.","examples":["active"],"title":"Status"}},"required":["name"],"title":"CreateBrand","type":"object"},"CreateCategory":{"additionalProperties":false,"properties":{"description":{"anyOf":[{"maxLength":50000,"type":"string"},{"type":"null"}],"description":"Kategori açıklaması; null temizler.","examples":["Mutfak ürünleri"],"title":"Description"},"image":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"description":"Paneldeki kategori görselinin URL adresi; null temizler.","examples":[null],"title":"Image"},"name":{"description":"Kategori adı.","examples":["Mutfak"],"maxLength":500,"minLength":1,"title":"Name","type":"string"},"parent":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Üst cat_ kategori kimliği; null ana kategori yapar.","examples":[null],"title":"Parent"},"sort_order":{"anyOf":[{"maximum":2147483647,"minimum":0,"type":"integer"},{"type":"null"}],"description":"Sıra; küçük değer önce gelir.","examples":[1],"title":"Sort Order"},"status":{"anyOf":[{"enum":["active","inactive"],"type":"string"},{"type":"null"}],"description":"Vitrinde görünürlük: active açık, inactive kapalı.","examples":["active"],"title":"Status"}},"required":["name"],"title":"CreateCategory","type":"object"},"CreateCoupon":{"additionalProperties":false,"examples":[{"code":"MERHABA10","discount_type":"percentage","discount_value":"10.00","max_uses_per_customer":1}],"properties":{"categories":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"type":"array"},{"type":"null"}],"description":"cat_ kimlikleri; alt kategoriler dahil. [] bütün ürünlerde geçerli yapar.","examples":[[]],"title":"Categories"},"code":{"description":"Müşterinin yazacağı kupon kodu.","examples":["MERHABA10"],"maxLength":40,"minLength":1,"title":"Code","type":"string"},"discount_type":{"anyOf":[{"enum":["percentage","fixed"],"type":"string"},{"type":"null"}],"description":"Yüzde veya sabit TRY tutarı; null temizler.","examples":["percentage"],"title":"Discount Type"},"discount_value":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Yüzde oranı veya TRY tutarı; ondalık metin, null temizler.","examples":["10.00"],"title":"Discount Value"},"exclude_discounted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"İndirimli/kampanyalı ürünlere uygulanmayacaksa true.","examples":[false],"title":"Exclude Discounted"},"first_order_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Yalnız ilk siparişte geçerliyse true.","examples":[false],"title":"First Order Only"},"free_shipping":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Kargo da ücretsizse true.","examples":[false],"title":"Free Shipping"},"max_uses":{"anyOf":[{"maximum":2147483647,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Toplam kullanım sınırı; null sınırsız.","examples":[100],"title":"Max Uses"},"max_uses_per_customer":{"anyOf":[{"maximum":2147483647,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Kişi başına kullanım sınırı; null sınırsız.","examples":[1],"title":"Max Uses Per Customer"},"min_order":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Kupona uygun ürünlerin en az TRY tutarı; null kaldırır.","examples":["100.00"],"title":"Min Order"},"status":{"anyOf":[{"enum":["active","inactive"],"type":"string"},{"type":"null"}],"description":"active açık, inactive kapalı.","examples":["active"],"title":"Status"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sto_ marka kimliği; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":[null],"title":"Store"},"valid_from":{"anyOf":[{"maxLength":35,"type":"string"},{"type":"null"}],"description":"Panel gibi markanın yerel günü veya dakikası; YYYY-MM-DD ya da ISO tarih/saat. null sınırı kaldırır.","examples":["2026-10-16"],"title":"Valid From"},"valid_until":{"anyOf":[{"maxLength":35,"type":"string"},{"type":"null"}],"description":"Bitiş günü/dakikası dahildir; saat dilimli ISO zaman markanın saatine çevrilir. null sınırsız.","examples":["2026-12-31T23:59"],"title":"Valid Until"}},"required":["code"],"title":"CreateCoupon","type":"object"},"CreateCustomer":{"additionalProperties":false,"examples":[{"email":"musteri@example.com","name":"Örnek Müşteri","phone":"05000000000"}],"properties":{"address":{"anyOf":[{"$ref":"#/components/schemas/CustomerAddress"},{"type":"null"}],"description":"Müşterinin adresi; null adresi kaldırır. personal_data:write gerekir.","examples":[{}]},"email":{"anyOf":[{"maxLength":320,"type":"string"},{"type":"null"}],"description":"E-posta; null veya boş metin alanı temizler. personal_data:write gerekir.","examples":["musteri@example.com"],"title":"Email"},"invoice":{"anyOf":[{"$ref":"#/components/schemas/CustomerInvoice"},{"type":"null"}],"description":"Fatura bilgisi; null kaldırır. personal_data:write gerekir.","examples":[{"company_name":"Örnek Şirket","tax_number":"1234567890","tax_office":"Kadıköy"}]},"marketing_consent":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Pazarlama izni: true var, false yok, null bilinmiyor. personal_data:write gerekir.","examples":[false],"title":"Marketing Consent"},"name":{"description":"Müşterinin adı; personal_data:write gerekir.","examples":["Örnek Müşteri"],"maxLength":500,"minLength":1,"title":"Name","type":"string"},"note":{"anyOf":[{"maxLength":10000,"type":"string"},{"type":"null"}],"description":"İç not; null veya boş metin kaldırır. internal_notes:write gerekir.","examples":["Teslimden önce bilgi verin."],"title":"Note"},"phone":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"description":"Telefon; null veya boş metin alanı temizler. personal_data:write gerekir.","examples":["05000000000"],"title":"Phone"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sto_ marka kimliği; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"}},"required":["name"],"title":"CreateCustomer","type":"object"},"CreateExternalOrder":{"additionalProperties":false,"examples":[{"channel_name":"Etsy","customer":{"email":"musteri@example.com","name":"Örnek Müşteri"},"external_reference":"ETSY-2026-001","items":[{"quantity":"2","sku":"KUPA-MAVI","unit_price":"120.00"}],"ordered_at":"2026-10-15T09:00:00Z","paid_at":"2026-10-15T09:01:00Z"}],"properties":{"channel_name":{"description":"Satış kanalının en çok 20 karakterlik adı. Baş/son boşluklar kaldırılır; büyük/küçük harfler farklı kanal adlarıdır.","examples":["Etsy"],"maxLength":20,"minLength":1,"title":"Channel Name","type":"string"},"customer":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/OrderCustomer"},{"type":"null"}],"description":"cus_ müşteri kimliği veya müşteri bilgileri; personal_data:write gerekir. E-posta/telefon yoksa yeni müşteri kartı açılmaz.","examples":[null],"title":"Customer"},"external_reference":{"description":"Kanalın sipariş numarası; bu grant ve channel_name içinde kalıcı olarak tekildir.","examples":["ETSY-2026-001"],"maxLength":200,"minLength":1,"title":"External Reference","type":"string"},"fulfillment_status":{"default":"pending","description":"pending: sonra siparis.app ile kargolanabilir; shipped/delivered: kanal kargoladı/teslim etti, burada gönderi açılmaz.","enum":["pending","shipped","delivered"],"examples":["pending"],"title":"Fulfillment Status","type":"string"},"items":{"description":"var_ veya SKU, miktar ve kesinleşmiş birim fiyatıyla satış satırları.","examples":[[{"quantity":"2","sku":"KUPA-MAVI","unit_price":"120.00"}]],"items":{"$ref":"#/components/schemas/ExternalOrderItem"},"maxItems":100,"minItems":1,"title":"Items","type":"array"},"ordered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Kanalda siparişin verildiği saat dilimli tarih; geçmiş kabul edilir, gelecek reddedilir. Atlanırsa kayıt anı.","examples":["2026-10-15T09:00:00Z"],"title":"Ordered At"},"paid_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Kanalın ödemeyi aldığı saat dilimli tarih; gelecek reddedilir. Atlanırsa ordered_at, o da yoksa kayıt anı.","examples":["2026-10-15T09:01:00Z"],"title":"Paid At"},"shipping_address":{"anyOf":[{"$ref":"#/components/schemas/OrderAddress"},{"type":"null"}],"description":"Teslimat adresi; personal_data:write gerekir. Adressiz satış kaydedilir; kargo için adres tamamlanır.","examples":[{"address_line":"Örnek Sokak No: 1","city":"İstanbul","district":"Kadıköy"}]},"shipping_total":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"default":"0","description":"Kanalda müşteriden alınmış TRY kargo ücreti; toplam tahsilata eklenir.","examples":["0.00"],"title":"Shipping Total"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sto_ marka kimliği; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":[null],"title":"Store"}},"required":["channel_name","external_reference","items"],"title":"CreateExternalOrder","type":"object"},"CreateOrder":{"additionalProperties":false,"examples":[{"customer":{"email":"musteri@example.com","name":"Örnek Müşteri","phone":"05000000000"},"delivery_method":"hand","external_reference":{"id":"WEB-2026-001"},"items":[{"quantity":"2","sku":"KUPA-MAVI"}],"paid":true,"payment_method":"cash"}],"properties":{"allow_waiting":{"default":false,"description":"true: stokta olmayan adetler mal gelince gönderilir; panelle aynı açık onaydır.","examples":[false],"title":"Allow Waiting","type":"boolean"},"billing_address":{"anyOf":[{"$ref":"#/components/schemas/OrderAddress"},{"type":"null"}],"description":"Dijital üründe zorunlu fatura adresi; personal_data:write gerekir.","examples":[{"address_line":"Örnek Sokak No: 1","city":"İstanbul","district":"Kadıköy"}]},"cod_type":{"anyOf":[{"enum":["cash","card"],"type":"string"},{"type":"null"}],"description":"Yalnız kargoyla kapıda ödemede: nakit veya kart.","examples":["cash"],"title":"Cod Type"},"coupon_code":{"default":"","description":"Müşteriye tanımlı kupon; mevcut kullanım, süre ve ürün koşulları uygulanır.","examples":["HOSGELDIN"],"maxLength":60,"title":"Coupon Code","type":"string"},"customer":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/OrderCustomer"},{"type":"null"}],"description":"Mevcut cus_ müşteri kimliği veya ad/telefon/e-posta. personal_data:write gerekir. Atlanırsa elden/mağazadan müşterisiz satış.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Customer"},"customer_note":{"default":"","description":"Paketleme fişine de giren müşteri notu; personal_data:write gerekir.","examples":["Teslimden önce arayın."],"maxLength":2000,"title":"Customer Note","type":"string"},"delivery_day":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"description":"Markanın takvimine göre söz verilen teslim günü; dijitalde uygulanmaz.","examples":["2026-10-17"],"title":"Delivery Day"},"delivery_method":{"description":"shipping: kargo; hand: elden; pickup: markadan teslim; digital: dijital teslim.","enum":["shipping","hand","pickup","digital"],"examples":["hand"],"title":"Delivery Method","type":"string"},"deposit":{"anyOf":[{"$ref":"#/components/schemas/PaymentPart"},{"type":"null"}],"description":"Şimdi alınan kapora; toplamdan küçük olmalı. paid=false gönderin.","examples":[{"amount":"120.00","method":"cash"}]},"external_reference":{"anyOf":[{"$ref":"#/components/schemas/ExternalReference"},{"type":"null"}],"description":"Dış sipariş numarasını bu API bağlantısında tekilleştirir; anahtar döndürmek ad alanını değiştirmez.","examples":[{"id":"WEB-2026-001"}]},"items":{"description":"Satılacak seçenekler ve miktarları.","examples":[[{"quantity":"2","sku":"KUPA-MAVI"}]],"items":{"$ref":"#/components/schemas/OrderItem"},"maxItems":100,"minItems":1,"title":"Items","type":"array"},"note":{"default":"","description":"İç not; internal_notes:write gerekir.","examples":["Paket kontrol edildi."],"maxLength":2000,"title":"Note","type":"string"},"paid":{"default":false,"description":"Ödeme gerçekten alındıysa true. Kapıda ödemede false; parçalı ödemede parçalar alınmış sayılır.","examples":[true],"title":"Paid","type":"boolean"},"payment_method":{"anyOf":[{"enum":["cod","bank_transfer","cash","credit_card","split"],"type":"string"},{"type":"null"}],"description":"Paneldeki elle ödeme yolu; credit_card POS kaydıdır, kart çekimi başlatmaz. 0 TL siparişte atlanabilir.","examples":["cash"],"title":"Payment Method"},"payments":{"anyOf":[{"items":{"$ref":"#/components/schemas/PaymentPart"},"maxItems":20,"minItems":2,"type":"array"},{"type":"null"}],"description":"split yönteminde alınan ödeme parçaları; toplam sipariş tutarıyla aynı olmalıdır.","examples":[[{"amount":"100.00","method":"cash"},{"amount":"140.00","method":"pos"}]],"title":"Payments"},"shipping_address":{"anyOf":[{"$ref":"#/components/schemas/OrderAddress"},{"type":"null"}],"description":"Kargoda zorunlu, elden teslimde isteğe bağlı adres; personal_data:write gerekir.","examples":[{"address_line":"Örnek Sokak No: 1","city":"İstanbul","district":"Kadıköy"}]},"shipping_fee":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"TRY teslimat ücreti; atlanırsa panelin marka kuralı, verilirse orders.price izniyle açık tutar.","examples":["0.00"],"title":"Shipping Fee"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Siparişin sto_ marka kimliği; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"}},"required":["items","delivery_method"],"title":"CreateOrder","type":"object"},"CreateProduct":{"additionalProperties":false,"examples":[{"name":"Seramik Kupa","price":"120.00","sku":"KUPA-001"}],"properties":{"barcode":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"description":"Barkod; işletmede canlı seçenekler arasında tekil. null temizler.","examples":["8690000000001"],"title":"Barcode"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Mevcut brd_ ürün markası; null bağı kaldırır. Satıcının sto_ markasıyla karıştırmayın.","examples":[null],"title":"Brand"},"categories":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"type":"array"},{"type":"null"}],"description":"Mevcut cat_ kategori kimlikleri; [] bağları kaldırır. Yeni kategori açmaz.","examples":[[]],"title":"Categories"},"compare_price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Üstü çizili fiyat; null kaldırır. Üründe satış fiyatından yüksek olmalıdır.","examples":["150.00"],"title":"Compare Price"},"cost":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Alış maliyeti; costs:write gerekir. Panel gibi KDV hariç, muaf işletmede KDV dahil saklanır; null kaldırır.","examples":["80.00"],"title":"Cost"},"description":{"anyOf":[{"maxLength":50000,"type":"string"},{"type":"null"}],"description":"Ürün açıklaması; null kaldırır.","examples":["Seramik kupa, 300 ml."],"title":"Description"},"external_reference":{"anyOf":[{"$ref":"#/components/schemas/CatalogReference"},{"type":"null"}],"description":"Bu API bağlantısında ürünün dış kimliği.","examples":[{"id":"ERP-001"}]},"images":{"anyOf":[{"items":{"maxLength":2000,"type":"string"},"maxItems":12,"type":"array"},{"type":"null"}],"description":"En çok 12 http/https görsel URL’si; [] galeriyi boşaltır. Panelin güvenli kopyalama kuyruğu kullanılır.","examples":[[""]],"title":"Images"},"made_to_order":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Sipariş üzerine hazırlanırsa true; mevcut stok korunur.","examples":[false],"title":"Made To Order"},"name":{"description":"Ürün adı.","examples":["Seramik Kupa"],"maxLength":500,"minLength":1,"title":"Name","type":"string"},"opening_stock":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"Seçeneksiz ürünün ilk stoğu; inventory:write gerekir. Seçenekli üründe her seçeneğe yazın.","examples":["10"],"title":"Opening Stock"},"price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"TRY satış fiyatı; ondalık metin. null ürünün fiyatını kaldırır, seçenekte ürün fiyatına döner.","examples":["120.00"],"title":"Price"},"short_description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"description":"Kısa açıklama; null kaldırır.","examples":["Seramik kupa"],"title":"Short Description"},"sku":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Stok kodu; işletmede canlı seçenekler arasında tekil. null temizler.","examples":["KUPA-MAVI"],"title":"Sku"},"status":{"anyOf":[{"enum":["active","draft","inactive"],"type":"string"},{"type":"null"}],"description":"Satış durumu; arşiv için ayrı eylemi kullanın. Fiyatsız ürün satışa açılamaz.","examples":["active"],"title":"Status"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hedef sto_ markası; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":[null],"title":"Store"},"stores":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"},{"type":"null"}],"description":"Birden çok hedef sto_ markası; store ile birlikte gönderilmez.","examples":[["sto_1234567890abcdef1234567890abcdef"]],"title":"Stores"},"tax_rate":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Yüzde KDV oranı; panelin vergi sınıfı doğrulaması kullanılır.","examples":["20"],"title":"Tax Rate"},"unit":{"anyOf":[{"maxLength":20,"minLength":1,"type":"string"},{"type":"null"}],"description":"Satış birimi; panelin miktar doğrulaması kullanılır.","examples":["adet"],"title":"Unit"},"variants":{"anyOf":[{"items":{"$ref":"#/components/schemas/CreateVariant"},"maxItems":500,"minItems":1,"type":"array"},{"type":"null"}],"description":"Ürünle aynı işlemde açılacak seçenekler; bir hata tüm kaydı geri alır.","examples":[[{"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"price_rule":{"kind":"tl","value":"20.00"},"sku":"KUPA-MAVI"}]],"title":"Variants"},"weight":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"Kilogram cinsinden ağırlık; null kaldırır.","examples":["0.350"],"title":"Weight"}},"required":["name"],"title":"CreateProduct","type":"object"},"CreateRefund":{"additionalProperties":false,"examples":[{"expected_amount":"120.00","items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1"}]}],"properties":{"amount":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"İsteğe bağlı TRY tutarı; boşsa panelin önerisi. Kalan tahsilatı aşamaz.","examples":["120.00"],"title":"Amount"},"expected_amount":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Son önizlemenin amount değeri, TRY; değişmişse 409 amount_changed döner.","examples":["120.00"],"title":"Expected Amount"},"items":{"description":"İade kalemleri; boşsa yalnız para iadesidir ve amount zorunludur.","examples":[[]],"items":{"$ref":"#/components/schemas/ReturnItem"},"maxItems":200,"title":"Items","type":"array"},"money_returned":{"default":false,"description":"Parayı gerçekten elle geri verdiyseniz true. Çevrimiçi kartta false bırakın; sağlayıcı sonucu beklenir.","examples":[false],"title":"Money Returned","type":"boolean"},"notify_customer":{"default":true,"description":"İade e-postasını müşteriye gönder.","examples":[true],"title":"Notify Customer","type":"boolean"},"reason":{"default":"","description":"İade nedeni; kişisel bilgi yazmayın.","examples":["Müşteri ürünü iade etti"],"maxLength":200,"title":"Reason","type":"string"},"received_condition":{"anyOf":[{"enum":["sound","damaged"],"type":"string"},{"type":"null"}],"description":"Fiziksel teslim onayı. Fire için damaged ve restock=false birlikte gerekir.","examples":["sound"],"title":"Received Condition"},"refund_distribution":{"anyOf":[{"$ref":"#/components/schemas/Distribution-Input"},{"type":"null"}],"description":"Değişim/ayrılan siparişte önizlemenin kart ve elle ödeme dağılımı; oluştururken aynen gönderin.","examples":[{"card":"100.00","manual":"20.00","provider":"PayTR"}]},"refund_method":{"anyOf":[{"enum":["cash","pos","iban"],"type":"string"},{"type":"null"}],"description":"Panelin izin verdiği elle iade yolu; çevrimiçi karta iade otomatik belirlenir.","examples":[null],"title":"Refund Method"},"refund_parts":{"anyOf":[{"items":{"$ref":"#/components/schemas/RefundPart"},"maxItems":20,"minItems":2,"type":"array"},{"type":"null"}],"description":"Elle geri verilen parçalar; toplam iade tutarına eşit, money_returned=true olmalı.","examples":[null],"title":"Refund Parts"},"restock":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Stoğa geri ekleme seçimi. Boşsa panel/AI varsayılanı: iade edilemez veya hasarlı ürün eklenmez. false tek başına fire yazmaz.","examples":[null],"title":"Restock"}},"required":["expected_amount"],"title":"CreateRefund","type":"object"},"CreateShipment":{"additionalProperties":false,"properties":{"carrier":{"description":"Fiyat yanıtındaki açık kargo firmasının code değeri; standart gönderi hizmeti.","examples":["YURTICI"],"maxLength":40,"minLength":1,"title":"Carrier","type":"string"},"merge_orders":{"description":"Aynı marka, alıcı, adres ve depodaki diğer ord_ siparişleri; birleştirme açık seçimdir.","examples":[[]],"items":{"type":"string"},"maxItems":99,"title":"Merge Orders","type":"array"},"package":{"anyOf":[{"$ref":"#/components/schemas/Package"},{"type":"null"}],"description":"Yalnız bu sorgu için ölçüler; sorgu siparişi değiştirmez. Açarken aynı ölçüleri gönderin.","examples":[{"boxes":[{"depth":20,"height":20,"weight":1,"width":20}]}]}},"required":["carrier"],"title":"CreateShipment","type":"object"},"CreateVariant":{"additionalProperties":false,"examples":[{"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"price_rule":{"kind":"tl","value":"20.00"},"sku":"KUPA-MAVI"}],"properties":{"barcode":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"description":"Barkod; işletmede canlı seçenekler arasında tekil. null temizler.","examples":["8690000000001"],"title":"Barcode"},"compare_price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Üstü çizili fiyat; null kaldırır. Üründe satış fiyatından yüksek olmalıdır.","examples":["150.00"],"title":"Compare Price"},"cost":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Alış maliyeti; costs:write gerekir. Panel gibi KDV hariç, muaf işletmede KDV dahil saklanır; null kaldırır.","examples":["80.00"],"title":"Cost"},"expected_stock":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"İlk seçeneğe dönüşen varsayılanın görülen stoğu; yalnız opening_stock ile kullanılır.","examples":["0"],"title":"Expected Stock"},"external_reference":{"anyOf":[{"$ref":"#/components/schemas/CatalogReference"},{"type":"null"}],"description":"Bu API bağlantısında seçeneğin dış kimliği.","examples":[{"id":"ERP-001"}]},"images":{"anyOf":[{"items":{"maxLength":2000,"type":"string"},"maxItems":12,"type":"array"},{"type":"null"}],"description":"En çok 12 http/https görsel URL’si; [] galeriyi boşaltır. Panelin güvenli kopyalama kuyruğu kullanılır.","examples":[[""]],"title":"Images"},"made_to_order":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Sipariş üzerine hazırlanırsa true; mevcut stok korunur.","examples":[false],"title":"Made To Order"},"name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"description":"Seçeneğin görünen adı; gönderilmezse korunur.","examples":["Mavi"],"title":"Name"},"opening_stock":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"İlk stok; inventory:write gerekir. İlk seçenek mevcut varsayılanı dönüştürürse stok korunur; farklı sayı için expected_stock gerekir.","examples":["10"],"title":"Opening Stock"},"options":{"anyOf":[{"items":{"$ref":"#/components/schemas/CatalogOption"},"maxItems":20,"type":"array"},{"type":"null"}],"description":"Seçeneğin ad/değer çiftleri; gönderilmezse korunur.","examples":[[{"name":"Renk","value":"Mavi"}]],"title":"Options"},"price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"TRY satış fiyatı; ondalık metin. null ürünün fiyatını kaldırır, seçenekte ürün fiyatına döner.","examples":["120.00"],"title":"Price"},"price_rule":{"anyOf":[{"$ref":"#/components/schemas/PriceRule"},{"type":"null"}],"description":"Ürün fiyatından TL veya yüzde farkı; null ürünle aynı fiyat demektir.","examples":[{"kind":"tl","value":"20.00"}]},"sku":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Stok kodu; işletmede canlı seçenekler arasında tekil. null temizler.","examples":["KUPA-MAVI"],"title":"Sku"},"weight":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"Kilogram cinsinden ağırlık; null kaldırır.","examples":["0.350"],"title":"Weight"}},"title":"CreateVariant","type":"object"},"Customer":{"additionalProperties":false,"examples":[{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":1,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"}],"properties":{"address":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"Müşteri adresi; personal_data:read yoksa alan atlanır.","examples":[{}]},"archived":{"description":"Arşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.","examples":[false],"title":"Archived","type":"boolean"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"E-posta; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Email"},"id":{"description":"Kaynağın dış kimliği; cus_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"instagram":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Instagram kullanıcı adı; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Instagram"},"invoice":{"anyOf":[{"$ref":"#/components/schemas/Billing"},{"type":"null"}],"description":"Fatura alıcı bilgileri; personal_data:read yoksa alan atlanır.","examples":[{}]},"marketing_consent":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Pazarlama iletişimi izni; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Marketing Consent"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Müşteri adı; personal_data:read yoksa alan atlanır.","examples":[null],"title":"Name"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İç not; internal_notes:read gerekir. Kişisel kaynakta personal_data:read da gerekir.","examples":["Örnek iç not"],"title":"Note"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Telefon; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Phone"},"revision":{"description":"Müşteri kartının artan sürümü; ETag ve If-Match ile birlikte kullanılır.","examples":[1],"minimum":1,"title":"Revision","type":"integer"},"store":{"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","revision","store","created_at","updated_at","archived"],"title":"Customer","type":"object"},"CustomerAction":{"additionalProperties":false,"description":"Arşiv eylemleri boş JSON nesnesi alır; kişisel alan yazmaz.","properties":{},"title":"CustomerAction","type":"object"},"CustomerAddress":{"additionalProperties":false,"properties":{"address_line":{"default":"","description":"Açık adres.","examples":["Örnek Sokak No: 1"],"maxLength":1000,"title":"Address Line","type":"string"},"city":{"default":"","description":"İl.","examples":["İstanbul"],"maxLength":100,"title":"City","type":"string"},"district":{"default":"","description":"İlçe.","examples":["Kadıköy"],"maxLength":100,"title":"District","type":"string"},"neighborhood":{"default":"","description":"Mahalle veya köy adı.","examples":["Caferağa"],"maxLength":100,"title":"Neighborhood","type":"string"},"neighborhood_area":{"default":"","description":"Varsa bağlı köy, semt veya belde.","examples":[""],"maxLength":100,"title":"Neighborhood Area","type":"string"},"postal_code":{"default":"","description":"Posta kodu.","examples":["34710"],"maxLength":10,"title":"Postal Code","type":"string"},"village":{"default":false,"description":"Köy adresiyse true.","examples":[false],"title":"Village","type":"boolean"}},"title":"CustomerAddress","type":"object"},"CustomerInvoice":{"additionalProperties":false,"properties":{"company_name":{"description":"Şirket faturası için firma unvanı; panelin doğrulaması uygulanır.","examples":["Örnek Şirket"],"maxLength":500,"title":"Company Name","type":"string"},"tax_number":{"description":"Vergi veya kimlik numarası; panelin VKN/TCKN doğrulaması uygulanır.","examples":["1234567890"],"maxLength":50,"title":"Tax Number","type":"string"},"tax_office":{"description":"Vergi dairesi; şirket faturasında zorunludur.","examples":["Kadıköy"],"maxLength":200,"title":"Tax Office","type":"string"}},"required":["company_name","tax_office","tax_number"],"title":"CustomerInvoice","type":"object"},"CustomersExportFilters":{"additionalProperties":false,"properties":{"email":{"anyOf":[{"maxLength":320,"minLength":1,"type":"string"},{"type":"null"}],"description":"Ham e-posta; sunucu email_key kolonunun normalleştirmesiyle tam eşitlik arar. personal_data:read gerekir.","examples":["Ornek@Example.com"],"title":"Email"},"email_key":{"anyOf":[{"maxLength":320,"minLength":1,"type":"string"},{"type":"null"}],"description":"Normalize edilmiş e-posta; tam eşitlik araması; personal_data:read gerekir.","examples":["ornek@example.com"],"title":"Email Key"},"phone":{"anyOf":[{"maxLength":50,"minLength":1,"type":"string"},{"type":"null"}],"description":"Ham telefon; mevcut müşteri kuralıyla son 10 haneye çevrilir. personal_data:read gerekir.","examples":["+90 500 000 00 00"],"title":"Phone"},"phone_key":{"anyOf":[{"pattern":"^\\d{10}$","type":"string"},{"type":"null"}],"description":"Telefonun son 10 hanesi; tam eşitlik araması; personal_data:read gerekir.","examples":["0000000000"],"title":"Phone Key"},"sort":{"default":"updated_at","description":"updated_at: son değişiklikten ileri; -created_at: en yeni müşteri önce. Sıra değişirse yeni sayfalama başlatın.","enum":["updated_at","-created_at"],"examples":["-created_at"],"title":"Sort","type":"string"}},"title":"CustomersExportFilters","type":"object"},"CustomersExportInput":{"additionalProperties":false,"properties":{"filters":{"$ref":"#/components/schemas/CustomersExportFilters","description":"Kaynağın liste süzgeçleri; limit, cursor ve include desteklenmez.","examples":[{}]},"format":{"description":"jsonl: satır başına JSON nesnesi; csv: her hücresi JSON değeri olan CSV.","enum":["jsonl","csv"],"examples":["jsonl"],"title":"Format","type":"string"},"mode":{"const":"consistent_snapshot","description":"consistent_snapshot: bütün kayıtlar aynı anın tutarlı görünümüdür.","examples":["consistent_snapshot"],"title":"Mode","type":"string"},"resource":{"const":"customers","description":"Dışa aktarılacak kaynak; aynı kaynağın okuma kapsamı gerekir.","examples":["customers"],"title":"Resource","type":"string"}},"required":["mode","format","resource"],"title":"CustomersExportInput","type":"object"},"Decision":{"additionalProperties":false,"properties":{"carrier":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"description":"Gelen kargo firması kodu; boşsa panelin varsayılanı.","examples":[null],"title":"Carrier"},"note":{"default":"","description":"Müşteriye gösterilecek onay notu veya ret nedeni.","examples":["Talebiniz onaylandı"],"maxLength":300,"title":"Note","type":"string"},"notify_customer":{"default":true,"description":"Karar e-postasını müşteriye gönder.","examples":[true],"title":"Notify Customer","type":"boolean"},"return_code":{"default":false,"description":"Açık seçimle geri gönderim kodu aç: BasitKargo bakiyenizden ücretlidir, shipments:write gerekir. Varsayılan false: kodsuz teslim.","examples":[false],"title":"Return Code","type":"boolean"}},"title":"Decision","type":"object"},"DeliverOrder":{"additionalProperties":false,"properties":{"collection_method":{"anyOf":[{"enum":["cash","pos","bank","later"],"type":"string"},{"type":"null"}],"description":"Teslimde kalan ödemenin yöntemi; later panelde açıkken borcu korur.","examples":["cash"],"title":"Collection Method"},"expected_status":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"description":"Gördüğünüz sipariş durumu; kilit altında farklıysa 409 status_mismatch.","examples":["confirmed"],"title":"Expected Status"},"reason":{"default":"","description":"İşlemin gerekçesi; correct-status ve başka kanalda bildirilen satışın iptali için zorunlu.","examples":["Müşteri teslim aldı."],"maxLength":1000,"title":"Reason","type":"string"}},"title":"DeliverOrder","type":"object"},"Delivery":{"additionalProperties":false,"properties":{"attempt_count":{"description":"Bu teslim için yapılmış deneme sayısı.","examples":[0],"title":"Attempt Count","type":"integer"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"event":{"description":"Olay kimliği (evt_ ve 32 küçük onaltılık karakter).","examples":["evt_1234567890abcdef1234567890abcdef"],"title":"Event","type":"string"},"id":{"description":"Kaynağın dış kimliği; whd_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["whd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Son teslim hatasının kararlı kodu; hata yoksa null.","examples":[null],"title":"Last Error"},"last_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Son teslim denemesinin HTTP durum kodu; ağ hatasında null.","examples":[null],"title":"Last Status"},"next_attempt_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Sonraki teslim denemesi zamanı; RFC 3339 UTC. Değer yoksa null.","examples":["2026-10-16T09:00:00Z"],"title":"Next Attempt At"},"status":{"description":"Teslimin durumu: pending, succeeded, failed veya cancelled.","examples":["pending"],"title":"Status","type":"string"},"type":{"description":"İşlem veya olay türü.","examples":["order.created"],"title":"Type","type":"string"}},"required":["id","event","type","status","attempt_count","created_at","next_attempt_at","last_status","last_error"],"title":"Delivery","type":"object"},"Distribution-Input":{"additionalProperties":false,"properties":{"card":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Kaynak karta gönderilecek TRY tutarı.","examples":["100.00"],"title":"Card"},"manual":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Elle iade edilecek TRY tutarı.","examples":["20.00"],"title":"Manual"},"provider":{"description":"Önizlemede görünen ödeme kuruluşu adı; aynen gönderin.","examples":["PayTR"],"maxLength":100,"title":"Provider","type":"string"}},"required":["card","manual","provider"],"title":"Distribution","type":"object"},"Distribution-Output":{"additionalProperties":false,"properties":{"card":{"description":"Kaynak karta gönderilecek TRY tutarı.","examples":["100.00"],"title":"Card","type":"string"},"manual":{"description":"Elle iade edilecek TRY tutarı.","examples":["20.00"],"title":"Manual","type":"string"},"provider":{"description":"Önizlemede görünen ödeme kuruluşu adı; aynen gönderin.","examples":["PayTR"],"maxLength":100,"title":"Provider","type":"string"}},"required":["card","manual","provider"],"title":"Distribution","type":"object"},"Document":{"additionalProperties":false,"properties":{"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"id":{"description":"Kaynağın dış kimliği; doc_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["doc_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"invoice_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"description":"Tedarikçi fatura tarihi; YYYY-MM-DD; costs:read gerekir.","examples":["2026-10-16"],"title":"Invoice Date"},"invoice_number":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Tedarikçi fatura numarası; costs:read gerekir.","examples":["TEST2026000000001"],"title":"Invoice Number"},"kind":{"description":"Stok belgesinin türü.","examples":["receipt"],"title":"Kind","type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Depo kimliği (loc_ ve 32 küçük onaltılık karakter).","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location"},"movements":{"$ref":"#/components/schemas/Page_Movement_","description":"Bu belgeye ait görünür stok hareketleri; limit/cursor ile ilerleyin.","examples":[{"data":[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}],"has_more":false,"next_cursor":null}]},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İç not; internal_notes:read gerekir. Kişisel kaynakta personal_data:read da gerekir.","examples":["Örnek iç not"],"title":"Note"},"reversed_by":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Bu belgeyi tersine çeviren belge kimliği (doc_ ve 32 küçük onaltılık karakter).","examples":[null],"title":"Reversed By"},"reverses":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ters kaydı oluşturulan belge kimliği (doc_ ve 32 küçük onaltılık karakter).","examples":[null],"title":"Reverses"},"revision":{"description":"Belgenin sürümü: ilk kayıtta 1, ters kaydı varsa 2. ETag aynı değeri taşır.","examples":[1],"minimum":1,"title":"Revision","type":"integer"},"supplier":{"anyOf":[{"$ref":"#/components/schemas/Supplier"},{"type":"null"}],"description":"Tedarikçi kimliği ve adı; costs:read gerekir; iletişim bilgileri yayımlanmaz.","examples":[{"id":"sup_1234567890abcdef1234567890abcdef","name":"Örnek Tedarikçi"}]},"to_location":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hedef depo kimliği (loc_ ve 32 küçük onaltılık karakter).","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"To Location"}},"required":["revision","id","kind","location","to_location","reverses","reversed_by","created_at","movements"],"title":"Document","type":"object"},"Endpoint":{"additionalProperties":false,"properties":{"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"event_types":{"description":"Dinlenecek olay türleri; jokerler oluşturma anındaki izinli türlere sabitlenir.","examples":[["order.created"]],"items":{"type":"string"},"title":"Event Types","type":"array"},"grant":{"description":"API bağlantısı kimliği (grt_ ve 32 küçük onaltılık karakter).","examples":["grt_1234567890abcdef1234567890abcdef"],"title":"Grant","type":"string"},"id":{"description":"Kaynağın dış kimliği; whe_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"last_attempt_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Son teslim denemesi zamanı; RFC 3339 UTC. Değer yoksa null.","examples":[null],"title":"Last Attempt At"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Son teslim hatasının kararlı kodu; hata yoksa null.","examples":[null],"title":"Last Error"},"last_success_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Son başarılı teslim zamanı; RFC 3339 UTC. Değer yoksa null.","examples":[null],"title":"Last Success At"},"previous_secret_until":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Önceki webhook sırrının geçerlilik sonu zamanı; RFC 3339 UTC. Değer yoksa null.","examples":[null],"title":"Previous Secret Until"},"schema_version":{"description":"Olay yükünün şema sürümü.","examples":[1],"title":"Schema Version","type":"integer"},"status":{"description":"pending_test: deneme bekliyor; active: açık; disabled_auto: hatalarla durdu; disabled_remote: alıcı 410 verdi; closed: kapalı.","enum":["pending_test","active","disabled_auto","disabled_remote","closed"],"examples":["pending_test"],"title":"Status","type":"string"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"},"store_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Webhook adresinin bağlı olduğu markanın görünen adı.","examples":["Örnek Marka"],"title":"Store Name"},"url":{"description":"Genel internete açık, kullanıcı bilgisi içermeyen HTTPS webhook adresi; port 443.","examples":["https://example.com/webhooks/siparis"],"title":"Url","type":"string"}},"required":["id","grant","url","event_types","store","store_name","schema_version","status","created_at","last_attempt_at","last_success_at","last_error","previous_secret_until"],"title":"Endpoint","type":"object"},"EndpointInput":{"additionalProperties":false,"properties":{"event_types":{"description":"Dinlenecek olay türleri; jokerler oluşturma anındaki izinli türlere sabitlenir.","examples":[["order.created"]],"items":{"type":"string"},"maxItems":100,"minItems":1,"title":"Event Types","type":"array"},"grant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"API bağlantısı kimliği (grt_ ve 32 küçük onaltılık karakter).","examples":["grt_1234567890abcdef1234567890abcdef"],"title":"Grant"},"schema_version":{"const":1,"default":1,"description":"Olay yükünün şema sürümü.","examples":[1],"title":"Schema Version","type":"integer"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"},"url":{"description":"Genel internete açık, kullanıcı bilgisi içermeyen HTTPS webhook adresi; port 443.","examples":["https://example.com/webhooks/siparis"],"maxLength":2000,"title":"Url","type":"string"}},"required":["url","event_types"],"title":"EndpointInput","type":"object"},"EndpointPatch":{"additionalProperties":false,"examples":[{"event_types":["order.created"]}],"properties":{"event_types":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"},{"type":"null"}],"description":"Dinlenecek olay türleri; jokerler oluşturma anındaki izinli türlere sabitlenir.","examples":[["order.created"]],"title":"Event Types"},"schema_version":{"anyOf":[{"const":1,"type":"integer"},{"type":"null"}],"description":"Olay yükünün şema sürümü.","examples":[1],"title":"Schema Version"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"},"url":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"description":"Genel internete açık, kullanıcı bilgisi içermeyen HTTPS webhook adresi; port 443.","examples":["https://example.com/webhooks/siparis"],"title":"Url"}},"title":"EndpointPatch","type":"object"},"EndpointResult":{"additionalProperties":false,"properties":{"endpoint":{"$ref":"#/components/schemas/Endpoint","description":"Webhook adresinin güncel durumu.","examples":[{"created_at":"2026-10-16T09:00:00Z","event_types":["order.created"],"grant":"grt_1234567890abcdef1234567890abcdef","id":"whe_1234567890abcdef1234567890abcdef","last_attempt_at":null,"last_error":null,"last_success_at":null,"previous_secret_until":null,"schema_version":1,"status":"pending_test","store":"sto_1234567890abcdef1234567890abcdef","store_name":"Örnek Marka","url":"https://example.com/webhooks/siparis"}]},"secret":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Yalnız oluşturma/döndürmenin ilk yanıtında bir kez gösterilen whsec_ imza sırrı; Idempotent-Replayed yanıtında alan yoktur. Güvenli ortam değişkeninde saklayın.","examples":["whsec_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="],"title":"Secret"}},"required":["endpoint"],"title":"EndpointResult","type":"object"},"Event":{"additionalProperties":false,"properties":{"actor":{"$ref":"#/components/schemas/EventActor","description":"İşlemi yapanın türü; kişi veya ekip üyesi kimliği verilmez.","examples":[{"type":"user"}]},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"data":{"$ref":"#/components/schemas/EventData","description":"Olayın kişisel veri içermeyen kaynak kimliği ve değişiklik özeti.","examples":[{"changes":{"current":{},"previous":{}},"object":{"id":"ord_1234567890abcdef1234567890abcdef"}}]},"id":{"description":"Kaynağın dış kimliği; evt_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["evt_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"livemode":{"description":"Gerçek ortamda oluşan olay için true.","examples":[true],"title":"Livemode","type":"boolean"},"schema_version":{"const":1,"description":"Olay yükünün şema sürümü.","examples":[1],"title":"Schema Version","type":"integer"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"},"type":{"$ref":"#/components/schemas/EventType","description":"İşlem veya olay türü.","examples":["order.created"]}},"required":["id","type","schema_version","livemode","created_at","store","data","actor"],"title":"Event","type":"object"},"EventActor":{"additionalProperties":false,"properties":{"type":{"description":"İşlemi yapanın türü; user, api veya system gibi; kişi kimliği yoktur.","examples":["user"],"title":"Type","type":"string"}},"required":["type"],"title":"EventActor","type":"object"},"EventChanges":{"additionalProperties":false,"properties":{"current":{"$ref":"#/components/schemas/EventState","description":"Olaydan sonraki değişen alanlar; güncel kaydı kaynak ucundan okuyun.","examples":[{}]},"previous":{"$ref":"#/components/schemas/EventState","description":"Olaydan önceki değişen alanlar; tüm kaynağın kopyası değildir.","examples":[{}]}},"required":["previous","current"],"title":"EventChanges","type":"object"},"EventData":{"additionalProperties":false,"properties":{"changes":{"$ref":"#/components/schemas/EventChanges","description":"Değişen alanların önceki ve sonraki değerleri.","examples":[{"current":{},"previous":{}}]},"object":{"$ref":"#/components/schemas/EventObject","description":"Değişen kaynağın dış kimliği ve ilişkileri; kişisel veri içermez.","examples":[{"id":"ord_1234567890abcdef1234567890abcdef"}]}},"required":["object","changes"],"title":"EventData","type":"object"},"EventItem":{"additionalProperties":false,"properties":{"product":{"description":"Abonelikteki ürünün prd_ kimliği.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product","type":"string"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçilen seçeneğin var_ kimliği; seçeneksiz üründe null.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["product"],"title":"EventItem","type":"object"},"EventObject":{"additionalProperties":false,"properties":{"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Satış kanalının türü: trendyol, hepsiburada, ikas, wix, woocommerce, ticimax veya ideasoft; kanaldan gelen siparişin source değeriyle aynıdır.","examples":["trendyol"],"title":"Channel"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kuponun olay anındaki kodu.","examples":["MERHABA10"],"title":"Code"},"customer":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Aboneliğin müşteri kartının cus_ kimliği; misafir aboneliğinde alan yoktur. Ad ve iletişim bilgisi olayda yoktur.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Customer"},"id":{"description":"Kaynağın dış kimliği; ord_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"items":{"anyOf":[{"items":{"$ref":"#/components/schemas/EventItem"},"type":"array"},{"type":"null"}],"description":"Aboneliğin olay anındaki ürün satırları (sırayla, en çok 50); adet ve kişiselleştirme metni yoktur.","examples":[[{"product":"prd_1234567890abcdef1234567890abcdef"}]],"title":"Items"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stok belgesinin türü: receipt, count, loss veya transfer.","examples":["receipt"],"title":"Kind"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Depo kimliği (loc_ ve 32 küçük onaltılık karakter).","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location"},"number":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Siparişin görünen numarası; kimlik değildir.","examples":[48273910],"title":"Number"},"order":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sipariş kimliği (ord_ ve 32 küçük onaltılık karakter).","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Order"},"product":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçeneğin bağlı olduğu ürünün prd_ kimliği.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product"},"reverses":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ters kayıt olayında özgün doc_ belge kimliği.","examples":["doc_1234567890abcdef1234567890abcdef"],"title":"Reverses"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçenek kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["id"],"title":"EventObject","type":"object"},"EventPage":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{},"previous":{}},"object":{"id":"ord_1234567890abcdef1234567890abcdef"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"order.created"}]],"items":{"$ref":"#/components/schemas/Event"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"description":"Her yanıtta döner; boş/son sayfada da kaydedin. has_more=false olunca bekleyip bu imleçle yeniden okuyun.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Next Cursor","type":"string"}},"required":["data","has_more","next_cursor"],"title":"EventPage","type":"object"},"EventState":{"additionalProperties":false,"properties":{"amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İşlem tutarı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Amount"},"anonymized":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Kişisel alanlar anonimleştirildiyse true.","examples":[false],"title":"Anonymized"},"archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Arşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.","examples":[false],"title":"Archived"},"cod_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kapıda tahsil edilecek sipariş payı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Cod Amount"},"cod_collected":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kapıda tahsil edilmiş tutar; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Cod Collected"},"cod_release":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kargo firmasından aktarılmış tutar; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Cod Release"},"cod_state":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kapıda ödeme tahsilatının kargo firmasından bağımsız ortak durumu; tanınmayan kodda null.","examples":["collected"],"title":"Cod State"},"cod_status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kargo firmasının kapıda ödeme tahsilat kodu (ör. BasitKargo’nun COLLECTED kodu); firmadan bağımsız değer cod_state alanındadır.","examples":["COLLECTED"],"title":"Cod Status"},"compare_price":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Karşılaştırma fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["150.00"],"title":"Compare Price"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ödeme tutarının ISO 4217 para birimi.","examples":["TRY"],"title":"Currency"},"customer_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Kuponun tanımlı olduğu müşteri sayısı; 0 herkese açık. Müşteri kimlikleri olayda yoktur.","examples":[0],"title":"Customer Count"},"discount_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kupon indirimi: percentage yüzde, fixed TRY tutarı; yalnız ücretsiz kargo kuponunda null.","examples":["percentage"],"title":"Discount Type"},"discount_value":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kupon indirim oranı veya TRY tutarı; ondalık metin.","examples":["10.00"],"title":"Discount Value"},"interval_weeks":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Aboneliğin teslimat sıklığı, hafta.","examples":[2],"title":"Interval Weeks"},"item_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"İade/değişim kaydındaki ürün satırı sayısı; ürün adedi değildir.","examples":[2],"title":"Item Count"},"linked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Ürün markaya bağlıysa true.","examples":[true],"title":"Linked"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Başarısız denemenin ödeme yöntemi.","examples":["card"],"title":"Method"},"min_order":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kupona uygun ürünlerde en az sepet tutarı, TRY; null sınırsız.","examples":["100.00"],"title":"Min Order"},"next_date":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Aboneliğin sonraki teslimat günü; markanın takvim günü (YYYY-MM-DD).","examples":["2026-11-06"],"title":"Next Date"},"period":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Yenileme siparişinin teslimat günü (YYYY-MM-DD); yalnız subscription.renewed olayında.","examples":["2026-10-23"],"title":"Period"},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Satış fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Price"},"problem":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kanal bağlantısının sorunu: authorization (anahtar veya yetki geçersiz; stok gitmez, sipariş gelmez) veya app_removed (Wix uygulaması kaldırıldı); sorun yoksa null. Kanalın hata metni gönderilmez.","examples":["authorization"],"title":"Problem"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kart ödemesinin sağlayıcısı.","examples":["iyzico"],"title":"Provider"},"provider_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Güvenli ret anlamı: declined veya insufficient_funds. Ham sağlayıcı metni ve kart bilgisi yoktur.","examples":["declined"],"title":"Provider Code"},"quantity":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Miktar; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["1.000"],"title":"Quantity"},"refund_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İade kaynağındaki tutar olgusu, TRY; para ödendiği anlamına gelmez. Ödeme refund.succeeded olayıdır.","examples":["120.00"],"title":"Refund Amount"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Gönderide kargo firmasından bağımsız ortak durum; status firmanın kodudur. Açılış beklerken, başarısızlıkta ve tanınmayan kodda null.","examples":["delivered"],"title":"State"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kaynağın işlem durumu.","examples":["active"],"title":"Status"},"threshold":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Düşük stok uyarısının dışlayıcı eşiği; ürünün stok biriminde ondalık metin. Miktar bu değerin altına indiğinde uyarır.","examples":["3.000"],"title":"Threshold"},"total":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Faturanın KDV dahil toplamı, TRY cinsinden iki ondalıklı metin.","examples":["120.00"],"title":"Total"},"valid_from":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kuponun markanın yerel takvimindeki başlangıç günü (YYYY-MM-DD) veya dakikası (YYYY-MM-DDTHH:MM); null sınırsız.","examples":["2026-10-16"],"title":"Valid From"},"valid_until":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kuponun markanın yerel takvimindeki bitiş günü veya dakikası; gün ve son dakika dahildir. null sınırsız.","examples":["2026-12-31T23:59"],"title":"Valid Until"}},"title":"EventState","type":"object"},"EventType":{"enum":["job.completed","order.created","order.updated","order.status_changed","collection.recorded","collection.reversed","refund.succeeded","payment.failed","return.requested","return.approved","return.rejected","return.received","return.closed","invoice.issued","invoice.failed","invoice.cancelled","shipment.created","shipment.status_changed","shipment.cod_changed","inventory.level_changed","inventory.low","inventory.document_created","inventory.document_reversed","product.created","product.updated","product.archived","product.restored","variant.created","variant.updated","variant.archived","variant.restored","store_product.linked","store_product.unlinked","store_price.updated","customer.created","customer.updated","customer.archived","customer.restored","customer.anonymized","subscription.created","subscription.renewed","subscription.payment_issue","subscription.paused","subscription.resumed","subscription.cancelled","coupon.created","coupon.updated","coupon.archived","coupon.restored","channel.order_imported","channel.problem","channel.recovered","webhook.test"],"title":"EventType","type":"string"},"Export":{"additionalProperties":false,"properties":{"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Tamamlanma zamanı; RFC 3339 UTC. Hazır değilse null.","examples":[null],"title":"Completed At"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hazırlama başarısızsa kod: export_too_large (süzgeçle daraltın), snapshot_timeout (daha küçük dosya isteyin), export_access_changed (güncel izinlerle yeniden başlatın); diğer hatalarda destek alın. Başarıda null.","examples":[null],"title":"Error Code"},"file":{"anyOf":[{"$ref":"#/components/schemas/ExportFile"},{"type":"null"}],"description":"Tamamlanmış dosya bilgisi; hazırlama sürerken null.","examples":[null]},"format":{"description":"jsonl: satır başına JSON nesnesi; csv: her hücresi JSON değeri olan CSV.","enum":["jsonl","csv"],"examples":["jsonl"],"title":"Format","type":"string"},"id":{"description":"Kaynağın dış kimliği; exp_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["exp_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"mode":{"const":"consistent_snapshot","default":"consistent_snapshot","description":"consistent_snapshot: bütün kayıtlar aynı anın tutarlı görünümüdür.","examples":["consistent_snapshot"],"title":"Mode","type":"string"},"resource":{"description":"Dışa aktarılacak kaynak; aynı kaynağın okuma kapsamı da gerekir.","enum":["orders","customers","products","variants","inventory_levels"],"examples":["orders"],"title":"Resource","type":"string"},"resume_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Dosya tamamen uygulandıktan sonra /events cursor parametresine verilir; types eklenmez. Hazır değilse null.","examples":[null],"title":"Resume Cursor"},"row_count":{"description":"Dosyaya yazılmış nesne sayısı.","examples":[0],"title":"Row Count","type":"integer"},"status":{"description":"queued: sırada; running: hazırlanıyor; completed: hazır; failed: başarısız.","enum":["queued","running","completed","failed"],"examples":["queued"],"title":"Status","type":"string"}},"required":["id","resource","format","status","created_at","completed_at","row_count","resume_cursor","file","error_code"],"title":"Export","type":"object"},"ExportFile":{"additionalProperties":false,"properties":{"bytes":{"description":"Dosyanın bayt cinsinden boyutu.","examples":[2048],"title":"Bytes","type":"integer"},"content_type":{"description":"İndirilecek dosyanın içerik türü.","examples":["application/x-ndjson"],"title":"Content Type","type":"string"},"download_path":{"description":"API kökenine eklenecek /v1/files/fil_… yolu; Bearer anahtarı gerekir.","examples":["/v1/files/fil_1234567890abcdef1234567890abcdef"],"title":"Download Path","type":"string"},"expires_at":{"description":"Dışa aktarmanın created_at zamanından tam 7 gün sonrası; bu anda indirme 410 file_expired döner.","examples":["2026-10-23T09:00:00Z"],"format":"date-time","title":"Expires At","type":"string"},"id":{"description":"Kaynağın dış kimliği; fil_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["fil_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},"required":["id","download_path","content_type","bytes","expires_at"],"title":"ExportFile","type":"object"},"ExternalOrderItem":{"additionalProperties":false,"examples":[{"quantity":"2","sku":"KUPA-MAVI","unit_price":"120.00"}],"properties":{"quantity":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"}],"description":"Miktar; en çok üç ondalık hane. Adetle satılan üründe tam sayı gerekir.","examples":["2"],"title":"Quantity"},"sku":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"description":"Stok kodu; baş/son boşluk ve harf farkı kaldırılarak tam eşleşir.","examples":["KUPA-MAVI"],"title":"Sku"},"unit_price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Kanalda kesinleşmiş KDV dahil TRY birim satış fiyatı; zorunludur. Kampanya uygulanmaz.","examples":["120.00"],"title":"Unit Price"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"var_ dış kimliği; variant veya sku alanından tam biri gerekir.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["quantity","unit_price"],"title":"ExternalOrderItem","type":"object"},"ExternalReference":{"additionalProperties":false,"properties":{"id":{"description":"Kendi sisteminizdeki sipariş numarası; bu API bağlantısında tekildir.","examples":["WEB-2026-001"],"maxLength":200,"minLength":1,"title":"Id","type":"string"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ad alanı kalıcı grant kimliğidir (grt_). Atlayabilirsiniz; başka ad alanı seçilemez.","examples":[null],"title":"Namespace"}},"required":["id"],"title":"ExternalReference","type":"object"},"FieldError":{"additionalProperties":false,"properties":{"code":{"description":"Alan doğrulamasının kararlı kodu.","examples":["less_than_equal"],"title":"Code","type":"string"},"detail":{"description":"Hatanın Türkçe açıklaması.","examples":["İstek alanlarını kontrol edin."],"title":"Detail","type":"string"},"field":{"description":"Hatalı alanın noktayla ayrılmış yolu.","examples":["query.limit"],"title":"Field","type":"string"}},"required":["field","code","detail"],"title":"FieldError","type":"object"},"History":{"additionalProperties":false,"examples":[{"actor_type":"user","created_at":"2026-10-16T09:00:00Z","previous_status":"pending","status":"confirmed","type":"order.status_changed"}],"properties":{"actor_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İşlemi yapanın türü; kişi kimliği yayımlanmaz.","examples":["user"],"title":"Actor Type"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"previous_status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Değişiklik öncesindeki durum.","examples":["pending"],"title":"Previous Status"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kaynağın işlem durumu.","examples":["active"],"title":"Status"},"type":{"description":"İşlem veya olay türü.","examples":["order.created"],"title":"Type","type":"string"}},"required":["type","actor_type","created_at","previous_status","status"],"title":"History","type":"object"},"Identity":{"additionalProperties":false,"properties":{"actor_type":{"default":"api","description":"API anahtarı için api, OAuth kurulumu için app.","examples":["app"],"title":"Actor Type","type":"string"},"api_url":{"description":"Bu ortamın /v1 içeren temel adresi.","examples":["https://api.siparis.app/v1"],"title":"Api Url","type":"string"},"api_version":{"description":"API ana sürümü.","examples":["v1"],"title":"Api Version","type":"string"},"application":{"anyOf":[{"$ref":"#/components/schemas/ApplicationIdentity"},{"type":"null"}],"description":"OAuth uygulaması ve kurulumu; API anahtarında boş.","examples":[null]},"environment":{"description":"Bağlantının ortamı: live veya test.","examples":["live","test"],"title":"Environment","type":"string"},"id":{"description":"Kaynağın dış kimliği; grt_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["grt_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"scopes":{"description":"Bu API bağlantısına açık kapsamlar; yazma kapsamı okuma vermez.","examples":[["orders:read","events:read"]],"items":{"type":"string"},"title":"Scopes","type":"array"},"stores":{"description":"Anahtarın okuyabildiği etkin markalar.","examples":[[{"id":"sto_1234567890abcdef1234567890abcdef","name":"Örnek Marka"}]],"items":{"$ref":"#/components/schemas/Brand"},"title":"Stores","type":"array"}},"required":["id","scopes","stores","environment","api_version","api_url"],"title":"Identity","type":"object"},"InventoryLevelsExportFilters":{"additionalProperties":false,"properties":{"archived":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Depo dış kimliği (loc_ ve 32 küçük onaltılık karakter).","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location"},"product":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product"},"updated_after":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç dahil; saat dilimli RFC 3339 zamanı.","examples":["2026-10-16T09:00:00Z"],"title":"Updated After"},"updated_before":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş hariç; saat dilimli RFC 3339 zamanı.","examples":["2026-10-17T09:00:00Z"],"title":"Updated Before"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"title":"InventoryLevelsExportFilters","type":"object"},"InventoryLevelsExportInput":{"additionalProperties":false,"properties":{"filters":{"$ref":"#/components/schemas/InventoryLevelsExportFilters","description":"Kaynağın liste süzgeçleri; limit, cursor ve include desteklenmez.","examples":[{}]},"format":{"description":"jsonl: satır başına JSON nesnesi; csv: her hücresi JSON değeri olan CSV.","enum":["jsonl","csv"],"examples":["jsonl"],"title":"Format","type":"string"},"mode":{"const":"consistent_snapshot","description":"consistent_snapshot: bütün kayıtlar aynı anın tutarlı görünümüdür.","examples":["consistent_snapshot"],"title":"Mode","type":"string"},"resource":{"const":"inventory_levels","description":"Dışa aktarılacak kaynak; aynı kaynağın okuma kapsamı gerekir.","examples":["inventory_levels"],"title":"Resource","type":"string"}},"required":["mode","format","resource"],"title":"InventoryLevelsExportInput","type":"object"},"Invoice":{"additionalProperties":false,"examples":[{"cancelled_at":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"inv_1234567890abcdef1234567890abcdef","issued_at":"2026-10-16T09:00:00Z","kind":"e_arsiv","status":"issued","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T09:00:00Z"}],"properties":{"buyer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alıcı adı; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Buyer Name"},"buyer_tax_number":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Alıcı vergi/kimlik numarası; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Buyer Tax Number"},"cancellation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İptal isteğinin durumu; iptal istenmediyse alan atlanır. Değerler: pending, unknown, failed, succeeded. Türkçe karşılıkları: https://developer.siparis.app/referans#fatura-iptal-durumlari.","examples":[null],"title":"Cancellation Status"},"cancelled_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"İptal zamanı; RFC 3339 UTC. Değer yoksa null.","examples":["2026-10-16T09:00:00Z"],"title":"Cancelled At"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","default":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kesim veya iptalin sabit hata kodu; sağlayıcının serbest metni yayımlanmaz.","examples":[null],"title":"Error Code"},"id":{"description":"Kaynağın dış kimliği; inv_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["inv_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"issued_at":{"description":"Fatura düzenleme zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Issued At","type":"string"},"kind":{"description":"Fatura türü.","examples":["e_arsiv"],"title":"Kind","type":"string"},"number":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Fatura numarası; personal_data:read gerekir.","examples":[null],"title":"Number"},"status":{"description":"Faturanın düzenlenme/iptal durumu. Değerler: pending, issued, failed, cancelled. Türkçe karşılıkları: https://developer.siparis.app/referans#fatura-durumlari.","examples":["issued"],"title":"Status","type":"string"},"tax_total":{"description":"Toplam vergi; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["20.00"],"title":"Tax Total","type":"string"},"total":{"description":"Toplam tutar; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Total","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","kind","status","total","tax_total","issued_at","cancelled_at","created_at","updated_at"],"title":"Invoice","type":"object"},"InvoiceBuyer":{"additionalProperties":false,"properties":{"address":{"description":"Fatura adresinin açık adresi.","examples":["Örnek adres"],"title":"Address","type":"string"},"city":{"description":"Fatura adresinin ili.","examples":["İstanbul"],"title":"City","type":"string"},"corporate":{"description":"Şirket adına faturada true.","examples":[false],"title":"Corporate","type":"boolean"},"district":{"description":"Fatura adresinin ilçesi.","examples":["Kadıköy"],"title":"District","type":"string"},"email":{"description":"Sipariş verenin e-posta adresi.","examples":["ornek@example.com"],"title":"Email","type":"string"},"name":{"description":"Panelin seçtiği alıcı adı veya unvanı.","examples":["Örnek Alıcı"],"title":"Name","type":"string"},"phone":{"description":"Sipariş verenin telefonu.","examples":[""],"title":"Phone","type":"string"},"tax_number":{"description":"VKN/TCKN; bireyselde panelin nihai tüketici numarası.","examples":["11111111111"],"title":"Tax Number","type":"string"},"tax_office":{"description":"Vergi dairesi; bireyselde boş.","examples":[""],"title":"Tax Office","type":"string"}},"required":["name","corporate","tax_number","tax_office","address","city","district","email","phone"],"title":"InvoiceBuyer","type":"object"},"InvoiceCancelPreview":{"additionalProperties":false,"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Portal gerektiğinde invoice_portal_required; aksi halde null.","examples":[null],"title":"Code"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Paneldeki sağlayıcı iptal açıklaması.","examples":[null],"title":"Detail"},"invoice":{"description":"İptali incelenen inv_ kimliği.","examples":["inv_1234567890abcdef1234567890abcdef"],"title":"Invoice","type":"string"},"portal_required":{"description":"Önce portalda iptal gerekiyorsa true.","examples":[false],"title":"Portal Required","type":"boolean"},"via_api":{"description":"Sağlayıcı API ile iptali destekliyorsa true.","examples":[true],"title":"Via Api","type":"boolean"}},"required":["invoice","via_api","portal_required","code","detail"],"title":"InvoiceCancelPreview","type":"object"},"InvoiceInput":{"additionalProperties":false,"properties":{},"title":"InvoiceInput","type":"object"},"InvoiceLine":{"additionalProperties":false,"properties":{"discount":{"description":"Satırın KDV hariç indirimi, TRY.","examples":["0.00"],"title":"Discount","type":"string"},"name":{"description":"Panelin fatura satırı açıklaması.","examples":["Örnek ürün"],"title":"Name","type":"string"},"net":{"description":"İndirimden sonra KDV hariç tutar, TRY.","examples":["100.00"],"title":"Net","type":"string"},"quantity":{"description":"Satır miktarı; ondalık metin.","examples":["2"],"title":"Quantity","type":"string"},"tax_amount":{"description":"Satırın KDV tutarı, TRY.","examples":["20.00"],"title":"Tax Amount","type":"string"},"tax_rate":{"description":"KDV oranı, yüzde.","examples":["20"],"title":"Tax Rate","type":"string"},"total":{"description":"Satırın KDV dahil tutarı, TRY.","examples":["120.00"],"title":"Total","type":"string"},"unit":{"description":"Miktarın birimi.","examples":["adet"],"title":"Unit","type":"string"},"unit_price":{"description":"KDV hariç birim fiyat, TRY; dört ondalık haneye kadar.","examples":["50.0000"],"title":"Unit Price","type":"string"}},"required":["name","quantity","unit","unit_price","discount","net","tax_rate","tax_amount","total"],"title":"InvoiceLine","type":"object"},"InvoicePreview":{"additionalProperties":false,"properties":{"buyer":{"anyOf":[{"$ref":"#/components/schemas/InvoiceBuyer"},{"type":"null"}],"description":"Alıcı; personal_data:read yoksa alan atlanır.","examples":[{"address":"Örnek adres","city":"İstanbul","corporate":false,"district":"Kadıköy","email":"ornek@example.com","name":"Örnek Alıcı","phone":"","tax_number":"11111111111","tax_office":""}]},"currency":{"const":"TRY","default":"TRY","description":"Tutarların para birimi.","examples":["TRY"],"title":"Currency","type":"string"},"kind":{"anyOf":[{"enum":["e_fatura","e_arsiv"],"type":"string"},{"type":"null"}],"description":"Mükellef sorgusu sonucu; sağlayıcı yanıt vermediyse null.","examples":["e_arsiv"],"title":"Kind"},"lines":{"description":"Panelin faturaya yazacağı ürün ve hizmet satırları.","examples":[[{"discount":"0.00","name":"Örnek ürün","net":"100.00","quantity":"2","tax_amount":"20.00","tax_rate":"20","total":"120.00","unit":"adet","unit_price":"50.0000"}]],"items":{"$ref":"#/components/schemas/InvoiceLine"},"title":"Lines","type":"array"},"order":{"description":"Önizlenen siparişin ord_ kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Order","type":"string"},"registered_title":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sağlayıcıdaki unvan; personal_data:read yoksa atlanır.","examples":[null],"title":"Registered Title"},"tax_total":{"description":"Fatura KDV toplamı, TRY.","examples":["20.00"],"title":"Tax Total","type":"string"},"total":{"description":"Fatura toplamı, TRY.","examples":["120.00"],"title":"Total","type":"string"},"warnings":{"description":"Mükellef sorgusu ve alıcı unvanı uyarıları.","examples":[[{"code":"invoice_kind_unknown","detail":"Belge türü sağlayıcı yanıt verdiğinde kesinleşir."}]],"items":{"$ref":"#/components/schemas/InvoiceWarning"},"title":"Warnings","type":"array"}},"required":["order","kind","lines","total","tax_total","warnings"],"title":"InvoicePreview","type":"object"},"InvoiceWarning":{"additionalProperties":false,"properties":{"code":{"description":"Uyarının sabit kodu.","examples":["invoice_kind_unknown"],"title":"Code","type":"string"},"detail":{"description":"Uyarının Türkçe açıklaması.","examples":["Belge türü sağlayıcı yanıt verdiğinde kesinleşir."],"title":"Detail","type":"string"}},"required":["code","detail"],"title":"InvoiceWarning","type":"object"},"Level":{"additionalProperties":false,"properties":{"archived":{"description":"Arşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.","examples":[false],"title":"Archived","type":"boolean"},"id":{"description":"Kaynağın dış kimliği; lvl_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["lvl_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"location":{"description":"Depo kimliği (loc_ ve 32 küçük onaltılık karakter).","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location","type":"string"},"made_to_order":{"description":"Sipariş üzerine hazırlanırsa true; sayılmayan stoktan önceliklidir.","examples":[false],"title":"Made To Order","type":"boolean"},"product":{"description":"Ürün kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product","type":"string"},"quantity":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Depodaki fiziksel bakiye; sipariş verilebilir miktar değildir. Sayılmayan veya sipariş üzerine stokta null.","examples":["12.000"],"title":"Quantity"},"quantity_unit":{"description":"Bakiyenin birimi; ortak stokta havuz birimidir.","examples":["adet"],"title":"Quantity Unit","type":"string"},"revision":{"description":"Bu depo ve seçeneğin stok sürümü; miktar değiştiğinde artar, ürün sürümünden bağımsızdır.","examples":[1],"minimum":1,"title":"Revision","type":"integer"},"stock_state":{"description":"counted: sayılan; uncounted: sayılmayan; made_to_order: sipariş üzerine.","enum":["counted","uncounted","made_to_order"],"examples":["counted"],"title":"Stock State","type":"string"},"stock_uncounted":{"description":"Stok sayılmıyorsa true; stok miktarı null sunulur.","examples":[false],"title":"Stock Uncounted","type":"boolean"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"},"variant":{"description":"Seçenek kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant","type":"string"}},"required":["revision","id","variant","product","location","quantity","quantity_unit","stock_state","stock_uncounted","made_to_order","archived","updated_at"],"title":"Level","type":"object"},"Line":{"additionalProperties":false,"examples":[{"currency":"TRY","discount":"0.00","id":"lin_1234567890abcdef1234567890abcdef","name":"Kupa","product":null,"quantity":"1.000","refunded_quantity":"0.000","tax_amount":"20.00","tax_rate":"20.00","total":"120.00","unit":"adet","unit_price":"120.00","variant":null,"variant_name":null}],"properties":{"currency":{"const":"TRY","default":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"discount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Satır indirimi; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Discount"},"id":{"description":"Kaynağın dış kimliği; lin_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["lin_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"name":{"description":"Kaydın görünen adı.","examples":["Örnek Kupa"],"title":"Name","type":"string"},"product":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product"},"quantity":{"description":"Miktar; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["1.000"],"title":"Quantity","type":"string"},"refunded_quantity":{"description":"İade edilen miktar; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["0.000"],"title":"Refunded Quantity","type":"string"},"tax_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Vergi tutarı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["20.00"],"title":"Tax Amount"},"tax_rate":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Yüzde cinsinden vergi oranı; ondalık metin.","examples":["20.00"],"title":"Tax Rate"},"total":{"description":"Toplam tutar; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Total","type":"string"},"unit":{"description":"Ürünün satış miktarı birimi.","examples":["adet"],"title":"Unit","type":"string"},"unit_cost":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Birim maliyet; yalnız costs:read ile görünür; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["80.00"],"title":"Unit Cost"},"unit_price":{"description":"Satırın birim satış fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Unit Price","type":"string"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçenek kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"},"variant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Satırdaki seçeneğin sipariş anındaki adı.","examples":["Mavi"],"title":"Variant Name"}},"required":["id","product","variant","name","variant_name","unit","quantity","refunded_quantity","unit_price","total","discount","tax_rate","tax_amount"],"title":"Line","type":"object"},"Location":{"additionalProperties":false,"properties":{"active":{"description":"Kayıt etkinse true.","examples":[true],"title":"Active","type":"boolean"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"id":{"description":"Kaynağın dış kimliği; loc_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"is_default":{"description":"Varsayılan seçenek veya depo ise true.","examples":[true],"title":"Is Default","type":"boolean"},"name":{"description":"Kaydın görünen adı.","examples":["Ana depo"],"title":"Name","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","name","active","is_default","created_at","updated_at"],"title":"Location","type":"object"},"MoneyReturned":{"additionalProperties":false,"properties":{"expected_amount":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Bu iadede kalan, gerçekten geri verilen TRY tutarı; değişirse 409 amount_changed.","examples":["120.00"],"title":"Expected Amount"},"method":{"anyOf":[{"enum":["cash","bank","pos"],"type":"string"},{"type":"null"}],"description":"Elle ödeme yöntemi: cash nakit, bank havale, pos kart. Boşsa ortak servis belirler.","examples":["bank"],"title":"Method"}},"required":["expected_amount"],"title":"MoneyReturned","type":"object"},"MoneySummary":{"additionalProperties":false,"examples":[{"carried":"0.00","collect_due":"0.00","collected":"120.00","currency":"TRY","has_collection":true,"kept":"120.00","legacy":false,"refund_due":"0.00","reserved":"0.00","returned":"0.00","test":false}],"properties":{"carried":{"description":"Başka siparişe devreden hak (+), başka siparişten gelen mahsup (−); TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Carried","type":"string"},"collect_due":{"description":"Henüz tahsil edilmesi gereken; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Collect Due","type":"string"},"collected":{"description":"Tahsil edilen toplam; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Collected","type":"string"},"currency":{"const":"TRY","default":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"has_collection":{"description":"En az bir tahsilat kaydı varsa true.","examples":[true],"title":"Has Collection","type":"boolean"},"kept":{"description":"Tahsilatlardan geri ödemeler çıktıktan sonra kalan; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Kept","type":"string"},"legacy":{"description":"Eski kayıt biçiminden gelen özetse true.","examples":[false],"title":"Legacy","type":"boolean"},"refund_due":{"description":"Henüz müşteriye dönmesi gereken; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Refund Due","type":"string"},"reserved":{"description":"Devam eden geri ödemeler için ayrılan; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Reserved","type":"string"},"returned":{"description":"Geri ödenen toplam; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Returned","type":"string"},"test":{"description":"Deneme işlemi ise true; gerçek para hareketiyle karıştırmayın.","examples":[false],"title":"Test","type":"boolean"}},"required":["collected","returned","kept","carried","collect_due","refund_due","reserved","test","legacy","has_collection"],"title":"MoneySummary","type":"object"},"Movement":{"additionalProperties":false,"properties":{"count_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sayım farkının nedeni; sayım değilse null.","examples":[null],"title":"Count Reason"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"document":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stok belgesi kimliği (doc_ ve 32 küçük onaltılık karakter).","examples":["doc_1234567890abcdef1234567890abcdef"],"title":"Document"},"id":{"description":"Kaynağın dış kimliği; mov_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["mov_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"location":{"description":"Depo kimliği (loc_ ve 32 küçük onaltılık karakter).","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İç not; internal_notes:read gerekir. Kişisel kaynakta personal_data:read da gerekir.","examples":["Örnek iç not"],"title":"Note"},"order":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sipariş kimliği (ord_ ve 32 küçük onaltılık karakter).","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Order"},"product":{"description":"Ürün kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product","type":"string"},"quantity_change":{"description":"Stok hareketinin işaretli miktar değişimi; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["-1.000"],"title":"Quantity Change","type":"string"},"reason":{"description":"İşlemin nedeni.","examples":["sale"],"title":"Reason","type":"string"},"unit_cost":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Birim maliyet; yalnız costs:read ile görünür; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["80.00"],"title":"Unit Cost"},"variant":{"description":"Seçenek kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant","type":"string"},"variant_balance_after":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hareketten sonraki seçenek toplamı; depo bakiyesi değildir; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["12.000"],"title":"Variant Balance After"}},"required":["id","variant","product","location","quantity_change","variant_balance_after","reason","count_reason","document","order","currency","created_at"],"title":"Movement","type":"object"},"Option":{"additionalProperties":false,"properties":{"name":{"description":"Seçenek özelliğinin adı.","examples":["Renk"],"title":"Name","type":"string"},"value":{"description":"Seçenek özelliğinin değeri.","examples":["Mavi"],"title":"Value","type":"string"}},"required":["name","value"],"title":"Option","type":"object"},"Order":{"additionalProperties":false,"examples":[{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"panel","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"}],"properties":{"billing_address":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"Fatura adresi; personal_data:read yoksa alan atlanır.","examples":[{}]},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Siparişin satış kanalı; api_external kaynağında bildirilen channel_name.","examples":["whatsapp"],"title":"Channel"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","default":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"customer":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Müşteri kimliği (cus_ ve 32 küçük onaltılık karakter).","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Customer"},"customer_email":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Müşteri e-postası; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Customer Email"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Müşteri adı; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Customer Name"},"customer_note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Müşterinin sipariş notu; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Customer Note"},"customer_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Müşteri telefonu; yalnız personal_data:read kapsamında görünür. Örnek kişisel veri içermez.","examples":[null],"title":"Customer Phone"},"delivery_day":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"description":"Teslim günü; YYYY-MM-DD.","examples":["2026-10-17"],"title":"Delivery Day"},"delivery_method":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Teslim yöntemi. Değerler: shipping, hand, pickup, digital. Türkçe karşılıkları: https://developer.siparis.app/referans#teslim-yontemleri.","examples":["shipping"],"title":"Delivery Method"},"discount_total":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Toplam indirim; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Discount Total"},"gift_wrap_fee":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hediye paketi ücreti; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Gift Wrap Fee"},"id":{"description":"Kaynağın dış kimliği; ord_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"invoice":{"anyOf":[{"$ref":"#/components/schemas/Billing"},{"type":"null"}],"description":"Fatura alıcı bilgileri; personal_data:read yoksa alan atlanır.","examples":[{}]},"lines":{"anyOf":[{"$ref":"#/components/schemas/Page_Line_"},{"type":"null"}],"description":"include=lines ile ilk 50 sipariş satırı; devamı /orders/{id}/lines ile alınır.","examples":[{"data":[{"currency":"TRY","discount":"0.00","id":"lin_1234567890abcdef1234567890abcdef","name":"Kupa","product":null,"quantity":"1.000","refunded_quantity":"0.000","tax_amount":"20.00","tax_rate":"20.00","total":"120.00","unit":"adet","unit_price":"120.00","variant":null,"variant_name":null}],"has_more":false,"next_cursor":null}]},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İç not; internal_notes:read gerekir. Kişisel kaynakta personal_data:read da gerekir.","examples":["Örnek iç not"],"title":"Note"},"number":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Siparişin görünen sekiz haneli numarası; kaynak kimliği değildir.","examples":["48273910"],"title":"Number"},"payment_fee":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ödeme yöntemi ücreti; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Payment Fee"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ödeme yöntemi. Değerler: cod, bank_transfer, credit_card, split, cash, marketplace. Türkçe karşılıkları: https://developer.siparis.app/referans#odeme-yontemleri.","examples":["bank_transfer"],"title":"Payment Method"},"payment_state":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ödeme durumu; alınan ve iade edilen paradan hesaplanır, sipariş durumundan ayrıdır. Değerler: none, awaiting, partial, paid, refund_due, refunded, test. Türkçe karşılıkları: https://developer.siparis.app/referans#odeme-durumlari.","examples":["paid"],"title":"Payment State"},"payments":{"anyOf":[{"$ref":"#/components/schemas/Payments"},{"type":"null"}],"description":"include=payments ile ilk 50 tahsilat/iade ve bütün siparişin para özeti; payments:read gerekir.","examples":[{"data":[{"amount":"120.00","channel":"bank","created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"col_1234567890abcdef1234567890abcdef","kind":"payment","settled_at":"2026-10-16T09:00:00Z","status":"succeeded","test":false,"type":"collection"}],"has_more":false,"next_cursor":null,"summary":{"carried":"0.00","collect_due":"0.00","collected":"120.00","currency":"TRY","has_collection":true,"kept":"120.00","legacy":false,"refund_due":"0.00","reserved":"0.00","returned":"0.00","test":false}}]},"preorder_from":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"description":"Ön siparişin başlangıç günü; YYYY-MM-DD.","examples":[null],"title":"Preorder From"},"returns":{"anyOf":[{"$ref":"#/components/schemas/Page_Return_"},{"type":"null"}],"description":"include=returns ile ilk 50 iade; returns:read gerekir.","examples":[{"data":[{"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"ret_1234567890abcdef1234567890abcdef","kind":"return","refund_amount":null,"requested_at":"2026-10-16T09:00:00Z","source":"customer","status":"requested","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null}]},"shipments":{"anyOf":[{"$ref":"#/components/schemas/Page_Shipment_"},{"type":"null"}],"description":"include=shipments ile ilk 50 gönderi; shipments:read gerekir.","examples":[{"data":[{"carrier":"YURTICI","cod_amount":"120.00","collected_amount":null,"combined":true,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","delivered_at":null,"id":"shp_1234567890abcdef1234567890abcdef","shipping_fee":"0.00","state":"ready","status":"created","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null}]},"shipping_address":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"Teslimat adresi; personal_data:read yoksa alan atlanır.","examples":[{}]},"shipping_total":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Toplam kargo ücreti; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Shipping Total"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kaydın kaynağı; api: yeni satış, api_external: başka kanalda kesinleşmiş satış, import: eski siteden bilgi amaçlı aktarım. Panel/AI ve bağlı kanal kaynakları da korunur.","examples":["panel"],"title":"Source"},"status":{"description":"Siparişin iş akışındaki durumu; ödeme durumu ayrıca payment_state alanındadır. Değerler: pending, payment_pending, confirmed, processing, shipped, delivered, cancelled, refunded. Türkçe karşılıkları: https://developer.siparis.app/referans#siparis-durumlari.","examples":["confirmed"],"title":"Status","type":"string"},"store":{"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store","type":"string"},"subtotal":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürünlerin ara toplamı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Subtotal"},"tax_status":{"description":"standard: KDV mükellefi; exempt: vergiden muaf.","enum":["exempt","standard"],"examples":["standard"],"title":"Tax Status","type":"string"},"tax_total":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Toplam vergi; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["20.00"],"title":"Tax Total"},"total":{"description":"Toplam tutar; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Total","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","store","customer","number","status","payment_state","source","channel","payment_method","delivery_method","subtotal","discount_total","shipping_total","payment_fee","gift_wrap_fee","tax_total","total","tax_status","delivery_day","preorder_from","created_at","updated_at"],"title":"Order","type":"object"},"OrderAction":{"additionalProperties":false,"properties":{"expected_status":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"description":"Gördüğünüz sipariş durumu; kilit altında farklıysa 409 status_mismatch.","examples":["confirmed"],"title":"Expected Status"},"reason":{"default":"","description":"İşlemin gerekçesi; correct-status ve başka kanalda bildirilen satışın iptali için zorunlu.","examples":["Müşteri teslim aldı."],"maxLength":1000,"title":"Reason","type":"string"}},"title":"OrderAction","type":"object"},"OrderAddress":{"additionalProperties":false,"properties":{"address_line":{"description":"Açık teslimat adresi.","examples":["Örnek Sokak No: 1"],"maxLength":500,"minLength":5,"title":"Address Line","type":"string"},"city":{"description":"Adresin ili.","examples":["İstanbul"],"maxLength":100,"minLength":2,"title":"City","type":"string"},"district":{"description":"Adresin ilçesi.","examples":["Kadıköy"],"maxLength":100,"minLength":2,"title":"District","type":"string"},"full_name":{"default":"","description":"Alıcının adı; boşsa sipariş verenin adı kullanılır.","examples":["Örnek Alıcı"],"maxLength":200,"title":"Full Name","type":"string"},"neighborhood":{"default":"","description":"Kargoda resmî listedeki mahalle veya köy adı gerekir.","examples":["Caferağa"],"maxLength":100,"title":"Neighborhood","type":"string"},"neighborhood_area":{"default":"","description":"Varsa bağlı köy, semt veya belde.","examples":[""],"maxLength":100,"title":"Neighborhood Area","type":"string"},"phone":{"default":"","description":"Alıcının telefonu; kargoda zorunludur. Başka alıcıya müşterinin telefonu taşınmaz.","examples":["05000000000"],"maxLength":30,"title":"Phone","type":"string"},"postal_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"description":"İsteğe bağlı posta kodu.","examples":["34710"],"title":"Postal Code"},"village":{"default":false,"description":"Adres köydeyse true.","examples":[false],"title":"Village","type":"boolean"}},"required":["address_line","district","city"],"title":"OrderAddress","type":"object"},"OrderCustomer":{"additionalProperties":false,"properties":{"email":{"default":"","description":"Müşterinin e-postası; mevcut müşteri eşleştirmesinde kullanılır.","examples":["musteri@example.com"],"maxLength":200,"title":"Email","type":"string"},"name":{"description":"Müşterinin adı.","examples":["Örnek Müşteri"],"maxLength":200,"minLength":1,"title":"Name","type":"string"},"phone":{"default":"","description":"Müşterinin telefonu; mevcut müşteri eşleştirmesinde kullanılır.","examples":["05000000000"],"maxLength":30,"title":"Phone","type":"string"}},"required":["name"],"title":"OrderCustomer","type":"object"},"OrderItem":{"additionalProperties":false,"examples":[{"quantity":"2","sku":"KUPA-MAVI"}],"properties":{"quantity":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"}],"description":"Miktar; en çok üç ondalık hane. Adetle satılan üründe tam sayı gerekir.","examples":["2"],"title":"Quantity"},"sku":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"description":"Stok kodu; baş/son boşluk ve harf farkı kaldırılarak tam eşleşir.","examples":["KUPA-MAVI"],"title":"Sku"},"unit_price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"İsteğe bağlı TRY birim fiyatı; orders.price eylem izni gerekir. Yoksa markanın kampanya dahil fiyatı kullanılır.","examples":["120.00"],"title":"Unit Price"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"var_ dış kimliği; variant veya sku alanından tam biri gerekir.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["quantity"],"title":"OrderItem","type":"object"},"OrdersExportFilters":{"additionalProperties":false,"properties":{"created_at_from":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç zamanı dahil; saat dilimli RFC 3339 gönderin.","examples":["2026-10-16T09:00:00Z"],"title":"Created At From"},"created_at_to":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş zamanı hariç; saat dilimli RFC 3339 gönderin.","examples":["2026-10-17T09:00:00Z"],"title":"Created At To"},"customer":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Siparişin bağlı olduğu cus_ müşteri kimliği; yalnız sort=-created_at ile kullanılabilir. Başka markanın müşterisi marka sınırlı anahtara görünmez.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Customer"},"number":{"anyOf":[{"pattern":"^[0-9]{8}$","type":"string"},{"type":"null"}],"description":"Siparişin görünen sekiz haneli numarası; kaynak kimliği değildir.","examples":["48273910"],"title":"Number"},"sort":{"default":"updated_at","description":"updated_at: son değişiklikten ileri; -created_at: en yeni sipariş önce. Sıra değişirse yeni sayfalama başlatın.","enum":["updated_at","-created_at"],"examples":["-created_at"],"title":"Sort","type":"string"},"status":{"anyOf":[{"enum":["pending","payment_pending","confirmed","processing","shipped","delivered","cancelled","refunded"],"type":"string"},{"type":"null"}],"description":"Sipariş durumu eşitlik süzgeci. payment_pending eski değerdir: 19 Ekim 2026'dan beri hiçbir sipariş bu durumda açılmaz, süzgeç boş sonuç verir; ödemesi beklenen sipariş payment_state=awaiting ya da partial taşır.","examples":["confirmed"],"title":"Status"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"},"updated_at_from":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç zamanı dahil; saat dilimli RFC 3339 gönderin.","examples":["2026-10-16T09:00:00Z"],"title":"Updated At From"},"updated_at_to":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş zamanı hariç; saat dilimli RFC 3339 gönderin.","examples":["2026-10-17T09:00:00Z"],"title":"Updated At To"}},"title":"OrdersExportFilters","type":"object"},"OrdersExportInput":{"additionalProperties":false,"properties":{"filters":{"$ref":"#/components/schemas/OrdersExportFilters","description":"Kaynağın liste süzgeçleri; limit, cursor ve include desteklenmez.","examples":[{}]},"format":{"description":"jsonl: satır başına JSON nesnesi; csv: her hücresi JSON değeri olan CSV.","enum":["jsonl","csv"],"examples":["jsonl"],"title":"Format","type":"string"},"mode":{"const":"consistent_snapshot","description":"consistent_snapshot: bütün kayıtlar aynı anın tutarlı görünümüdür.","examples":["consistent_snapshot"],"title":"Mode","type":"string"},"resource":{"const":"orders","description":"Dışa aktarılacak kaynak; aynı kaynağın okuma kapsamı gerekir.","examples":["orders"],"title":"Resource","type":"string"}},"required":["mode","format","resource"],"title":"OrdersExportInput","type":"object"},"Package":{"additionalProperties":false,"properties":{"boxes":{"description":"Gerçek ölçülmüş koliler; toplam en çok 99 koli.","examples":[[{"depth":20,"height":20,"weight":1,"width":20}]],"items":{"$ref":"#/components/schemas/Box"},"maxItems":99,"minItems":1,"title":"Boxes","type":"array"},"version":{"anyOf":[{"maxLength":32,"type":"string"},{"type":"null"}],"description":"Fiyat yanıtındaki package_version; verilirse değişen koli bilgisi reddedilir.","examples":["0123456789abcdef"],"title":"Version"}},"required":["boxes"],"title":"Package","type":"object"},"Page_Attempt_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"attempted_at":"2026-10-16T09:00:00Z","duration_ms":120,"error":null,"id":"wha_1234567890abcdef1234567890abcdef","status_code":200}]],"items":{"$ref":"#/components/schemas/Attempt"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Attempt]","type":"object"},"Page_Category_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"archived":false,"created_at":"2026-10-16T09:00:00Z","description":"Seramik kupa, 300 ml.","id":"cat_1234567890abcdef1234567890abcdef","image":"https://example.com/kupa.jpg","name":"Mutfak","parent":null,"revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Category"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Category]","type":"object"},"Page_Coupon_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"archived":false,"categories":[],"category_restricted":false,"code":"MERHABA10","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer_restricted":false,"discount_type":"percentage","discount_value":"10.00","exclude_discounted":false,"first_order_only":false,"free_shipping":false,"id":"cpn_1234567890abcdef1234567890abcdef","max_uses":100,"max_uses_per_customer":1,"min_order":"100.00","revision":1,"status":"active","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","used_count":0,"valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"}]],"items":{"$ref":"#/components/schemas/Coupon"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Coupon]","type":"object"},"Page_Customer_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":1,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Customer"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Customer]","type":"object"},"Page_Delivery_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"attempt_count":0,"created_at":"2026-10-16T09:00:00Z","event":"evt_1234567890abcdef1234567890abcdef","id":"whd_1234567890abcdef1234567890abcdef","last_error":null,"last_status":null,"next_attempt_at":"2026-10-16T09:00:00Z","status":"pending","type":"order.created"}]],"items":{"$ref":"#/components/schemas/Delivery"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Delivery]","type":"object"},"Page_Endpoint_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"created_at":"2026-10-16T09:00:00Z","event_types":["order.created"],"grant":"grt_1234567890abcdef1234567890abcdef","id":"whe_1234567890abcdef1234567890abcdef","last_attempt_at":null,"last_error":null,"last_success_at":null,"previous_secret_until":null,"schema_version":1,"status":"pending_test","store":"sto_1234567890abcdef1234567890abcdef","store_name":"Örnek Marka","url":"https://example.com/webhooks/siparis"}]],"items":{"$ref":"#/components/schemas/Endpoint"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Endpoint]","type":"object"},"Page_History_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"actor_type":"user","created_at":"2026-10-16T09:00:00Z","previous_status":"pending","status":"confirmed","type":"order.status_changed"}]],"items":{"$ref":"#/components/schemas/History"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[History]","type":"object"},"Page_Invoice_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"cancelled_at":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"inv_1234567890abcdef1234567890abcdef","issued_at":"2026-10-16T09:00:00Z","kind":"e_arsiv","status":"issued","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Invoice"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Invoice]","type":"object"},"Page_Level_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"archived":false,"id":"lvl_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","made_to_order":false,"product":"prd_1234567890abcdef1234567890abcdef","quantity":"12.000","quantity_unit":"adet","revision":1,"stock_state":"counted","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z","variant":"var_1234567890abcdef1234567890abcdef"}]],"items":{"$ref":"#/components/schemas/Level"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Level]","type":"object"},"Page_Line_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"currency":"TRY","discount":"0.00","id":"lin_1234567890abcdef1234567890abcdef","name":"Kupa","product":null,"quantity":"1.000","refunded_quantity":"0.000","tax_amount":"20.00","tax_rate":"20.00","total":"120.00","unit":"adet","unit_price":"120.00","variant":null,"variant_name":null}]],"items":{"$ref":"#/components/schemas/Line"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Line]","type":"object"},"Page_Location_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"active":true,"created_at":"2026-10-16T09:00:00Z","id":"loc_1234567890abcdef1234567890abcdef","is_default":true,"name":"Ana depo","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Location"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Location]","type":"object"},"Page_Movement_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}]],"items":{"$ref":"#/components/schemas/Movement"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Movement]","type":"object"},"Page_Order_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"panel","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"}]],"items":{"$ref":"#/components/schemas/Order"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Order]","type":"object"},"Page_ProductBrand_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"brd_1234567890abcdef1234567890abcdef","logo":"https://example.com/logo.png","name":"Örnek Üretici","revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/ProductBrand"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[ProductBrand]","type":"object"},"Page_Product_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"archived":false,"brand":"brd_1234567890abcdef1234567890abcdef","code":"KUPA-001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","description":"Seramik kupa, 300 ml.","id":"prd_1234567890abcdef1234567890abcdef","images":["https://example.com/kupa.jpg"],"kind":"standard","made_to_order":false,"maximum_quantity":"100.000","minimum_quantity":"1.000","name":"Seramik Kupa","pool_unit":"adet","preparation":"3 iş günü","price":"120.00","quantity_step":"1.000","short_description":"Seramik kupa","slug":"ornek-kupa","status":"active","tax_rate":"20.00","tax_status":"standard","unit":"adet","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Product"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Product]","type":"object"},"Page_Return_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"ret_1234567890abcdef1234567890abcdef","kind":"return","refund_amount":null,"requested_at":"2026-10-16T09:00:00Z","source":"customer","status":"requested","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Return"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Return]","type":"object"},"Page_Shipment_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"carrier":"YURTICI","cod_amount":"120.00","collected_amount":null,"combined":true,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","delivered_at":null,"id":"shp_1234567890abcdef1234567890abcdef","shipping_fee":"0.00","state":"ready","status":"created","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Shipment"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Shipment]","type":"object"},"Page_StorePrice_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"archived":false,"compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","variant":"var_1234567890abcdef1234567890abcdef"}]],"items":{"$ref":"#/components/schemas/StorePrice"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[StorePrice]","type":"object"},"Page_Store_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"active":true,"created_at":"2026-10-16T09:00:00Z","id":"sto_1234567890abcdef1234567890abcdef","name":"Örnek Marka","slug":"ornek-kupa","updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Store"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Store]","type":"object"},"Page_Variant_":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"archived":false,"barcode":"8690000000001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","expired":false,"id":"var_1234567890abcdef1234567890abcdef","is_default":true,"made_to_order":false,"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"pool_quantity":"1.000","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","sku":"KUPA-MAVI","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z"}]],"items":{"$ref":"#/components/schemas/Variant"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"}},"required":["data","has_more","next_cursor"],"title":"Page[Variant]","type":"object"},"PatchCoupon":{"additionalProperties":false,"examples":[{"discount_value":"15.00"}],"properties":{"categories":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"type":"array"},{"type":"null"}],"description":"cat_ kimlikleri; alt kategoriler dahil. [] bütün ürünlerde geçerli yapar.","examples":[[]],"title":"Categories"},"code":{"anyOf":[{"maxLength":40,"minLength":1,"type":"string"},{"type":"null"}],"description":"Kupon kodu; panelin Türkçe harf ve boşluk normalleştirmesi uygulanır.","examples":["MERHABA10"],"title":"Code"},"discount_type":{"anyOf":[{"enum":["percentage","fixed"],"type":"string"},{"type":"null"}],"description":"Yüzde veya sabit TRY tutarı; null temizler.","examples":["percentage"],"title":"Discount Type"},"discount_value":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Yüzde oranı veya TRY tutarı; ondalık metin, null temizler.","examples":["10.00"],"title":"Discount Value"},"exclude_discounted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"İndirimli/kampanyalı ürünlere uygulanmayacaksa true.","examples":[false],"title":"Exclude Discounted"},"first_order_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Yalnız ilk siparişte geçerliyse true.","examples":[false],"title":"First Order Only"},"free_shipping":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Kargo da ücretsizse true.","examples":[false],"title":"Free Shipping"},"max_uses":{"anyOf":[{"maximum":2147483647,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Toplam kullanım sınırı; null sınırsız.","examples":[100],"title":"Max Uses"},"max_uses_per_customer":{"anyOf":[{"maximum":2147483647,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Kişi başına kullanım sınırı; null sınırsız.","examples":[1],"title":"Max Uses Per Customer"},"min_order":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Kupona uygun ürünlerin en az TRY tutarı; null kaldırır.","examples":["100.00"],"title":"Min Order"},"status":{"anyOf":[{"enum":["active","inactive"],"type":"string"},{"type":"null"}],"description":"active açık, inactive kapalı.","examples":["active"],"title":"Status"},"valid_from":{"anyOf":[{"maxLength":35,"type":"string"},{"type":"null"}],"description":"Panel gibi markanın yerel günü veya dakikası; YYYY-MM-DD ya da ISO tarih/saat. null sınırı kaldırır.","examples":["2026-10-16"],"title":"Valid From"},"valid_until":{"anyOf":[{"maxLength":35,"type":"string"},{"type":"null"}],"description":"Bitiş günü/dakikası dahildir; saat dilimli ISO zaman markanın saatine çevrilir. null sınırsız.","examples":["2026-12-31T23:59"],"title":"Valid Until"}},"title":"PatchCoupon","type":"object"},"PatchCustomer":{"additionalProperties":false,"examples":[{"name":"Örnek Müşteri Yeni"}],"properties":{"address":{"anyOf":[{"$ref":"#/components/schemas/CustomerAddress"},{"type":"null"}],"description":"Müşterinin adresi; null adresi kaldırır. personal_data:write gerekir.","examples":[{}]},"email":{"anyOf":[{"maxLength":320,"type":"string"},{"type":"null"}],"description":"E-posta; null veya boş metin alanı temizler. personal_data:write gerekir.","examples":["musteri@example.com"],"title":"Email"},"invoice":{"anyOf":[{"$ref":"#/components/schemas/CustomerInvoice"},{"type":"null"}],"description":"Fatura bilgisi; null kaldırır. personal_data:write gerekir.","examples":[{"company_name":"Örnek Şirket","tax_number":"1234567890","tax_office":"Kadıköy"}]},"marketing_consent":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Pazarlama izni: true var, false yok, null bilinmiyor. personal_data:write gerekir.","examples":[false],"title":"Marketing Consent"},"name":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"description":"Yeni müşteri adı; null olamaz. Gönderilmeyen alan korunur. personal_data:write gerekir.","examples":["Örnek Müşteri Yeni"],"title":"Name"},"note":{"anyOf":[{"maxLength":10000,"type":"string"},{"type":"null"}],"description":"İç not; null veya boş metin kaldırır. internal_notes:write gerekir.","examples":["Teslimden önce bilgi verin."],"title":"Note"},"phone":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"description":"Telefon; null veya boş metin alanı temizler. personal_data:write gerekir.","examples":["05000000000"],"title":"Phone"}},"title":"PatchCustomer","type":"object"},"PatchOrder":{"additionalProperties":false,"examples":[{"delivery_day":"2026-10-17"}],"properties":{"add_items":{"anyOf":[{"items":{"$ref":"#/components/schemas/OrderItem"},"maxItems":50,"minItems":1,"type":"array"},{"type":"null"}],"description":"Marka fiyatıyla eklenecek kalemler; burada unit_price desteklenmez.","examples":[[{"quantity":"2","sku":"KUPA-MAVI"}]],"title":"Add Items"},"allow_waiting":{"default":false,"description":"Eklenen kalemin eksik adedi mal gelince gönderilsin.","examples":[false],"title":"Allow Waiting","type":"boolean"},"customer_note":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"description":"Müşteri notu; boş metin kaldırır, personal_data:write gerekir.","examples":["Teslimden önce arayın."],"title":"Customer Note"},"delivery_day":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"description":"Yeni teslim günü; null günü kaldırır. Gönderilmeyen alan değişmez.","examples":["2026-10-17"],"title":"Delivery Day"},"items":{"anyOf":[{"items":{"$ref":"#/components/schemas/ChangeItem"},"maxItems":100,"minItems":1,"type":"array"},{"type":"null"}],"description":"Yalnız değişen satırlar; panelin kargo/fatura/ödeme ve stok kilitleri geçerlidir.","examples":[[{"id":"lin_1234567890abcdef1234567890abcdef","quantity":"1"}]],"title":"Items"},"note":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"description":"İç not; boş metin kaldırır, internal_notes:write gerekir.","examples":["Paket kontrol edildi."],"title":"Note"},"refund_amount":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Para dönen düzeltmede gördüğünüz iade tutarı; money_out:write gerekir. Kart iadesi panelin mevcut yoluyla yürür.","examples":["120.00"],"title":"Refund Amount"},"restore_items":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"},{"type":"null"}],"description":"Çıkarılmış lin_ satırlarını kayıtlı adet/fiyatla geri ekler.","examples":[["lin_1234567890abcdef1234567890abcdef"]],"title":"Restore Items"},"shipping_address":{"anyOf":[{"$ref":"#/components/schemas/OrderAddress"},{"type":"null"}],"description":"Yeni teslimat adresi; personal_data:write gerekir. Müşteri kartının adresi değiştirilmez.","examples":[{"address_line":"Örnek Sokak No: 1","city":"İstanbul","district":"Kadıköy"}]}},"title":"PatchOrder","type":"object"},"PatchProduct":{"additionalProperties":false,"examples":[{"price":"140.00"}],"properties":{"barcode":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"description":"Barkod; işletmede canlı seçenekler arasında tekil. null temizler.","examples":["8690000000001"],"title":"Barcode"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Mevcut brd_ ürün markası; null bağı kaldırır. Satıcının sto_ markasıyla karıştırmayın.","examples":[null],"title":"Brand"},"categories":{"anyOf":[{"items":{"type":"string"},"maxItems":100,"type":"array"},{"type":"null"}],"description":"Mevcut cat_ kategori kimlikleri; [] bağları kaldırır. Yeni kategori açmaz.","examples":[[]],"title":"Categories"},"compare_price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Üstü çizili fiyat; null kaldırır. Üründe satış fiyatından yüksek olmalıdır.","examples":["150.00"],"title":"Compare Price"},"cost":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Alış maliyeti; costs:write gerekir. Panel gibi KDV hariç, muaf işletmede KDV dahil saklanır; null kaldırır.","examples":["80.00"],"title":"Cost"},"description":{"anyOf":[{"maxLength":50000,"type":"string"},{"type":"null"}],"description":"Ürün açıklaması; null kaldırır.","examples":["Seramik kupa, 300 ml."],"title":"Description"},"images":{"anyOf":[{"items":{"maxLength":2000,"type":"string"},"maxItems":12,"type":"array"},{"type":"null"}],"description":"En çok 12 http/https görsel URL’si; [] galeriyi boşaltır. Panelin güvenli kopyalama kuyruğu kullanılır.","examples":[[""]],"title":"Images"},"made_to_order":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Sipariş üzerine hazırlanırsa true; mevcut stok korunur.","examples":[false],"title":"Made To Order"},"name":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"description":"Ürün adı; gönderilmezse korunur, null olamaz.","examples":["Seramik Kupa"],"title":"Name"},"price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"TRY satış fiyatı; ondalık metin. null ürünün fiyatını kaldırır, seçenekte ürün fiyatına döner.","examples":["120.00"],"title":"Price"},"short_description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"description":"Kısa açıklama; null kaldırır.","examples":["Seramik kupa"],"title":"Short Description"},"sku":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Stok kodu; işletmede canlı seçenekler arasında tekil. null temizler.","examples":["KUPA-MAVI"],"title":"Sku"},"status":{"anyOf":[{"enum":["active","draft","inactive"],"type":"string"},{"type":"null"}],"description":"Satış durumu; arşiv için ayrı eylemi kullanın. Fiyatsız ürün satışa açılamaz.","examples":["active"],"title":"Status"},"tax_rate":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Yüzde KDV oranı; panelin vergi sınıfı doğrulaması kullanılır.","examples":["20"],"title":"Tax Rate"},"unit":{"anyOf":[{"maxLength":20,"minLength":1,"type":"string"},{"type":"null"}],"description":"Satış birimi; panelin miktar doğrulaması kullanılır.","examples":["adet"],"title":"Unit"},"weight":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"Kilogram cinsinden ağırlık; null kaldırır.","examples":["0.350"],"title":"Weight"}},"title":"PatchProduct","type":"object"},"PatchVariant":{"additionalProperties":false,"examples":[{"price_rule":{"kind":"percent","value":"10.00"}}],"properties":{"barcode":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"description":"Barkod; işletmede canlı seçenekler arasında tekil. null temizler.","examples":["8690000000001"],"title":"Barcode"},"compare_price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Üstü çizili fiyat; null kaldırır. Üründe satış fiyatından yüksek olmalıdır.","examples":["150.00"],"title":"Compare Price"},"cost":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Alış maliyeti; costs:write gerekir. Panel gibi KDV hariç, muaf işletmede KDV dahil saklanır; null kaldırır.","examples":["80.00"],"title":"Cost"},"images":{"anyOf":[{"items":{"maxLength":2000,"type":"string"},"maxItems":12,"type":"array"},{"type":"null"}],"description":"En çok 12 http/https görsel URL’si; [] galeriyi boşaltır. Panelin güvenli kopyalama kuyruğu kullanılır.","examples":[[""]],"title":"Images"},"made_to_order":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Sipariş üzerine hazırlanırsa true; mevcut stok korunur.","examples":[false],"title":"Made To Order"},"name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"description":"Seçeneğin görünen adı; gönderilmezse korunur.","examples":["Mavi"],"title":"Name"},"options":{"anyOf":[{"items":{"$ref":"#/components/schemas/CatalogOption"},"maxItems":20,"type":"array"},{"type":"null"}],"description":"Seçeneğin ad/değer çiftleri; gönderilmezse korunur.","examples":[[{"name":"Renk","value":"Mavi"}]],"title":"Options"},"price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"TRY satış fiyatı; ondalık metin. null ürünün fiyatını kaldırır, seçenekte ürün fiyatına döner.","examples":["120.00"],"title":"Price"},"price_rule":{"anyOf":[{"$ref":"#/components/schemas/PriceRule"},{"type":"null"}],"description":"Ürün fiyatından TL veya yüzde farkı; null ürünle aynı fiyat demektir.","examples":[{"kind":"tl","value":"20.00"}]},"sku":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Stok kodu; işletmede canlı seçenekler arasında tekil. null temizler.","examples":["KUPA-MAVI"],"title":"Sku"},"weight":{"anyOf":[{"maximum":100000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"},{"type":"null"}],"description":"Kilogram cinsinden ağırlık; null kaldırır.","examples":["0.350"],"title":"Weight"}},"title":"PatchVariant","type":"object"},"Payment":{"additionalProperties":false,"examples":[{"amount":"120.00","channel":"bank","created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"col_1234567890abcdef1234567890abcdef","kind":"payment","settled_at":"2026-10-16T09:00:00Z","status":"succeeded","test":false,"type":"collection"}],"properties":{"amount":{"description":"İşlem tutarı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Amount","type":"string"},"channel":{"description":"Satış veya tahsilat kanalı.","examples":["bank"],"title":"Channel","type":"string"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","default":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"id":{"description":"Kaynağın dış kimliği; col_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["col_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"kind":{"description":"Tahsilat veya iade işlem türü.","examples":["payment"],"title":"Kind","type":"string"},"settled_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Kesinleşme zamanı; RFC 3339 UTC. Değer yoksa null.","examples":["2026-10-16T09:00:00Z"],"title":"Settled At"},"status":{"description":"Tahsilat/geri ödeme durumu.","examples":["succeeded"],"title":"Status","type":"string"},"test":{"description":"Deneme işlemi ise true; gerçek para hareketiyle karıştırmayın.","examples":[false],"title":"Test","type":"boolean"},"type":{"description":"collection: tahsilat; refund: geri ödeme.","enum":["collection","refund"],"examples":["collection"],"title":"Type","type":"string"}},"required":["id","type","kind","channel","status","amount","test","created_at","settled_at"],"title":"Payment","type":"object"},"PaymentPart":{"additionalProperties":false,"properties":{"amount":{"anyOf":[{"exclusiveMinimum":0,"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Gerçekten alınan tutar, TRY; ondalık metin.","examples":["120.00"],"title":"Amount"},"method":{"description":"cash: nakit; pos: elle alınan kart; bank: havale.","enum":["cash","pos","bank"],"examples":["cash"],"title":"Method","type":"string"}},"required":["method","amount"],"title":"PaymentPart","type":"object"},"Payments":{"additionalProperties":false,"properties":{"data":{"description":"Bu sayfanın görünür kayıtları; boş liste de geçerli bir sayfadır.","examples":[[{"amount":"120.00","channel":"bank","created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"col_1234567890abcdef1234567890abcdef","kind":"payment","settled_at":"2026-10-16T09:00:00Z","status":"succeeded","test":false,"type":"collection"}]],"items":{"$ref":"#/components/schemas/Payment"},"title":"Data","type":"array"},"has_more":{"description":"Taranacak başka sayfa varsa true; olaylarda boş data ile de true olabilir.","examples":[false],"title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sonraki sayfa için aynen gönderilecek opak imleç; kaynak listesi bittiyse null.","examples":[null],"title":"Next Cursor"},"summary":{"$ref":"#/components/schemas/MoneySummary","description":"Siparişin bütün tahsilat ve iadelerinden hesaplanan para özeti; yalnız bu sayfanın toplamı değildir.","examples":[{"carried":"0.00","collect_due":"0.00","collected":"120.00","currency":"TRY","has_collection":true,"kept":"120.00","legacy":false,"refund_due":"0.00","reserved":"0.00","returned":"0.00","test":false}]}},"required":["data","has_more","next_cursor","summary"],"title":"Payments","type":"object"},"PreviewItem":{"additionalProperties":false,"properties":{"item":{"description":"İade edilecek lin_ kalemi.","examples":["lin_1234567890abcdef1234567890abcdef"],"title":"Item","type":"string"},"quantity":{"description":"İade miktarı; kalemin biriminde ondalık metin.","examples":["1.000"],"title":"Quantity","type":"string"},"unit":{"description":"Miktarın birimi.","examples":["adet"],"title":"Unit","type":"string"}},"required":["item","quantity","unit"],"title":"PreviewItem","type":"object"},"PriceRule":{"additionalProperties":false,"properties":{"kind":{"description":"Ürün fiyatına eklenecek farkın birimi.","enum":["tl","percent"],"examples":["tl"],"title":"Kind","type":"string"},"value":{"anyOf":[{"maximum":10000000,"minimum":-10000000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Fiyat farkı; negatif değer indirimdir. Son fiyat ortak fiyat kuralıyla doğrulanır.","examples":["20.00"],"title":"Value"}},"required":["kind","value"],"title":"PriceRule","type":"object"},"ProblemDetail":{"additionalProperties":false,"properties":{"code":{"description":"Programatik karar için kararlı hata kodu; metni ayrıştırmayın.","examples":["validation_error"],"title":"Code","type":"string"},"current_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"amount_changed hatasında güncel TRY iade tutarı.","examples":["120.00"],"title":"Current Amount"},"current_quantity":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Yalnız stock_changed hatasında kilit altında okunan güncel depo miktarı; sayılmayan stokta null.","examples":["9.000"],"title":"Current Quantity"},"detail":{"description":"Hatanın Türkçe açıklaması.","examples":["İstek alanlarını kontrol edin."],"title":"Detail","type":"string"},"errors":{"description":"Alan düzeyindeki doğrulama sorunları; genel hatada boş liste.","examples":[[]],"items":{"$ref":"#/components/schemas/FieldError"},"title":"Errors","type":"array"},"existing_customer":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Yalnız customer_exists hatasında eşleşen mevcut cus_ müşteri kimliği.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Existing Customer"},"existing_order":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Yalnız duplicate_external_reference hatasında daha önce açılan ord_ siparişi.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Existing Order"},"existing_product":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"code_taken veya external_reference_conflict hatasında görünür mevcut prd_ kaydı.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Existing Product"},"existing_variant":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"code_taken veya external_reference_conflict hatasında görünür mevcut var_ kaydı.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Existing Variant"},"refund_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Yalnız refund_confirm hatasında teyit edilmesi gereken TRY iade tutarı.","examples":["100.00"],"title":"Refund Amount"},"request_id":{"description":"Destek için X-Request-ID ile aynı istek takip kimliği.","examples":["req_ornek_20261016"],"title":"Request Id","type":"string"},"status":{"description":"HTTP yanıt durum kodu.","examples":[422],"maximum":599,"minimum":400,"title":"Status","type":"integer"},"title":{"description":"HTTP durumunun kısa standart adı.","examples":["Unprocessable Entity"],"title":"Title","type":"string"},"type":{"description":"Kararlı hata türü URI değeri.","examples":["urn:siparis:problem:validation_error"],"title":"Type","type":"string"}},"required":["type","title","status","code","detail","errors","request_id"],"title":"ProblemDetail","type":"object"},"Product":{"additionalProperties":false,"properties":{"archived":{"description":"Arşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.","examples":[false],"title":"Archived","type":"boolean"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün markası kimliği (brd_ ve 32 küçük onaltılık karakter).","examples":["brd_1234567890abcdef1234567890abcdef"],"title":"Brand"},"categories":{"anyOf":[{"items":{"$ref":"#/components/schemas/Category"},"type":"array"},{"type":"null"}],"description":"include=categories ile eklenen görünür kategoriler.","examples":[[{"archived":false,"created_at":"2026-10-16T09:00:00Z","description":"Seramik kupa, 300 ml.","id":"cat_1234567890abcdef1234567890abcdef","image":"https://example.com/kupa.jpg","name":"Mutfak","parent":null,"revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"}]],"title":"Categories"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün kodu.","examples":["KUPA-001"],"title":"Code"},"compare_price":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Karşılaştırma fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["150.00"],"title":"Compare Price"},"cost":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Maliyet; yalnız costs:read ile görünür; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["80.00"],"title":"Cost"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kaynağın açıklama metni.","examples":["Seramik kupa, 300 ml."],"title":"Description"},"id":{"description":"Kaynağın dış kimliği; prd_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"images":{"description":"Ürün görsellerinin sıralı HTTPS adresleri.","examples":[["https://example.com/kupa.jpg"]],"items":{"type":"string"},"title":"Images","type":"array"},"kind":{"description":"Ürün türü; ör. standard: tek ürün, bundle: paket.","examples":["standard"],"title":"Kind","type":"string"},"made_to_order":{"description":"Sipariş üzerine hazırlanırsa true; sayılmayan stoktan önceliklidir.","examples":[false],"title":"Made To Order","type":"boolean"},"maximum_quantity":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"En çok sipariş miktarı; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["100.000"],"title":"Maximum Quantity"},"minimum_quantity":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"En az sipariş miktarı; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["1.000"],"title":"Minimum Quantity"},"name":{"description":"Kaydın görünen adı.","examples":["Seramik Kupa"],"title":"Name","type":"string"},"pool_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ortak stok havuzunun birimi.","examples":["adet"],"title":"Pool Unit"},"preparation":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sipariş üzerine hazırlama süresinin açıklaması.","examples":["3 iş günü"],"title":"Preparation"},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Satış fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Price"},"quantity_step":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sipariş miktarının artış adımı; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["1.000"],"title":"Quantity Step"},"short_description":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürünün kısa açıklaması.","examples":["Seramik kupa"],"title":"Short Description"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Adreslerde kullanılan kısa ad.","examples":["ornek-kupa"],"title":"Slug"},"status":{"description":"Kaynağın işlem durumu.","examples":["active"],"title":"Status","type":"string"},"store_prices":{"anyOf":[{"items":{"$ref":"#/components/schemas/StorePrice"},"type":"array"},{"type":"null"}],"description":"include=store_prices ile eklenen kayıtlı marka fiyatları; kampanya fiyatı değildir.","examples":[[{"archived":false,"compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","variant":"var_1234567890abcdef1234567890abcdef"}]],"title":"Store Prices"},"tax_rate":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Yüzde cinsinden vergi oranı; ondalık metin.","examples":["20.00"],"title":"Tax Rate"},"tax_status":{"description":"standard: KDV mükellefi; exempt: vergiden muaf.","enum":["standard","exempt"],"examples":["standard"],"title":"Tax Status","type":"string"},"unit":{"description":"Ürünün satış miktarı birimi.","examples":["adet"],"title":"Unit","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"},"variants":{"anyOf":[{"items":{"$ref":"#/components/schemas/Variant"},"type":"array"},{"type":"null"}],"description":"include=variants ile eklenen seçenekler.","examples":[[{"archived":false,"barcode":"8690000000001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","expired":false,"id":"var_1234567890abcdef1234567890abcdef","is_default":true,"made_to_order":false,"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"pool_quantity":"1.000","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","sku":"KUPA-MAVI","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z"}]],"title":"Variants"}},"required":["id","name","slug","code","status","kind","brand","price","compare_price","currency","tax_rate","tax_status","unit","quantity_step","minimum_quantity","maximum_quantity","pool_unit","made_to_order","preparation","short_description","description","images","archived","created_at","updated_at"],"title":"Product","type":"object"},"ProductBrand":{"additionalProperties":false,"properties":{"archived":{"description":"Arşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.","examples":[false],"title":"Archived","type":"boolean"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"id":{"description":"Kaynağın dış kimliği; brd_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["brd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"logo":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün markasının logo adresi.","examples":["https://example.com/logo.png"],"title":"Logo"},"name":{"description":"Kaydın görünen adı.","examples":["Örnek Üretici"],"title":"Name","type":"string"},"revision":{"description":"Kaydın revizyonu; If-Match için ETag ile birlikte kullanılır.","examples":[1],"title":"Revision","type":"integer"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Adreslerde kullanılan kısa ad.","examples":["ornek-kupa"],"title":"Slug"},"sort_order":{"description":"Panel ve vitrindeki sırası; küçük değer önce gelir.","examples":[0],"title":"Sort Order","type":"integer"},"status":{"description":"Kaynağın işlem durumu.","examples":["active"],"title":"Status","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["revision","sort_order","id","name","slug","status","logo","archived","created_at","updated_at"],"title":"ProductBrand","type":"object"},"ProductsExportFilters":{"additionalProperties":false,"properties":{"archived":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"},"status":{"anyOf":[{"enum":["active","draft","inactive"],"type":"string"},{"type":"null"}],"description":"Durum eşitlik süzgeci; desteklenen değerler şemada listelenir.","examples":["active"],"title":"Status"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"},"updated_after":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç dahil; saat dilimli RFC 3339 zamanı.","examples":["2026-10-16T09:00:00Z"],"title":"Updated After"},"updated_before":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş hariç; saat dilimli RFC 3339 zamanı.","examples":["2026-10-17T09:00:00Z"],"title":"Updated Before"}},"title":"ProductsExportFilters","type":"object"},"ProductsExportInput":{"additionalProperties":false,"properties":{"filters":{"$ref":"#/components/schemas/ProductsExportFilters","description":"Kaynağın liste süzgeçleri; limit, cursor ve include desteklenmez.","examples":[{}]},"format":{"description":"jsonl: satır başına JSON nesnesi; csv: her hücresi JSON değeri olan CSV.","enum":["jsonl","csv"],"examples":["jsonl"],"title":"Format","type":"string"},"mode":{"const":"consistent_snapshot","description":"consistent_snapshot: bütün kayıtlar aynı anın tutarlı görünümüdür.","examples":["consistent_snapshot"],"title":"Mode","type":"string"},"resource":{"const":"products","description":"Dışa aktarılacak kaynak; aynı kaynağın okuma kapsamı gerekir.","examples":["products"],"title":"Resource","type":"string"}},"required":["mode","format","resource"],"title":"ProductsExportInput","type":"object"},"QuoteCarrier":{"additionalProperties":false,"properties":{"available":{"description":"Ücret, adres ve bakiye yönünden gönderim uygunsa true; açılışta yeniden denetlenir.","examples":[true],"title":"Available","type":"boolean"},"cod_fee":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ücrete dahil kapıda tahsilat bedeli, TRY; bilinmiyorsa null.","examples":["29.90"],"title":"Cod Fee"},"code":{"description":"Gönderi açarken carrier alanına gönderilecek firma kodu.","examples":["YURTICI"],"title":"Code","type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Engelin Türkçe açıklaması; yoksa null.","examples":[null],"title":"Detail"},"fee":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Bu fiziksel gönderinin TRY ücreti; bilinen kapıda tahsilat bedeli dahil. null ise açılamaz.","examples":["124.80"],"title":"Fee"},"name":{"description":"Kargo firmasının adı.","examples":["Yurtiçi Kargo"],"title":"Name","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Varsa kapıda ödeme bedeli uyarısı.","examples":[null],"title":"Note"},"problem_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Gönderim engelinin kararlı kodu; yoksa null.","examples":[null],"title":"Problem Code"}},"required":["code","name","fee","cod_fee","available","problem_code","detail","note"],"title":"QuoteCarrier","type":"object"},"QuoteInput":{"additionalProperties":false,"properties":{"merge_orders":{"description":"Aynı marka, alıcı, adres ve depodaki diğer ord_ siparişleri; birleştirme açık seçimdir.","examples":[[]],"items":{"type":"string"},"maxItems":99,"title":"Merge Orders","type":"array"},"package":{"anyOf":[{"$ref":"#/components/schemas/Package"},{"type":"null"}],"description":"Yalnız bu sorgu için ölçüler; sorgu siparişi değiştirmez. Açarken aynı ölçüleri gönderin.","examples":[{"boxes":[{"depth":20,"height":20,"weight":1,"width":20}]}]}},"title":"QuoteInput","type":"object"},"ReadyOrder":{"additionalProperties":false,"properties":{"expected_status":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"description":"Gördüğünüz sipariş durumu; kilit altında farklıysa 409 status_mismatch.","examples":["confirmed"],"title":"Expected Status"},"notified":{"const":true,"description":"Müşteriye hazır olduğu bildirildiyse true; bu uç bildirim göndermez.","examples":[true],"title":"Notified","type":"boolean"},"reason":{"default":"","description":"İşlemin gerekçesi; correct-status ve başka kanalda bildirilen satışın iptali için zorunlu.","examples":["Müşteri teslim aldı."],"maxLength":1000,"title":"Reason","type":"string"}},"required":["notified"],"title":"ReadyOrder","type":"object"},"ReceiptLine":{"additionalProperties":false,"examples":[{"quantity":"2","sku":"KUPA-MAVI"}],"properties":{"quantity":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"}],"description":"İşlenecek miktar; en çok üç ondalık hane, adet biriminde tam sayı.","examples":["2"],"title":"Quantity"},"sku":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"description":"Stok kodu; baş/son boşluk ve harf farkı kaldırılarak tam eşleşir.","examples":["KUPA-MAVI"],"title":"Sku"},"unit_price":{"anyOf":[{"maximum":999999999,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"TRY birim alış fiyatı; costs:write gerekir. KDV dahil/hariç seçimi belge üzerindedir; ürünün KDV oranı kullanılır.","examples":["120.00"],"title":"Unit Price"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"var_ seçenek kimliği; variant veya sku alanından tam biri gerekir. Ortak stokta havuzun var_ kimliğini kullanın.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["quantity"],"title":"ReceiptLine","type":"object"},"ReceiveOrderPayment":{"additionalProperties":false,"properties":{"expected_due":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"İşlemden önce gördüğünüz kalan tutar; değişmişse işlem yapılmaz.","examples":["120.00"],"title":"Expected Due"},"expected_status":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"description":"Gördüğünüz sipariş durumu; kilit altında farklıysa 409 status_mismatch.","examples":["confirmed"],"title":"Expected Status"},"parts":{"description":"Alınan gerçek ödemeler; panelin aynı tahsilat servisine yazılır.","examples":[[{"amount":"120.00","method":"cash"}]],"items":{"$ref":"#/components/schemas/PaymentPart"},"maxItems":20,"minItems":1,"title":"Parts","type":"array"},"reason":{"default":"","description":"İşlemin gerekçesi; correct-status ve başka kanalda bildirilen satışın iptali için zorunlu.","examples":["Müşteri teslim aldı."],"maxLength":1000,"title":"Reason","type":"string"}},"required":["parts","expected_due"],"title":"ReceiveOrderPayment","type":"object"},"ReceiveStock":{"additionalProperties":false,"properties":{"external_reference":{"anyOf":[{"$ref":"#/components/schemas/StockReference"},{"type":"null"}],"description":"Dış belge numarasını grant ad alanında tekilleştirir; çakışma 409 external_reference_conflict.","examples":[{"id":"MAL-2026-001"}]},"invoice_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"description":"Fatura tarihi; gelecekte olamaz, numara varsa ve tarih yoksa markanın bugünü. costs:write gerekir.","examples":["2026-10-16"],"title":"Invoice Date"},"invoice_number":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"description":"Tedarikçi fatura numarası; costs:write gerekir.","examples":["TEST2026000000001"],"title":"Invoice Number"},"lines":{"description":"Gelen seçenekler, miktarları ve isteğe bağlı alış fiyatları.","examples":[[{"quantity":"2","sku":"KUPA-MAVI"}]],"items":{"$ref":"#/components/schemas/ReceiptLine"},"maxItems":500,"minItems":1,"title":"Lines","type":"array"},"location":{"description":"İşlemin loc_ depo kimliği; /locations listesinden seçin.","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location","type":"string"},"note":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"description":"İç açıklama; internal_notes:write gerekir, okumak için internal_notes:read gerekir.","examples":["Depoda kontrol edildi."],"title":"Note"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sto_ marka kimliği; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"},"supplier":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Mevcut sup_ tedarikçi kimliği; costs:write gerekir. Atlanırsa kendi stoğunuzdur; yeni tedarikçi panelden açılır.","examples":["sup_1234567890abcdef1234567890abcdef"],"title":"Supplier"},"vat_included":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Alış fiyatı KDV dahilse true; costs:write gerekir. Atlanırsa işletmenin panel varsayılanı kullanılır.","examples":[false],"title":"Vat Included"}},"required":["location","lines"],"title":"ReceiveStock","type":"object"},"RefundInput":{"additionalProperties":false,"examples":[{"items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1"}]}],"properties":{"amount":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"İsteğe bağlı TRY tutarı; boşsa panelin önerisi. Kalan tahsilatı aşamaz.","examples":["120.00"],"title":"Amount"},"items":{"description":"İade kalemleri; boşsa yalnız para iadesidir ve amount zorunludur.","examples":[[]],"items":{"$ref":"#/components/schemas/ReturnItem"},"maxItems":200,"title":"Items","type":"array"},"money_returned":{"default":false,"description":"Parayı gerçekten elle geri verdiyseniz true. Çevrimiçi kartta false bırakın; sağlayıcı sonucu beklenir.","examples":[false],"title":"Money Returned","type":"boolean"},"notify_customer":{"default":true,"description":"İade e-postasını müşteriye gönder.","examples":[true],"title":"Notify Customer","type":"boolean"},"reason":{"default":"","description":"İade nedeni; kişisel bilgi yazmayın.","examples":["Müşteri ürünü iade etti"],"maxLength":200,"title":"Reason","type":"string"},"received_condition":{"anyOf":[{"enum":["sound","damaged"],"type":"string"},{"type":"null"}],"description":"Fiziksel teslim onayı. Fire için damaged ve restock=false birlikte gerekir.","examples":["sound"],"title":"Received Condition"},"refund_distribution":{"anyOf":[{"$ref":"#/components/schemas/Distribution-Input"},{"type":"null"}],"description":"Değişim/ayrılan siparişte önizlemenin kart ve elle ödeme dağılımı; oluştururken aynen gönderin.","examples":[{"card":"100.00","manual":"20.00","provider":"PayTR"}]},"refund_method":{"anyOf":[{"enum":["cash","pos","iban"],"type":"string"},{"type":"null"}],"description":"Panelin izin verdiği elle iade yolu; çevrimiçi karta iade otomatik belirlenir.","examples":[null],"title":"Refund Method"},"refund_parts":{"anyOf":[{"items":{"$ref":"#/components/schemas/RefundPart"},"maxItems":20,"minItems":2,"type":"array"},{"type":"null"}],"description":"Elle geri verilen parçalar; toplam iade tutarına eşit, money_returned=true olmalı.","examples":[null],"title":"Refund Parts"},"restock":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Stoğa geri ekleme seçimi. Boşsa panel/AI varsayılanı: iade edilemez veya hasarlı ürün eklenmez. false tek başına fire yazmaz.","examples":[null],"title":"Restock"}},"title":"RefundInput","type":"object"},"RefundPart":{"additionalProperties":false,"properties":{"amount":{"anyOf":[{"exclusiveMinimum":0,"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"}],"description":"Gerçekten geri verilen tutar, TRY; ondalık metin.","examples":["120.00"],"title":"Amount"},"method":{"description":"cash: nakit; pos: POS cihazından kart iadesi; bank: havale.","enum":["cash","pos","bank"],"examples":["cash"],"title":"Method","type":"string"}},"required":["method","amount"],"title":"RefundPart","type":"object"},"RefundPreview":{"additionalProperties":false,"properties":{"amount":{"description":"İade edilecek TRY tutarı; expected_amount olarak gönderin.","examples":["120.00"],"title":"Amount","type":"string"},"completes":{"description":"Bu işlem siparişi tam iade durumuna geçirecekse true.","examples":[true],"title":"Completes","type":"boolean"},"currency":{"const":"TRY","default":"TRY","description":"Tutarların para birimi.","examples":["TRY"],"title":"Currency","type":"string"},"items":{"description":"Doğrulanmış iade kalemleri ve uygulanacak stok seçimi.","examples":[[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","restock":true,"unit":"adet"}]],"items":{"$ref":"#/components/schemas/RefundPreviewItem"},"title":"Items","type":"array"},"order":{"description":"İadesi önizlenen ord_ siparişi.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Order","type":"string"},"refund_distribution":{"anyOf":[{"$ref":"#/components/schemas/Distribution-Output"},{"type":"null"}],"description":"Değişim/ayrılan siparişte onaylanması gereken kart ve elle ödeme tutarları.","examples":[{"card":"100.00","manual":"20.00","provider":"PayTR"}]},"refund_method":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Paranın yolu: card, cash, iban, pos veya split; belirlenmemişse null.","examples":["iban"],"title":"Refund Method"},"remaining":{"description":"İade edilebilecek kalan TRY tutarı.","examples":["120.00"],"title":"Remaining","type":"string"},"shipping_included":{"description":"Panel hesabı kalan kargo bedelini içeriyorsa true.","examples":[true],"title":"Shipping Included","type":"boolean"},"suggested_amount":{"description":"Panelin önerdiği TRY tutarı.","examples":["120.00"],"title":"Suggested Amount","type":"string"},"warnings":{"description":"Panelin kart bekleme ve stoğa geri almama uyarıları.","examples":[[]],"items":{"type":"string"},"title":"Warnings","type":"array"}},"required":["order","items","amount","suggested_amount","remaining","shipping_included","completes","refund_method","refund_distribution","warnings"],"title":"RefundPreview","type":"object"},"RefundPreviewItem":{"additionalProperties":false,"properties":{"item":{"description":"İade edilecek lin_ kalemi.","examples":["lin_1234567890abcdef1234567890abcdef"],"title":"Item","type":"string"},"quantity":{"description":"İade miktarı; kalemin biriminde ondalık metin.","examples":["1.000"],"title":"Quantity","type":"string"},"restock":{"description":"Bu kalem iade edildiğinde satılabilir stoğa geri eklenecekse true.","examples":[true],"title":"Restock","type":"boolean"},"unit":{"description":"Miktarın birimi.","examples":["adet"],"title":"Unit","type":"string"}},"required":["item","quantity","unit","restock"],"title":"RefundPreviewItem","type":"object"},"RefundResult":{"additionalProperties":false,"properties":{"amount":{"description":"İadenin TRY tutarı; tamamı ödenmiş anlamına gelmez.","examples":["120.00"],"title":"Amount","type":"string"},"card_status":{"anyOf":[{"enum":["pending","blocked","unknown","failed"],"type":"string"},{"type":"null"}],"description":"Kart iadesinin bekleyen/belirsiz/hatalı durumu; sorun yoksa null.","examples":["pending"],"title":"Card Status"},"currency":{"const":"TRY","default":"TRY","description":"İadenin para birimi.","examples":["TRY"],"title":"Currency","type":"string"},"id":{"description":"İade işleminin ret_ kimliği; ödeme hareketinin rfd_ kimliğinden ayrıdır.","examples":["ret_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"items":{"description":"İade kalemleri; yalnız para iadesinde boş.","examples":[[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","unit":"adet"}]],"items":{"$ref":"#/components/schemas/PreviewItem"},"title":"Items","type":"array"},"money_returned":{"description":"Bu iadenin parası geri verilmişse true.","examples":[false],"title":"Money Returned","type":"boolean"},"order":{"description":"Ürünlerin ait olduğu ord_ siparişi.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Order","type":"string"},"payments":{"anyOf":[{"$ref":"#/components/schemas/Payments"},{"type":"null"}],"description":"Ödeme listesi ve güncel para özeti; yalnız payments:read ile görünür. Değişimden devreden bedel ortak hesaba dahildir.","examples":[{"data":[{"amount":"120.00","channel":"bank","created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"col_1234567890abcdef1234567890abcdef","kind":"payment","settled_at":"2026-10-16T09:00:00Z","status":"succeeded","test":false,"type":"collection"}],"has_more":false,"next_cursor":null,"summary":{"carried":"0.00","collect_due":"0.00","collected":"120.00","currency":"TRY","has_collection":true,"kept":"120.00","legacy":false,"refund_due":"0.00","reserved":"0.00","returned":"0.00","test":false}}]},"remaining_amount":{"description":"Bu iadenin henüz geri verilmemiş TRY tutarı; kart bekliyorsa elle ödeme yapmayın.","examples":["120.00"],"title":"Remaining Amount","type":"string"},"restock":{"description":"Bu iadede stoğa geri ekleme seçilmişse true.","examples":[true],"title":"Restock","type":"boolean"}},"required":["id","order","amount","remaining_amount","money_returned","card_status","restock","items"],"title":"RefundResult","type":"object"},"Replay":{"additionalProperties":false,"properties":{"event":{"description":"Olay kimliği (evt_ ve 32 küçük onaltılık karakter).","examples":["evt_1234567890abcdef1234567890abcdef"],"title":"Event","type":"string"}},"required":["event"],"title":"Replay","type":"object"},"Return":{"additionalProperties":false,"examples":[{"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"ret_1234567890abcdef1234567890abcdef","kind":"return","refund_amount":null,"requested_at":"2026-10-16T09:00:00Z","source":"customer","status":"requested","updated_at":"2026-10-16T09:00:00Z"}],"properties":{"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","default":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"id":{"description":"Kaynağın dış kimliği; ret_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["ret_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"kind":{"description":"İade veya değişim türü. Değerler: return, exchange, money. Türkçe karşılıkları: https://developer.siparis.app/referans#iade-turleri.","examples":["return"],"title":"Kind","type":"string"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İşlemin nedeni.","examples":["sale"],"title":"Reason"},"refund_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İade tutarı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Refund Amount"},"requested_at":{"description":"Talep zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Requested At","type":"string"},"source":{"description":"Kaydın oluşturulduğu kanal veya uygulama.","examples":["panel"],"title":"Source","type":"string"},"status":{"description":"İade/değişim talebinin durumu. Değerler: requested, approved, declined, code_sent, arrived, refund_pending, refunded, exchanged, closed, exchange_cancelled. Türkçe karşılıkları: https://developer.siparis.app/referans#iade-durumlari.","examples":["requested"],"title":"Status","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","kind","status","source","refund_amount","requested_at","created_at","updated_at"],"title":"Return","type":"object"},"ReturnDetail":{"additionalProperties":false,"properties":{"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","default":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"decision_note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Karar notu; personal_data:read gerekir.","examples":[null],"title":"Decision Note"},"id":{"description":"Kaynağın dış kimliği; ret_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["ret_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"items":{"description":"Talep edilen kalemler ve miktarlar.","examples":[[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","unit":"adet"}]],"items":{"$ref":"#/components/schemas/PreviewItem"},"title":"Items","type":"array"},"kind":{"description":"İade veya değişim türü.","examples":["return"],"title":"Kind","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Müşteri notu; personal_data:read gerekir.","examples":[null],"title":"Note"},"order":{"description":"Talebin ord_ siparişi.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Order","type":"string"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İşlemin nedeni.","examples":["sale"],"title":"Reason"},"refund_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İade tutarı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Refund Amount"},"requested_at":{"description":"Talep zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Requested At","type":"string"},"source":{"description":"Kaydın oluşturulduğu kanal veya uygulama.","examples":["panel"],"title":"Source","type":"string"},"status":{"description":"İade/değişim talebinin durumu.","examples":["requested"],"title":"Status","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"},"want":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Değişimde istenen; personal_data:read gerekir.","examples":[null],"title":"Want"}},"required":["id","kind","status","source","refund_amount","requested_at","created_at","updated_at","order","items"],"title":"ReturnDetail","type":"object"},"ReturnItem":{"additionalProperties":false,"properties":{"item":{"description":"Sipariş kaleminin lin_ dış kimliği.","examples":["lin_1234567890abcdef1234567890abcdef"],"title":"Item","type":"string"},"quantity":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"}],"description":"İade miktarı; kalemin biriminde, en çok üç ondalık hane.","examples":["1"],"title":"Quantity"}},"required":["item","quantity"],"title":"ReturnItem","type":"object"},"ReverseStock":{"additionalProperties":false,"properties":{"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sto_ marka kimliği; API belgesinde özgün marka kullanılır, diğer belgelerde çok marka varsa seçin.","examples":[null],"title":"Store"}},"title":"ReverseStock","type":"object"},"Rotation":{"additionalProperties":false,"properties":{"overlap_hours":{"default":24,"description":"Eski webhook sırrının da geçerli kalacağı saat sayısı; varsayılan 24, 1–168 saat.","examples":[24],"maximum":168,"minimum":1,"title":"Overlap Hours","type":"integer"}},"title":"Rotation","type":"object"},"Shipment":{"additionalProperties":false,"examples":[{"carrier":"YURTICI","cod_amount":"120.00","collected_amount":null,"combined":true,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","delivered_at":null,"id":"shp_1234567890abcdef1234567890abcdef","shipping_fee":"0.00","state":"ready","status":"created","updated_at":"2026-10-16T09:00:00Z"}],"properties":{"barcode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Gönderi barkodu; personal_data:read gerekir.","examples":[null],"title":"Barcode"},"cancellation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İptal isteğinin pending, unknown, succeeded veya failed durumu; kargonun durumu kesin sonuçtan sonra değişir.","examples":["pending"],"title":"Cancellation Status"},"carrier":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kargo firmasının kodu.","examples":["YURTICI"],"title":"Carrier"},"cod_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kapıda tahsil edilecek tutar; sipariş alt kaynağında siparişin payı, tek gönderi okumasında fiziksel toplam; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Cod Amount"},"cod_cost":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kapıda ödeme maliyeti; costs:read gerekir; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["5.00"],"title":"Cod Cost"},"cod_state":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kapıda ödeme tahsilatının kargo firmasından bağımsız ortak durumu; kapıda ödemesiz gönderide ve tanınmayan kodda null. Değerler: pending, collected, settled, settled_direct, not_collected. Türkçe karşılıkları: https://developer.siparis.app/referans#kapida-odeme-durumlari.","examples":["collected"],"title":"Cod State"},"cod_status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kapıda ödeme tahsilat durumu; cod_state ile aynı değer (önceki ad).","examples":["collected"],"title":"Cod Status"},"collected_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kargoda tahsil edilen tutar; sipariş alt kaynağında siparişin payı, tek gönderi okumasında fiziksel toplam; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Collected Amount"},"combined":{"description":"Gönderi birden fazla sipariş içeriyorsa true; sipariş alt kaynağı payı, tek gönderi okuması toplamı verir.","examples":[false],"title":"Combined","type":"boolean"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","default":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"delivered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Teslim zamanı; RFC 3339 UTC. Değer yoksa null.","examples":["2026-10-16T09:00:00Z"],"title":"Delivered At"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Gönderi açılamadıysa kararlı hata kodu; yeni gönderi öncesi hatayı giderin.","examples":[null],"title":"Error Code"},"id":{"description":"Kaynağın dış kimliği; shp_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["shp_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"return_cost":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Dönüş kargo maliyeti; costs:read gerekir; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Return Cost"},"shipping_cost":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kargo maliyeti; costs:read gerekir; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["40.00"],"title":"Shipping Cost"},"shipping_fee":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Müşteriden alınan kargo ücreti; sipariş alt kaynağında siparişin payı, tek gönderi okumasında fiziksel toplam; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["0.00"],"title":"Shipping Fee"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Gönderinin kargo firmasından bağımsız ortak durumu; açılış beklerken (status pending), açılamadıysa (failed) ve firmanın tanınmayan kodunda null. Değerler: draft, ready, in_transit, delivered, returning, returned, lost, cancelled. Türkçe karşılıkları: https://developer.siparis.app/referans#gonderi-ortak-durumlari.","examples":["ready"],"title":"State"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kargo firmasının gönderi durumu; pending açılış sonucu bekleniyor, failed gönderi açılamadı. Firmadan bağımsız okumak için state. Değerler: pending, failed, created, NEW, READY_TO_SHIP, SHIPPED, OUT_FOR_DELIVERY, DELIVERED, COMPLETED, NEEDS_SUPPORT, DELAYED, RETURNING, RETURNED, LOST, DELETED, cancelled. Türkçe karşılıkları: https://developer.siparis.app/referans#gonderi-durumlari.","examples":["created"],"title":"Status"},"tracking_code":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kargo takip kodu; personal_data:read gerekir.","examples":["TEST-TAKIP-001"],"title":"Tracking Code"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","status","carrier","shipping_fee","cod_amount","collected_amount","combined","created_at","updated_at","delivered_at"],"title":"Shipment","type":"object"},"ShipmentQuote":{"additionalProperties":false,"properties":{"boxes":{"description":"Hesapta kullanılan koliler; ağırlık kg, ölçüler cm.","examples":[[{"depth":20,"height":20,"weight":1,"width":20}]],"items":{"$ref":"#/components/schemas/Box"},"title":"Boxes","type":"array"},"carriers":{"description":"Panelin açık firma seçenekleri ve ücretleri.","examples":[[{"available":true,"cod_fee":"29.90","code":"YURTICI","detail":null,"fee":"124.80","name":"Yurtiçi Kargo","note":null,"problem_code":null}]],"items":{"$ref":"#/components/schemas/QuoteCarrier"},"title":"Carriers","type":"array"},"cod_amount":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kurye tarafından tahsil edilecek TRY tutarı; kapora düşülür, ortak gönderide üyelerin kalanları toplanır.","examples":["120.00"],"title":"Cod Amount"},"cod_type":{"anyOf":[{"enum":["cash","card"],"type":"string"},{"type":"null"}],"description":"Kapıda nakit veya kart; kapıda ödeme yoksa null.","examples":["cash"],"title":"Cod Type"},"currency":{"const":"TRY","default":"TRY","description":"Ücretlerin para birimi.","examples":["TRY"],"title":"Currency","type":"string"},"default_carrier":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Panelin varsayılan firma kodu.","examples":["YURTICI"],"title":"Default Carrier"},"order":{"description":"Fiyat sorulan ord_ siparişi.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Order","type":"string"},"package_version":{"description":"Kalıcı koli düzeltmesinde kullanılabilecek görülen sürüm.","examples":["0123456789abcdef"],"title":"Package Version","type":"string"},"package_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ölçüsü eksik ürünler için panelin uyarısı.","examples":[null],"title":"Package Warning"},"payment_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Kapıda ödeme dışındaki kalan ödeme uyarısı.","examples":[null],"title":"Payment Warning"}},"required":["order","carriers","default_carrier","boxes","package_version","cod_amount","cod_type","package_warning","payment_warning"],"title":"ShipmentQuote","type":"object"},"StockLine":{"additionalProperties":false,"examples":[{"quantity":"2","sku":"KUPA-MAVI"}],"properties":{"quantity":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,3}0*$","type":"string"}],"description":"İşlenecek miktar; en çok üç ondalık hane, adet biriminde tam sayı.","examples":["2"],"title":"Quantity"},"sku":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"description":"Stok kodu; baş/son boşluk ve harf farkı kaldırılarak tam eşleşir.","examples":["KUPA-MAVI"],"title":"Sku"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"var_ seçenek kimliği; variant veya sku alanından tam biri gerekir. Ortak stokta havuzun var_ kimliğini kullanın.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["quantity"],"title":"StockLine","type":"object"},"StockReference":{"additionalProperties":false,"properties":{"id":{"description":"Kendi sisteminizdeki belge numarası; bu API bağlantısında tekildir.","examples":["MAL-2026-001"],"maxLength":200,"minLength":1,"title":"Id","type":"string"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ad alanı kalıcı grt_ bağlantı kimliğidir; atlanabilir, başka ad alanı seçilemez.","examples":[null],"title":"Namespace"}},"required":["id"],"title":"StockReference","type":"object"},"Store":{"additionalProperties":false,"properties":{"active":{"description":"Kayıt etkinse true.","examples":[true],"title":"Active","type":"boolean"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"id":{"description":"Kaynağın dış kimliği; sto_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"name":{"description":"Kaydın görünen adı.","examples":["Örnek Marka"],"title":"Name","type":"string"},"slug":{"description":"Adreslerde kullanılan kısa ad.","examples":["ornek-kupa"],"title":"Slug","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","name","slug","active","created_at","updated_at"],"title":"Store","type":"object"},"StorePrice":{"additionalProperties":false,"properties":{"archived":{"description":"Arşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.","examples":[false],"title":"Archived","type":"boolean"},"compare_price":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Karşılaştırma fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["150.00"],"title":"Compare Price"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Satış fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Price"},"product":{"description":"Ürün kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product","type":"string"},"store":{"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store","type":"string"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçenek kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},"required":["store","product","variant","price","compare_price","currency","archived","created_at","updated_at"],"title":"StorePrice","type":"object"},"StorePriceInput":{"additionalProperties":false,"examples":[{"compare_price":"140.00","price":"110.00"}],"properties":{"compare_price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Markanın üstü çizili fiyatı; null katalog değerini devralır. İki fiyat da null ise marka fiyat satırı kalkar.","examples":["140.00"],"title":"Compare Price"},"price":{"anyOf":[{"maximum":10000000,"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d{0,2}0*$","type":"string"},{"type":"null"}],"description":"Markanın TRY satış fiyatı; null katalog fiyatını devralır.","examples":["110.00"],"title":"Price"},"variant":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı var_ kimliği; null veya atlanırsa ürünün marka fiyatı. Tekrar anahtarının gövde özetine dahildir.","examples":[null],"title":"Variant"}},"required":["price","compare_price"],"title":"StorePriceInput","type":"object"},"Supplier":{"additionalProperties":false,"properties":{"id":{"description":"Kaynağın dış kimliği; sup_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["sup_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"name":{"description":"Kaydın görünen adı.","examples":["Örnek Tedarikçi"],"title":"Name","type":"string"}},"required":["id","name"],"title":"Supplier","type":"object"},"TaxonomyAction":{"additionalProperties":false,"description":"Arşiv eylemlerine boş JSON gönderilir.","properties":{},"title":"TaxonomyAction","type":"object"},"TransferStock":{"additionalProperties":false,"properties":{"lines":{"description":"Taşınacak seçenekler ve pozitif miktarları; kaynak depo bakiyesini aşamaz.","examples":[[{"quantity":"2","sku":"KUPA-MAVI"}]],"items":{"$ref":"#/components/schemas/StockLine"},"maxItems":500,"minItems":1,"title":"Lines","type":"array"},"location":{"description":"İşlemin loc_ depo kimliği; /locations listesinden seçin.","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location","type":"string"},"note":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"description":"İç açıklama; internal_notes:write gerekir, okumak için internal_notes:read gerekir.","examples":["Depoda kontrol edildi."],"title":"Note"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sto_ marka kimliği; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"},"to_location":{"description":"Hedef loc_ depo kimliği; kaynak location alanından farklı olmalıdır.","examples":["loc_abcdef1234567890abcdef1234567890"],"title":"To Location","type":"string"}},"required":["location","to_location","lines"],"title":"TransferStock","type":"object"},"UnchangedCount":{"additionalProperties":false,"properties":{"changed":{"const":false,"description":"Güncel miktar sayımla aynı; ortak servis belge açmadı.","examples":[false],"title":"Changed","type":"boolean"}},"required":["changed"],"title":"UnchangedCount","type":"object"},"Variant":{"additionalProperties":false,"properties":{"archived":{"description":"Arşivdeki veya kapanmış kaynaksa true. archived=true süzgeci bunları da içerir.","examples":[false],"title":"Archived","type":"boolean"},"barcode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürünün veya seçeneğin barkodu.","examples":["8690000000001"],"title":"Barcode"},"compare_price":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Karşılaştırma fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["150.00"],"title":"Compare Price"},"cost":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Maliyet; yalnız costs:read ile görünür; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["80.00"],"title":"Cost"},"created_at":{"description":"Oluşturulma zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Created At","type":"string"},"currency":{"const":"TRY","description":"Para birimi; v1 tutarları Türk lirasıdır.","examples":["TRY"],"title":"Currency","type":"string"},"expired":{"description":"Seçenek emekli edilmişse true.","examples":[false],"title":"Expired","type":"boolean"},"id":{"description":"Kaynağın dış kimliği; var_ ve 32 küçük onaltılık karakter. İç sayısal kimlik kullanılmaz.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"},"is_default":{"description":"Varsayılan seçenek veya depo ise true.","examples":[true],"title":"Is Default","type":"boolean"},"made_to_order":{"description":"Sipariş üzerine hazırlanırsa true; sayılmayan stoktan önceliklidir.","examples":[false],"title":"Made To Order","type":"boolean"},"name":{"description":"Kaydın görünen adı.","examples":["Mavi"],"title":"Name","type":"string"},"options":{"description":"Seçeneğin ad/değer özellikleri.","examples":[[{"name":"Renk","value":"Mavi"}]],"items":{"$ref":"#/components/schemas/Option"},"title":"Options","type":"array"},"pool_quantity":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçeneğin ortak stoktan kullandığı miktar; birimi ilgili ürün/depo alanında verilen ondalık metin.","examples":["1.000"],"title":"Pool Quantity"},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Satış fiyatı; TRY cinsinden ondalık metin. Kuruş kaybını önlemek için ondalık sayı kütüphanesiyle işleyin.","examples":["120.00"],"title":"Price"},"product":{"description":"Ürün kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product","type":"string"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stok takip kodu; eşitlik araması normalize edilerek yapılır.","examples":["KUPA-MAVI"],"title":"Sku"},"stock_uncounted":{"description":"Stok sayılmıyorsa true; stok miktarı null sunulur.","examples":[false],"title":"Stock Uncounted","type":"boolean"},"updated_at":{"description":"Son değişiklik zamanı; RFC 3339 UTC.","examples":["2026-10-16T09:00:00Z"],"format":"date-time","title":"Updated At","type":"string"}},"required":["id","product","name","sku","barcode","is_default","options","price","compare_price","currency","made_to_order","stock_uncounted","expired","pool_quantity","archived","created_at","updated_at"],"title":"Variant","type":"object"},"VariantsExportFilters":{"additionalProperties":false,"properties":{"archived":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"},"barcode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Normalize edilmiş barkodla tam eşitlik; sku da verilirse ikisi eşleşir.","examples":["8690000000001"],"title":"Barcode"},"product":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Normalize edilmiş stok koduyla tam eşitlik; barcode da verilirse ikisi eşleşir.","examples":["KUPA-MAVI"],"title":"Sku"}},"title":"VariantsExportFilters","type":"object"},"VariantsExportInput":{"additionalProperties":false,"properties":{"filters":{"$ref":"#/components/schemas/VariantsExportFilters","description":"Kaynağın liste süzgeçleri; limit, cursor ve include desteklenmez.","examples":[{}]},"format":{"description":"jsonl: satır başına JSON nesnesi; csv: her hücresi JSON değeri olan CSV.","enum":["jsonl","csv"],"examples":["jsonl"],"title":"Format","type":"string"},"mode":{"const":"consistent_snapshot","description":"consistent_snapshot: bütün kayıtlar aynı anın tutarlı görünümüdür.","examples":["consistent_snapshot"],"title":"Mode","type":"string"},"resource":{"const":"variants","description":"Dışa aktarılacak kaynak; aynı kaynağın okuma kapsamı gerekir.","examples":["variants"],"title":"Resource","type":"string"}},"required":["mode","format","resource"],"title":"VariantsExportInput","type":"object"},"WriteOffStock":{"additionalProperties":false,"properties":{"lines":{"description":"Azalan seçenekler ve pozitif miktarları.","examples":[[{"quantity":"2","sku":"KUPA-MAVI"}]],"items":{"$ref":"#/components/schemas/StockLine"},"maxItems":500,"minItems":1,"title":"Lines","type":"array"},"location":{"description":"İşlemin loc_ depo kimliği; /locations listesinden seçin.","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location","type":"string"},"note":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"description":"İç açıklama; internal_notes:write gerekir, okumak için internal_notes:read gerekir.","examples":["Depoda kontrol edildi."],"title":"Note"},"reason":{"description":"Panelin neden kodu: broken, lost, other her sektörde; defective/fitting/sample giyimde, expired gıda/kozmetikte. other için not zorunlu.","enum":["broken","lost","other","defective","fitting","sample","expired"],"examples":["broken"],"title":"Reason","type":"string"},"store":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"sto_ marka kimliği; tek markada veya marka sınırlı anahtarda atlanabilir.","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"}},"required":["location","lines","reason"],"title":"WriteOffStock","type":"object"}},"securitySchemes":{"HTTPBearer":{"scheme":"bearer","type":"http"},"oauth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://siparis.app/oauth/authorize","refreshUrl":"https://api.siparis.app/oauth/token","scopes":{"archive:write":"Arşivle ve geri getir","campaigns:read":"Kampanyalar · Gör","campaigns:write":"Kampanyalar · Değiştir","channels:read":"Kanalları gör","costs:read":"Maliyet ve tedarikçiyi gör","costs:write":"Alış fiyatı ve tedarikçiyi yaz","coupons:read":"Kuponlar · Gör","coupons:write":"Kuponlar · Değiştir","customers:erase":"KVKK anonimleştirmesi","customers:read":"Müşteriler · Gör","customers:write":"Müşteriler · Değiştir","events:read":"Olayları gör","exports:write":"Dışa aktar","internal_notes:read":"İç notları gör","internal_notes:write":"İç notları değiştir","inventory:read":"Stok · Gör","inventory:write":"Stok · Değiştir","invoices:read":"Faturalar · Gör","invoices:write":"Faturalar · Değiştir","money_out:write":"Para çıkışı","orders:read":"Siparişler · Gör","orders:write":"Siparişler · Değiştir","payments:read":"Ödemeleri gör","personal_data:read":"Kişisel verileri gör","personal_data:write":"Kişisel verileri değiştir","products:read":"Ürünler · Gör","products:write":"Ürünler · Değiştir","returns:read":"İadeler · Gör","returns:write":"İadeler · Değiştir","shipments:read":"Gönderiler · Gör","shipments:write":"Gönderiler · Değiştir","subscriptions:read":"Abonelikler · Gör","subscriptions:write":"Abonelikler · Değiştir","webhooks:manage":"Webhook yönet"},"tokenUrl":"https://api.siparis.app/oauth/token"}},"type":"oauth2"}}},"info":{"description":"Bu sürüm sipariş, müşteri, ürün, stok, kategori, ürün markası ve kupon okuma/yazma; gönderi, iade, fatura, dış satış bildirimi ve toplu fiyat/stok güncelleme uçlarını sunar. Kargo fiyatı, SVG etiketi, fatura belgesi ve KVKK müşteri anonimleştirmesi hazırdır. Ayrıca olay akışı, webhook, dışa aktarma, davetli OAuth uygulamaları, MCP ve SDK desteklenir. Yapılabilen işler: https://developer.siparis.app/neler-yapabilirim.\n\nBearer anahtarıyla erişim. Listeler anlık görünümdür; kalıcı eşitleme dışa aktarma ve olay akışını kullanır. Tutarlar ve miktarlar ondalık metin, saatler RFC 3339 UTC biçimindedir. archived=true arşivdeki kayıtları da içerir. Marka fiyatının anahtarı store, product ve variant alanlarıdır. Kişisel alanlar izin yoksa atlanır; örnekler uydurmadır ve kişisel veri içermez.","title":"siparis.app Açık API","version":"v1"},"openapi":"3.1.0","paths":{"/brands":{"get":{"description":"Ürünlerin üretici veya ticari markalarını alın. Bunlar işletmenin satış markaları olan stores ile aynı kavram değildir. Gerekli kapsamlar: products:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"brands_brands_get","parameters":[{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"brd_1234567890abcdef1234567890abcdef","logo":"https://example.com/logo.png","name":"Örnek Üretici","revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_ProductBrand_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Ürün markalarını listele","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor"],"x-include-cost":false,"x-notes":"Bunlar işletmenin satış markaları olan stores ile aynı kavram değildir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Ürünlerin üretici veya ticari markalarını alın.","x-read-cost":2,"x-required-scopes":["products:read"]},"post":{"description":"Ürünlerin üretici veya ticari markasını (ör. bir giyim markası) ekleyin. Ürün markası işletme genelindedir ve satış markanızdan (stores) farklıdır. Panelin kayıt servisi kullanılır; marka sınırlı bağlantı 403 alır. Aynı ad ayrı adresle açılabilir. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"brand_create_brands_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"name":"Örnek Üretici"},"schema":{"$ref":"#/components/schemas/CreateBrand"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"brd_1234567890abcdef1234567890abcdef","logo":"https://example.com/logo.png","name":"Örnek Üretici","revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/ProductBrand"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni kaydın API kökenine göre yolu.","schema":{"examples":["/v1/brands/brd_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"business_scope_required":{"summary":"Bu kayıt işletme genelindedir.","value":{"code":"business_scope_required","detail":"Bu kayıt işletme genelindedir.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:business_scope_required"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. business_scope_required: Bu kayıt işletme genelindedir. Bütün markalara yetkili bağlantı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"taxonomy_name_conflict":{"summary":"Aynı anda bu addan başka kayıt açıldı.","value":{"code":"taxonomy_name_conflict","detail":"Aynı anda bu addan başka kayıt açıldı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_name_conflict"}},"taxonomy_restore_conflict":{"summary":"Kayıt arşivden geri getirilemedi.","value":{"code":"taxonomy_restore_conflict","detail":"Kayıt arşivden geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. taxonomy_name_conflict: Aynı anda bu addan başka kayıt açıldı. Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin. taxonomy_restore_conflict: Kayıt arşivden geri getirilemedi. Güncel arşiv durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"category_cycle":{"summary":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","value":{"code":"category_cycle","detail":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:category_cycle"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. category_cycle: Kategori kendisinin veya alt kategorisinin altına taşınamaz. Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Ürün markası oluştur","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","business_scope_required","category_cycle","taxonomy_name_conflict","taxonomy_restore_conflict"],"x-include-cost":false,"x-notes":"Ürün markası işletme genelindedir ve satış markanızdan (stores) farklıdır. Panelin kayıt servisi kullanılır; marka sınırlı bağlantı 403 alır. Aynı ad ayrı adresle açılabilir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Ürünlerin üretici veya ticari markasını (ör. bir giyim markası) ekleyin.","x-read-cost":0,"x-required-scopes":["products:write"]}},"/brands/{id}":{"get":{"description":"Bir ürün markasının adını ve logosunu okuyun; ürünün brand alanını ayrıntılandırırken kullanın. Gerekli kapsamlar: products:read.","operationId":"brand_brands__id__get","parameters":[{"description":"Okunacak kaynağın brd_ önekli dış kimliği.","example":"brd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın brd_ önekli dış kimliği.","examples":["brd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"brd_1234567890abcdef1234567890abcdef","logo":"https://example.com/logo.png","name":"Örnek Üretici","revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/ProductBrand"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Ürün markasını getir","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bir ürün markasının adını ve logosunu okuyun; ürünün brand alanını ayrıntılandırırken kullanın.","x-read-cost":1,"x-required-scopes":["products:read"]},"patch":{"description":"Ürün markasının adını veya logosunu değiştirin. Panelin kayıt servisiyle yalnız gönderilen alanlar değişir. If-Match kaydın revizyonunu (sürüm numarasını) denetler; marka sınırlı bağlantı 403 alır. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"brand_update_brands__id__patch","parameters":[{"description":"Okunacak kaynağın brd_ önekli dış kimliği.","example":"brd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın brd_ önekli dış kimliği.","examples":["brd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/BrandFields"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"brd_1234567890abcdef1234567890abcdef","logo":"https://example.com/logo.png","name":"Örnek Üretici","revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/ProductBrand"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"business_scope_required":{"summary":"Bu kayıt işletme genelindedir.","value":{"code":"business_scope_required","detail":"Bu kayıt işletme genelindedir.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:business_scope_required"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. business_scope_required: Bu kayıt işletme genelindedir. Bütün markalara yetkili bağlantı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"taxonomy_name_conflict":{"summary":"Aynı anda bu addan başka kayıt açıldı.","value":{"code":"taxonomy_name_conflict","detail":"Aynı anda bu addan başka kayıt açıldı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_name_conflict"}},"taxonomy_restore_conflict":{"summary":"Kayıt arşivden geri getirilemedi.","value":{"code":"taxonomy_restore_conflict","detail":"Kayıt arşivden geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. taxonomy_name_conflict: Aynı anda bu addan başka kayıt açıldı. Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin. taxonomy_restore_conflict: Kayıt arşivden geri getirilemedi. Güncel arşiv durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"category_cycle":{"summary":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","value":{"code":"category_cycle","detail":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:category_cycle"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. category_cycle: Kategori kendisinin veya alt kategorisinin altına taşınamaz. Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Ürün markasını güncelle","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","business_scope_required","category_cycle","taxonomy_name_conflict","taxonomy_restore_conflict"],"x-include-cost":false,"x-notes":"Panelin kayıt servisiyle yalnız gönderilen alanlar değişir. If-Match kaydın revizyonunu (sürüm numarasını) denetler; marka sınırlı bağlantı 403 alır.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Ürün markasının adını veya logosunu değiştirin.","x-read-cost":0,"x-required-scopes":["products:write"]}},"/brands/{id}/archive":{"post":{"description":"Ürün markasını vitrinden kaldırın; ürün bağları silinmez. Boş JSON gönderin. Ürün bağları korunur, kayıt vitrinden kalkar. İşletme kapsamı ve archive:write gerekir. Gerekli kapsamlar: archive:write, products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"brand_archive_brands__id__archive_post","parameters":[{"description":"Okunacak kaynağın brd_ önekli dış kimliği.","example":"brd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın brd_ önekli dış kimliği.","examples":["brd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/TaxonomyAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"brd_1234567890abcdef1234567890abcdef","logo":"https://example.com/logo.png","name":"Örnek Üretici","revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/ProductBrand"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"business_scope_required":{"summary":"Bu kayıt işletme genelindedir.","value":{"code":"business_scope_required","detail":"Bu kayıt işletme genelindedir.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:business_scope_required"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. business_scope_required: Bu kayıt işletme genelindedir. Bütün markalara yetkili bağlantı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"taxonomy_name_conflict":{"summary":"Aynı anda bu addan başka kayıt açıldı.","value":{"code":"taxonomy_name_conflict","detail":"Aynı anda bu addan başka kayıt açıldı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_name_conflict"}},"taxonomy_restore_conflict":{"summary":"Kayıt arşivden geri getirilemedi.","value":{"code":"taxonomy_restore_conflict","detail":"Kayıt arşivden geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. taxonomy_name_conflict: Aynı anda bu addan başka kayıt açıldı. Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin. taxonomy_restore_conflict: Kayıt arşivden geri getirilemedi. Güncel arşiv durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"category_cycle":{"summary":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","value":{"code":"category_cycle","detail":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:category_cycle"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. category_cycle: Kategori kendisinin veya alt kategorisinin altına taşınamaz. Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","products:write"]}],"summary":"Ürün markasını arşivle","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","business_scope_required","category_cycle","taxonomy_name_conflict","taxonomy_restore_conflict"],"x-include-cost":false,"x-notes":"Boş JSON gönderin. Ürün bağları korunur, kayıt vitrinden kalkar. İşletme kapsamı ve archive:write gerekir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Ürün markasını vitrinden kaldırın; ürün bağları silinmez.","x-read-cost":0,"x-required-scopes":["archive:write","products:write"]}},"/brands/{id}/restore":{"post":{"description":"Arşivdeki ürün markasını geri getirin. Boş JSON gönderin. Panelin arşiv servisi kaydı geri getirir. İşletme kapsamı ve archive:write gerekir. Gerekli kapsamlar: archive:write, products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"brand_restore_brands__id__restore_post","parameters":[{"description":"Okunacak kaynağın brd_ önekli dış kimliği.","example":"brd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın brd_ önekli dış kimliği.","examples":["brd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/TaxonomyAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"brd_1234567890abcdef1234567890abcdef","logo":"https://example.com/logo.png","name":"Örnek Üretici","revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/ProductBrand"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"business_scope_required":{"summary":"Bu kayıt işletme genelindedir.","value":{"code":"business_scope_required","detail":"Bu kayıt işletme genelindedir.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:business_scope_required"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. business_scope_required: Bu kayıt işletme genelindedir. Bütün markalara yetkili bağlantı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"taxonomy_name_conflict":{"summary":"Aynı anda bu addan başka kayıt açıldı.","value":{"code":"taxonomy_name_conflict","detail":"Aynı anda bu addan başka kayıt açıldı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_name_conflict"}},"taxonomy_restore_conflict":{"summary":"Kayıt arşivden geri getirilemedi.","value":{"code":"taxonomy_restore_conflict","detail":"Kayıt arşivden geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. taxonomy_name_conflict: Aynı anda bu addan başka kayıt açıldı. Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin. taxonomy_restore_conflict: Kayıt arşivden geri getirilemedi. Güncel arşiv durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"category_cycle":{"summary":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","value":{"code":"category_cycle","detail":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:category_cycle"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. category_cycle: Kategori kendisinin veya alt kategorisinin altına taşınamaz. Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","products:write"]}],"summary":"Ürün markasını geri getir","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","business_scope_required","category_cycle","taxonomy_name_conflict","taxonomy_restore_conflict"],"x-include-cost":false,"x-notes":"Boş JSON gönderin. Panelin arşiv servisi kaydı geri getirir. İşletme kapsamı ve archive:write gerekir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Arşivdeki ürün markasını geri getirin.","x-read-cost":0,"x-required-scopes":["archive:write","products:write"]}},"/bulk/inventory":{"post":{"description":"Bir depodaki binlerce seçeneğin sayım sonucunu tek istekte yazın. En çok 10.000 satır, loc_ depo ve her satırda expected (sayımdan önce okuduğunuz miktar) zorunludur. Güncel miktar expected ile uyuşmazsa yalnız o satır stock_changed ile atlanır. 202 işini izleyin; bitince job.completed gelir. Gerekli kapsamlar: inventory:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"bulk_inventory_bulk_inventory_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"lines":[{"expected":"10","quantity":"12","sku":"KUPA-MAVI"}],"location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/BulkInventory"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","error_code":null,"failed":0,"finished_at":null,"id":"job_1234567890abcdef1234567890abcdef","kind":"prices","processed":0,"status":"queued","total":10000},"schema":{"$ref":"#/components/schemas/BulkJob"}}},"description":"Hazırlama kuyruğa alındı; dosya henüz hazır değildir.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"bulk_in_progress":{"summary":"Bu işletmede bir toplu iş sürüyor.","value":{"code":"bulk_in_progress","detail":"Bu işletmede bir toplu iş sürüyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:bulk_in_progress"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. bulk_in_progress: Bu işletmede bir toplu iş sürüyor. Önce açık işin bitmesini bekleyin; sonra yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:write"]}],"summary":"Toplu stok say","tags":["Toplu işler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","bulk_in_progress"],"x-include-cost":false,"x-notes":"En çok 10.000 satır, loc_ depo ve her satırda expected (sayımdan önce okuduğunuz miktar) zorunludur. Güncel miktar expected ile uyuşmazsa yalnız o satır stock_changed ile atlanır. 202 işini izleyin; bitince job.completed gelir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bir depodaki binlerce seçeneğin sayım sonucunu tek istekte yazın.","x-read-cost":60,"x-required-scopes":["inventory:write"]}},"/bulk/prices":{"post":{"description":"Binlerce ürün ve seçeneğin fiyatını tek istekte güncelleyin. En çok 10.000 satır; panelin Excel fiyat motoru kullanılır. 202 yanıtındaki job_ kimliğiyle ilerleyin. Satır hataları diğer satırları durdurmaz. Aynı işletmede tek toplu iş çalışır; ikinci istek bulk_in_progress döner. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"bulk_prices_bulk_prices_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"lines":[{"price":"120.00","sku":"KUPA-MAVI"}]},"schema":{"$ref":"#/components/schemas/BulkPrices"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","error_code":null,"failed":0,"finished_at":null,"id":"job_1234567890abcdef1234567890abcdef","kind":"prices","processed":0,"status":"queued","total":10000},"schema":{"$ref":"#/components/schemas/BulkJob"}}},"description":"Hazırlama kuyruğa alındı; dosya henüz hazır değildir.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"bulk_in_progress":{"summary":"Bu işletmede bir toplu iş sürüyor.","value":{"code":"bulk_in_progress","detail":"Bu işletmede bir toplu iş sürüyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:bulk_in_progress"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. bulk_in_progress: Bu işletmede bir toplu iş sürüyor. Önce açık işin bitmesini bekleyin; sonra yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Toplu fiyat güncelle","tags":["Toplu işler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","bulk_in_progress"],"x-include-cost":false,"x-notes":"En çok 10.000 satır; panelin Excel fiyat motoru kullanılır. 202 yanıtındaki job_ kimliğiyle ilerleyin. Satır hataları diğer satırları durdurmaz. Aynı işletmede tek toplu iş çalışır; ikinci istek bulk_in_progress döner.","x-optional-scopes":["costs:write"],"x-personal-data":false,"x-purpose":"Binlerce ürün ve seçeneğin fiyatını tek istekte güncelleyin.","x-read-cost":60,"x-required-scopes":["products:write"],"x-scope-conditions":{"costs:write":"İstekte `lines[].cost` gönderirseniz gerekir."}}},"/business":{"get":{"description":"Anahtarın bağlı olduğu işletmenin adını, türünü ve vergi durumunu okuyun; ERP şirket kaydını eşleştirirken kullanın. Geçerli Bearer anahtarı yeterlidir; ek kapsam gerekmez.","operationId":"business_business_get","responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"bus_1234567890abcdef1234567890abcdef","kind":"company","name":"Örnek Ticaret","tax_status":"standard","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Business"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":[]}],"summary":"İşletmeyi getir","tags":["Hesap"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable"],"x-include-cost":false,"x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Anahtarın bağlı olduğu işletmenin adını, türünü ve vergi durumunu okuyun; ERP şirket kaydını eşleştirirken kullanın.","x-read-cost":1,"x-required-scopes":[]}},"/categories":{"get":{"description":"Görünür ürünlerin kategorilerini alın; kendi kategori ağacınızı kurarken kullanın. Yetki dışındaki üst kategori parent=null olur. Gerekli kapsamlar: products:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"categories_categories_get","parameters":[{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"archived":false,"created_at":"2026-10-16T09:00:00Z","description":"Seramik kupa, 300 ml.","id":"cat_1234567890abcdef1234567890abcdef","image":"https://example.com/kupa.jpg","name":"Mutfak","parent":null,"revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Category_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Kategorileri listele","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor"],"x-include-cost":false,"x-notes":"Yetki dışındaki üst kategori parent=null olur.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Görünür ürünlerin kategorilerini alın; kendi kategori ağacınızı kurarken kullanın.","x-read-cost":2,"x-required-scopes":["products:read"]},"post":{"description":"İşletmenin bütün markalarında kullanılan yeni bir kategori açın. Panelin kayıt servisi kullanılır; marka sınırlı bağlantı 403 alır. Aynı ad ayrı adresle açılabilir. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"category_create_categories_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"name":"Mutfak"},"schema":{"$ref":"#/components/schemas/CreateCategory"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","description":"Seramik kupa, 300 ml.","id":"cat_1234567890abcdef1234567890abcdef","image":"https://example.com/kupa.jpg","name":"Mutfak","parent":null,"revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Category"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni kaydın API kökenine göre yolu.","schema":{"examples":["/v1/categories/cat_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"business_scope_required":{"summary":"Bu kayıt işletme genelindedir.","value":{"code":"business_scope_required","detail":"Bu kayıt işletme genelindedir.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:business_scope_required"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. business_scope_required: Bu kayıt işletme genelindedir. Bütün markalara yetkili bağlantı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"taxonomy_name_conflict":{"summary":"Aynı anda bu addan başka kayıt açıldı.","value":{"code":"taxonomy_name_conflict","detail":"Aynı anda bu addan başka kayıt açıldı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_name_conflict"}},"taxonomy_restore_conflict":{"summary":"Kayıt arşivden geri getirilemedi.","value":{"code":"taxonomy_restore_conflict","detail":"Kayıt arşivden geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. taxonomy_name_conflict: Aynı anda bu addan başka kayıt açıldı. Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin. taxonomy_restore_conflict: Kayıt arşivden geri getirilemedi. Güncel arşiv durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"category_cycle":{"summary":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","value":{"code":"category_cycle","detail":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:category_cycle"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. category_cycle: Kategori kendisinin veya alt kategorisinin altına taşınamaz. Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Kategori oluştur","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","business_scope_required","category_cycle","taxonomy_name_conflict","taxonomy_restore_conflict"],"x-include-cost":false,"x-notes":"Panelin kayıt servisi kullanılır; marka sınırlı bağlantı 403 alır. Aynı ad ayrı adresle açılabilir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"İşletmenin bütün markalarında kullanılan yeni bir kategori açın.","x-read-cost":0,"x-required-scopes":["products:write"]}},"/categories/{id}":{"get":{"description":"Bir kategorinin adını, açıklamasını ve görünür üst kategorisini okuyun. Gerekli kapsamlar: products:read.","operationId":"category_categories__id__get","parameters":[{"description":"Okunacak kaynağın cat_ önekli dış kimliği.","example":"cat_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cat_ önekli dış kimliği.","examples":["cat_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","description":"Seramik kupa, 300 ml.","id":"cat_1234567890abcdef1234567890abcdef","image":"https://example.com/kupa.jpg","name":"Mutfak","parent":null,"revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Category"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Kategoriyi getir","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bir kategorinin adını, açıklamasını ve görünür üst kategorisini okuyun.","x-read-cost":1,"x-required-scopes":["products:read"]},"patch":{"description":"Kategorinin adını, açıklamasını veya üst kategorisini değiştirin. Panelin kayıt servisiyle yalnız gönderilen alanlar değişir. If-Match kaydın revizyonunu (sürüm numarasını) denetler; marka sınırlı bağlantı 403 alır. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"category_update_categories__id__patch","parameters":[{"description":"Okunacak kaynağın cat_ önekli dış kimliği.","example":"cat_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cat_ önekli dış kimliği.","examples":["cat_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CategoryFields"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","description":"Seramik kupa, 300 ml.","id":"cat_1234567890abcdef1234567890abcdef","image":"https://example.com/kupa.jpg","name":"Mutfak","parent":null,"revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Category"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"business_scope_required":{"summary":"Bu kayıt işletme genelindedir.","value":{"code":"business_scope_required","detail":"Bu kayıt işletme genelindedir.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:business_scope_required"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. business_scope_required: Bu kayıt işletme genelindedir. Bütün markalara yetkili bağlantı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"taxonomy_name_conflict":{"summary":"Aynı anda bu addan başka kayıt açıldı.","value":{"code":"taxonomy_name_conflict","detail":"Aynı anda bu addan başka kayıt açıldı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_name_conflict"}},"taxonomy_restore_conflict":{"summary":"Kayıt arşivden geri getirilemedi.","value":{"code":"taxonomy_restore_conflict","detail":"Kayıt arşivden geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. taxonomy_name_conflict: Aynı anda bu addan başka kayıt açıldı. Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin. taxonomy_restore_conflict: Kayıt arşivden geri getirilemedi. Güncel arşiv durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"category_cycle":{"summary":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","value":{"code":"category_cycle","detail":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:category_cycle"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. category_cycle: Kategori kendisinin veya alt kategorisinin altına taşınamaz. Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Kategoriyi güncelle","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","business_scope_required","category_cycle","taxonomy_name_conflict","taxonomy_restore_conflict"],"x-include-cost":false,"x-notes":"Panelin kayıt servisiyle yalnız gönderilen alanlar değişir. If-Match kaydın revizyonunu (sürüm numarasını) denetler; marka sınırlı bağlantı 403 alır.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Kategorinin adını, açıklamasını veya üst kategorisini değiştirin.","x-read-cost":0,"x-required-scopes":["products:write"]}},"/categories/{id}/archive":{"post":{"description":"Kategoriyi vitrinden kaldırın; ürün bağları silinmez. Boş JSON gönderin. Ürün bağları korunur, kayıt vitrinden kalkar. Kategorinin alt kategorileri üstüne taşınır. İşletme kapsamı ve archive:write gerekir. Gerekli kapsamlar: archive:write, products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"category_archive_categories__id__archive_post","parameters":[{"description":"Okunacak kaynağın cat_ önekli dış kimliği.","example":"cat_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cat_ önekli dış kimliği.","examples":["cat_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/TaxonomyAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","description":"Seramik kupa, 300 ml.","id":"cat_1234567890abcdef1234567890abcdef","image":"https://example.com/kupa.jpg","name":"Mutfak","parent":null,"revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Category"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"business_scope_required":{"summary":"Bu kayıt işletme genelindedir.","value":{"code":"business_scope_required","detail":"Bu kayıt işletme genelindedir.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:business_scope_required"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. business_scope_required: Bu kayıt işletme genelindedir. Bütün markalara yetkili bağlantı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"taxonomy_name_conflict":{"summary":"Aynı anda bu addan başka kayıt açıldı.","value":{"code":"taxonomy_name_conflict","detail":"Aynı anda bu addan başka kayıt açıldı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_name_conflict"}},"taxonomy_restore_conflict":{"summary":"Kayıt arşivden geri getirilemedi.","value":{"code":"taxonomy_restore_conflict","detail":"Kayıt arşivden geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. taxonomy_name_conflict: Aynı anda bu addan başka kayıt açıldı. Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin. taxonomy_restore_conflict: Kayıt arşivden geri getirilemedi. Güncel arşiv durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"category_cycle":{"summary":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","value":{"code":"category_cycle","detail":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:category_cycle"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. category_cycle: Kategori kendisinin veya alt kategorisinin altına taşınamaz. Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","products:write"]}],"summary":"Kategoriyi arşivle","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","business_scope_required","category_cycle","taxonomy_name_conflict","taxonomy_restore_conflict"],"x-include-cost":false,"x-notes":"Boş JSON gönderin. Ürün bağları korunur, kayıt vitrinden kalkar. Kategorinin alt kategorileri üstüne taşınır. İşletme kapsamı ve archive:write gerekir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Kategoriyi vitrinden kaldırın; ürün bağları silinmez.","x-read-cost":0,"x-required-scopes":["archive:write","products:write"]}},"/categories/{id}/restore":{"post":{"description":"Arşivdeki kategoriyi geri getirin. Boş JSON gönderin. Panelin arşiv servisi kaydı geri getirir; kategori çocukları hâlâ taşındıkları yerdeyse geri bağlanır. İşletme kapsamı ve archive:write gerekir. Gerekli kapsamlar: archive:write, products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"category_restore_categories__id__restore_post","parameters":[{"description":"Okunacak kaynağın cat_ önekli dış kimliği.","example":"cat_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cat_ önekli dış kimliği.","examples":["cat_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/TaxonomyAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","description":"Seramik kupa, 300 ml.","id":"cat_1234567890abcdef1234567890abcdef","image":"https://example.com/kupa.jpg","name":"Mutfak","parent":null,"revision":1,"slug":"ornek-kupa","sort_order":0,"status":"active","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Category"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"business_scope_required":{"summary":"Bu kayıt işletme genelindedir.","value":{"code":"business_scope_required","detail":"Bu kayıt işletme genelindedir.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:business_scope_required"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. business_scope_required: Bu kayıt işletme genelindedir. Bütün markalara yetkili bağlantı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"taxonomy_name_conflict":{"summary":"Aynı anda bu addan başka kayıt açıldı.","value":{"code":"taxonomy_name_conflict","detail":"Aynı anda bu addan başka kayıt açıldı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_name_conflict"}},"taxonomy_restore_conflict":{"summary":"Kayıt arşivden geri getirilemedi.","value":{"code":"taxonomy_restore_conflict","detail":"Kayıt arşivden geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:taxonomy_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. taxonomy_name_conflict: Aynı anda bu addan başka kayıt açıldı. Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin. taxonomy_restore_conflict: Kayıt arşivden geri getirilemedi. Güncel arşiv durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"category_cycle":{"summary":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","value":{"code":"category_cycle","detail":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:category_cycle"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. category_cycle: Kategori kendisinin veya alt kategorisinin altına taşınamaz. Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","products:write"]}],"summary":"Kategoriyi geri getir","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","business_scope_required","category_cycle","taxonomy_name_conflict","taxonomy_restore_conflict"],"x-include-cost":false,"x-notes":"Boş JSON gönderin. Panelin arşiv servisi kaydı geri getirir; kategori çocukları hâlâ taşındıkları yerdeyse geri bağlanır. İşletme kapsamı ve archive:write gerekir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Arşivdeki kategoriyi geri getirin.","x-read-cost":0,"x-required-scopes":["archive:write","products:write"]}},"/coupons":{"get":{"description":"Markanın veya işletmenin kuponlarını ve kullanım sayılarını alın. id artan sırayla ve imleçle gelir; store ile marka seçilebilir. Kullanım sayıları siparişlerden hesaplanır. Kişisel veriler yayımlanmaz. Gerekli kapsamlar: coupons:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"coupons_coupons_get","parameters":[{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","example":"sto_1234567890abcdef1234567890abcdef","in":"query","name":"store","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"archived":false,"categories":[],"category_restricted":false,"code":"MERHABA10","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer_restricted":false,"discount_type":"percentage","discount_value":"10.00","exclude_discounted":false,"first_order_only":false,"free_shipping":false,"id":"cpn_1234567890abcdef1234567890abcdef","max_uses":100,"max_uses_per_customer":1,"min_order":"100.00","revision":1,"status":"active","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","used_count":0,"valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Coupon_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["coupons:read"]}],"summary":"Kuponları listele","tags":["Kuponlar"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"id artan sırayla ve imleçle gelir; store ile marka seçilebilir. Kullanım sayıları siparişlerden hesaplanır. Kişisel veriler yayımlanmaz.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Markanın veya işletmenin kuponlarını ve kullanım sayılarını alın.","x-read-cost":2,"x-required-scopes":["coupons:read"]},"post":{"description":"Markada kullanılacak yeni bir indirim kuponu açın. Panel ve AI komutuyla aynı yoldan oluşturulur. Tek markada store atlanabilir; çok markada zorunludur. Kod markada tekildir; çakışma coupon_code_taken döndürür. Kapsam categories ile seçilir; müşteri seçimi ve tek tek ürün seçimi desteklenmez. Gerekli kapsamlar: coupons:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_coupons_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"code":"MERHABA10","discount_type":"percentage","discount_value":"10.00","max_uses_per_customer":1},"schema":{"$ref":"#/components/schemas/CreateCoupon"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"archived":false,"categories":[],"category_restricted":false,"code":"MERHABA10","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer_restricted":false,"discount_type":"percentage","discount_value":"10.00","exclude_discounted":false,"first_order_only":false,"free_shipping":false,"id":"cpn_1234567890abcdef1234567890abcdef","max_uses":100,"max_uses_per_customer":1,"min_order":"100.00","revision":1,"status":"active","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","used_count":0,"valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"schema":{"$ref":"#/components/schemas/Coupon"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni kaydın API kökenine göre yolu.","schema":{"examples":["/v1/coupons/cpn_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"coupon_code_taken":{"summary":"Kupon kodu bu markada başka kuponda kullanılıyor.","value":{"code":"coupon_code_taken","detail":"Kupon kodu bu markada başka kuponda kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:coupon_code_taken"}},"coupon_restore_conflict":{"summary":"Kupon arşivde değil.","value":{"code":"coupon_restore_conflict","detail":"Kupon arşivde değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:coupon_restore_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. coupon_code_taken: Kupon kodu bu markada başka kuponda kullanılıyor. Başka kod seçin veya mevcut kuponu güncelleyin; yeni tekrar anahtarı kullanın. coupon_restore_conflict: Kupon arşivde değil. Güncel kaydı okuyun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["coupons:write"]}],"summary":"Kupon oluştur","tags":["Kuponlar"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","coupon_code_taken","coupon_restore_conflict","store_required","store_forbidden"],"x-include-cost":false,"x-notes":"Panel ve AI komutuyla aynı yoldan oluşturulur. Tek markada store atlanabilir; çok markada zorunludur. Kod markada tekildir; çakışma coupon_code_taken döndürür. Kapsam categories ile seçilir; müşteri seçimi ve tek tek ürün seçimi desteklenmez.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Markada kullanılacak yeni bir indirim kuponu açın.","x-read-cost":0,"x-required-scopes":["coupons:write"]}},"/coupons/{id}":{"get":{"description":"Bir kuponun kurallarını ve kullanım sayısını okuyun. revision (kaydın sürüm numarası) ve ETag değerini de verir. Arşivdeki kaydı okumak için archived=true gönderin. Gerekli kapsamlar: coupons:read.","operationId":"coupon_coupons__id__get","parameters":[{"description":"Okunacak kaynağın cpn_ önekli dış kimliği.","example":"cpn_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cpn_ önekli dış kimliği.","examples":["cpn_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"categories":[],"category_restricted":false,"code":"MERHABA10","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer_restricted":false,"discount_type":"percentage","discount_value":"10.00","exclude_discounted":false,"first_order_only":false,"free_shipping":false,"id":"cpn_1234567890abcdef1234567890abcdef","max_uses":100,"max_uses_per_customer":1,"min_order":"100.00","revision":1,"status":"active","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","used_count":0,"valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"schema":{"$ref":"#/components/schemas/Coupon"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["coupons:read"]}],"summary":"Kuponu getir","tags":["Kuponlar"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-notes":"revision (kaydın sürüm numarası) ve ETag değerini de verir. Arşivdeki kaydı okumak için archived=true gönderin.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bir kuponun kurallarını ve kullanım sayısını okuyun.","x-read-cost":1,"x-required-scopes":["coupons:read"]},"patch":{"description":"Kuponun indirimini, tarihlerini veya kurallarını değiştirin. Panel ve AI komutuyla yalnız gönderilen alanlar değişir; If-Match kilit altında denetlenir. Kayıt kendi markasında kalır. Tarihler panel gibi markanın yerel günü/saatidir; saat dilimli ISO zaman markanın saatine çevrilir. Gerekli kapsamlar: coupons:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"patch_coupons__id__patch","parameters":[{"description":"Okunacak kaynağın cpn_ önekli dış kimliği.","example":"cpn_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cpn_ önekli dış kimliği.","examples":["cpn_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"discount_value":"15.00"},"schema":{"$ref":"#/components/schemas/PatchCoupon"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"categories":[],"category_restricted":false,"code":"MERHABA10","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer_restricted":false,"discount_type":"percentage","discount_value":"10.00","exclude_discounted":false,"first_order_only":false,"free_shipping":false,"id":"cpn_1234567890abcdef1234567890abcdef","max_uses":100,"max_uses_per_customer":1,"min_order":"100.00","revision":1,"status":"active","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","used_count":0,"valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"schema":{"$ref":"#/components/schemas/Coupon"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"coupon_code_taken":{"summary":"Kupon kodu bu markada başka kuponda kullanılıyor.","value":{"code":"coupon_code_taken","detail":"Kupon kodu bu markada başka kuponda kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:coupon_code_taken"}},"coupon_restore_conflict":{"summary":"Kupon arşivde değil.","value":{"code":"coupon_restore_conflict","detail":"Kupon arşivde değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:coupon_restore_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. coupon_code_taken: Kupon kodu bu markada başka kuponda kullanılıyor. Başka kod seçin veya mevcut kuponu güncelleyin; yeni tekrar anahtarı kullanın. coupon_restore_conflict: Kupon arşivde değil. Güncel kaydı okuyun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["coupons:write"]}],"summary":"Kuponu güncelle","tags":["Kuponlar"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","coupon_code_taken","coupon_restore_conflict","store_required","store_forbidden"],"x-include-cost":false,"x-notes":"Panel ve AI komutuyla yalnız gönderilen alanlar değişir; If-Match kilit altında denetlenir. Kayıt kendi markasında kalır. Tarihler panel gibi markanın yerel günü/saatidir; saat dilimli ISO zaman markanın saatine çevrilir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Kuponun indirimini, tarihlerini veya kurallarını değiştirin.","x-read-cost":0,"x-required-scopes":["coupons:write"]}},"/coupons/{id}/archive":{"post":{"description":"Kuponu kullanımdan kaldırın; geçmişi silinmez. Boş JSON gönderin. archive:write gerekir; kupon sepette uygulanmaz, siparişlerdeki geçmiş ve kullanım kaydı korunur. Gerekli kapsamlar: archive:write, coupons:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"coupon_archive_coupons__id__archive_post","parameters":[{"description":"Okunacak kaynağın cpn_ önekli dış kimliği.","example":"cpn_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cpn_ önekli dış kimliği.","examples":["cpn_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CouponAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"categories":[],"category_restricted":false,"code":"MERHABA10","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer_restricted":false,"discount_type":"percentage","discount_value":"10.00","exclude_discounted":false,"first_order_only":false,"free_shipping":false,"id":"cpn_1234567890abcdef1234567890abcdef","max_uses":100,"max_uses_per_customer":1,"min_order":"100.00","revision":1,"status":"active","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","used_count":0,"valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"schema":{"$ref":"#/components/schemas/Coupon"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"coupon_code_taken":{"summary":"Kupon kodu bu markada başka kuponda kullanılıyor.","value":{"code":"coupon_code_taken","detail":"Kupon kodu bu markada başka kuponda kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:coupon_code_taken"}},"coupon_restore_conflict":{"summary":"Kupon arşivde değil.","value":{"code":"coupon_restore_conflict","detail":"Kupon arşivde değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:coupon_restore_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. coupon_code_taken: Kupon kodu bu markada başka kuponda kullanılıyor. Başka kod seçin veya mevcut kuponu güncelleyin; yeni tekrar anahtarı kullanın. coupon_restore_conflict: Kupon arşivde değil. Güncel kaydı okuyun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","coupons:write"]}],"summary":"Kuponu arşivle","tags":["Kuponlar"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","coupon_code_taken","coupon_restore_conflict","store_required","store_forbidden"],"x-include-cost":false,"x-notes":"Boş JSON gönderin. archive:write gerekir; kupon sepette uygulanmaz, siparişlerdeki geçmiş ve kullanım kaydı korunur.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Kuponu kullanımdan kaldırın; geçmişi silinmez.","x-read-cost":0,"x-required-scopes":["archive:write","coupons:write"]}},"/coupons/{id}/restore":{"post":{"description":"Arşivdeki kuponu yeniden kullanıma açın. Boş JSON gönderin. archive:write gerekir; kod markada başka canlı kuponda kullanılıyorsa coupon_code_taken döner. Gerekli kapsamlar: archive:write, coupons:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"coupon_restore_coupons__id__restore_post","parameters":[{"description":"Okunacak kaynağın cpn_ önekli dış kimliği.","example":"cpn_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cpn_ önekli dış kimliği.","examples":["cpn_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CouponAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"categories":[],"category_restricted":false,"code":"MERHABA10","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer_restricted":false,"discount_type":"percentage","discount_value":"10.00","exclude_discounted":false,"first_order_only":false,"free_shipping":false,"id":"cpn_1234567890abcdef1234567890abcdef","max_uses":100,"max_uses_per_customer":1,"min_order":"100.00","revision":1,"status":"active","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","used_count":0,"valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"schema":{"$ref":"#/components/schemas/Coupon"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"coupon_code_taken":{"summary":"Kupon kodu bu markada başka kuponda kullanılıyor.","value":{"code":"coupon_code_taken","detail":"Kupon kodu bu markada başka kuponda kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:coupon_code_taken"}},"coupon_restore_conflict":{"summary":"Kupon arşivde değil.","value":{"code":"coupon_restore_conflict","detail":"Kupon arşivde değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:coupon_restore_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. coupon_code_taken: Kupon kodu bu markada başka kuponda kullanılıyor. Başka kod seçin veya mevcut kuponu güncelleyin; yeni tekrar anahtarı kullanın. coupon_restore_conflict: Kupon arşivde değil. Güncel kaydı okuyun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","coupons:write"]}],"summary":"Kuponu geri getir","tags":["Kuponlar"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_if_match","revision_mismatch","coupon_code_taken","coupon_restore_conflict","store_required","store_forbidden"],"x-include-cost":false,"x-notes":"Boş JSON gönderin. archive:write gerekir; kod markada başka canlı kuponda kullanılıyorsa coupon_code_taken döner.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Arşivdeki kuponu yeniden kullanıma açın.","x-read-cost":0,"x-required-scopes":["archive:write","coupons:write"]}},"/customers":{"get":{"description":"Müşteri kartlarını listeleyin veya e-posta/telefonla doğru kartı bulun. Etkin kartlar varsayılan updated_at,id artan sırayla gelir; sort=-created_at en yeni kartı önce getirir. email ve phone ham değerleri normalleştirilerek tam eşitlikle aranır; email_key ve phone_key eski istemciler için korunur. Birden çok süzgeç birlikte verilirse hepsi eşleşmelidir. Kişisel veri kapsamı yoksa kimlik ve zaman gibi genel alanlar kalır; e-posta/telefonla arama ayrıca personal_data:read ister. Gerekli kapsamlar: customers:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"customers_customers_get","parameters":[{"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}},{"description":"updated_at: son değişiklikten ileri; -created_at: en yeni müşteri önce. Sıra değişirse yeni sayfalama başlatın.","example":"-created_at","in":"query","name":"sort","required":false,"schema":{"default":"updated_at","description":"updated_at: son değişiklikten ileri; -created_at: en yeni müşteri önce. Sıra değişirse yeni sayfalama başlatın.","enum":["updated_at","-created_at"],"examples":["-created_at"],"title":"Sort","type":"string"}},{"description":"Ham e-posta; sunucu email_key kolonunun normalleştirmesiyle tam eşitlik arar. personal_data:read gerekir.","example":"Ornek@Example.com","in":"query","name":"email","required":false,"schema":{"anyOf":[{"maxLength":320,"minLength":1,"type":"string"},{"type":"null"}],"description":"Ham e-posta; sunucu email_key kolonunun normalleştirmesiyle tam eşitlik arar. personal_data:read gerekir.","examples":["Ornek@Example.com"],"title":"Email"}},{"description":"Ham telefon; mevcut müşteri kuralıyla son 10 haneye çevrilir. personal_data:read gerekir.","example":"+90 500 000 00 00","in":"query","name":"phone","required":false,"schema":{"anyOf":[{"maxLength":50,"minLength":1,"type":"string"},{"type":"null"}],"description":"Ham telefon; mevcut müşteri kuralıyla son 10 haneye çevrilir. personal_data:read gerekir.","examples":["+90 500 000 00 00"],"title":"Phone"}},{"description":"Normalize edilmiş e-posta; tam eşitlik araması; personal_data:read gerekir.","example":"ornek@example.com","in":"query","name":"email_key","required":false,"schema":{"anyOf":[{"maxLength":320,"minLength":1,"type":"string"},{"type":"null"}],"description":"Normalize edilmiş e-posta; tam eşitlik araması; personal_data:read gerekir.","examples":["ornek@example.com"],"title":"Email Key"}},{"description":"Telefonun son 10 hanesi; tam eşitlik araması; personal_data:read gerekir.","example":"0000000000","in":"query","name":"phone_key","required":false,"schema":{"anyOf":[{"pattern":"^\\d{10}$","type":"string"},{"type":"null"}],"description":"Telefonun son 10 hanesi; tam eşitlik araması; personal_data:read gerekir.","examples":["0000000000"],"title":"Phone Key"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":1,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Customer_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["customers:read"]}],"summary":"Müşterileri listele","tags":["Müşteriler"],"x-data-class":"customers","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor"],"x-include-cost":false,"x-notes":"Etkin kartlar varsayılan updated_at,id artan sırayla gelir; sort=-created_at en yeni kartı önce getirir. email ve phone ham değerleri normalleştirilerek tam eşitlikle aranır; email_key ve phone_key eski istemciler için korunur. Birden çok süzgeç birlikte verilirse hepsi eşleşmelidir. Kişisel veri kapsamı yoksa kimlik ve zaman gibi genel alanlar kalır; e-posta/telefonla arama ayrıca personal_data:read ister.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Müşteri kartlarını listeleyin veya e-posta/telefonla doğru kartı bulun.","x-read-cost":2,"x-required-scopes":["customers:read"],"x-scope-conditions":{"personal_data:read":"email, phone, email_key veya phone_key ile ararken gerekir; ayrıca yanıttaki kişisel alanları açar."}},"post":{"description":"Yeni müşteri kartı açın; sipariş açmadan önce müşteriyi kaydetmek için kullanın. Panelin müşteri servisi kullanılır. Tek markada store atlanabilir; çok markada seçilmelidir. Kişisel alanlar personal_data:write, gönderilen iç not internal_notes:write ister. Yanıttaki kişisel alanlar ayrıca personal_data:read gerektirir. Mevcut müşteri eşleştirmesi aynı e-postayı, yoksa uygun telefonu arar; aynı telefon fakat farklı iki e-posta ayrı kişidir. Eşleşmede 409 customer_exists ve existing_customer kimliği döner; örtük güncelleme yapılmaz. 201 yanıtı müşteri nesnesi, ETag ve Location içerir. Gerekli kapsamlar: customers:write, personal_data:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_customers_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"email":"musteri@example.com","name":"Örnek Müşteri","phone":"05000000000"},"schema":{"$ref":"#/components/schemas/CreateCustomer"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":1,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni kaydın API kökenine göre yolu.","schema":{"examples":["/v1/customers/cus_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"customer_exists":{"summary":"Bu iletişim bilgileriyle müşteri zaten var.","value":{"code":"customer_exists","detail":"Bu iletişim bilgileriyle müşteri zaten var.","errors":[],"existing_customer":"cus_1234567890abcdef1234567890abcdef","request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:customer_exists"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. customer_exists: Bu iletişim bilgileriyle müşteri zaten var. existing_customer kimliğini kullanın; değiştirmek için PATCH gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["customers:write","personal_data:write"]}],"summary":"Müşteri oluştur","tags":["Müşteriler"],"x-data-class":"customers","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","store_required","store_forbidden","customer_exists"],"x-include-cost":false,"x-notes":"Panelin müşteri servisi kullanılır. Tek markada store atlanabilir; çok markada seçilmelidir. Kişisel alanlar personal_data:write, gönderilen iç not internal_notes:write ister. Yanıttaki kişisel alanlar ayrıca personal_data:read gerektirir. Mevcut müşteri eşleştirmesi aynı e-postayı, yoksa uygun telefonu arar; aynı telefon fakat farklı iki e-posta ayrı kişidir. Eşleşmede 409 customer_exists ve existing_customer kimliği döner; örtük güncelleme yapılmaz. 201 yanıtı müşteri nesnesi, ETag ve Location içerir.","x-optional-scopes":["personal_data:read","internal_notes:read","internal_notes:write"],"x-personal-data":true,"x-purpose":"Yeni müşteri kartı açın; sipariş açmadan önce müşteriyi kaydetmek için kullanın.","x-read-cost":1,"x-required-scopes":["customers:write","personal_data:write"],"x-scope-conditions":{"internal_notes:write":"İstekte `note` gönderirseniz gerekir."}}},"/customers/{id}":{"get":{"description":"Bir müşteri kartını okuyun; siparişteki customer kimliğini kendi kaydınızla eşleştirirken kullanın. İzinli alanlar, revision (kartın sürüm numarası) ve ETag döner; arşivdeki kart kimliğiyle okunabilir. Yetkisiz kişisel alanlar yanıttan atlanır. Gerekli kapsamlar: customers:read.","operationId":"customer_customers__id__get","parameters":[{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","example":"cus_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":1,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["customers:read"]}],"summary":"Müşteriyi getir","tags":["Müşteriler"],"x-data-class":"customers","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-notes":"İzinli alanlar, revision (kartın sürüm numarası) ve ETag döner; arşivdeki kart kimliğiyle okunabilir. Yetkisiz kişisel alanlar yanıttan atlanır.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Bir müşteri kartını okuyun; siparişteki customer kimliğini kendi kaydınızla eşleştirirken kullanın.","x-read-cost":1,"x-required-scopes":["customers:read"]},"patch":{"description":"Müşteri kartının adını, iletişim bilgilerini veya notunu değiştirin. Yalnız gönderilen alanlar panelin müşteri servisiyle değişir. Kişisel alanlar personal_data:write, iç not internal_notes:write ister. Ad dışında null alanı temizler; pazarlama izninde null bilinmiyor demektir. If-Match verilirse kilit altında denetlenir; farklı sürüm 412 döner. Gerekli kapsamlar: customers:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"patch_customers__id__patch","parameters":[{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","example":"cus_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"name":"Örnek Müşteri Yeni"},"schema":{"$ref":"#/components/schemas/PatchCustomer"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":1,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["customers:write"]}],"summary":"Müşteriyi güncelle","tags":["Müşteriler"],"x-data-class":"customers","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","invalid_if_match","revision_mismatch"],"x-include-cost":false,"x-notes":"Yalnız gönderilen alanlar panelin müşteri servisiyle değişir. Kişisel alanlar personal_data:write, iç not internal_notes:write ister. Ad dışında null alanı temizler; pazarlama izninde null bilinmiyor demektir. If-Match verilirse kilit altında denetlenir; farklı sürüm 412 döner.","x-optional-scopes":["personal_data:read","internal_notes:read","internal_notes:write","personal_data:write"],"x-personal-data":true,"x-purpose":"Müşteri kartının adını, iletişim bilgilerini veya notunu değiştirin.","x-read-cost":1,"x-required-scopes":["customers:write"],"x-scope-conditions":{"internal_notes:write":"İstekte `note` gönderirseniz gerekir.","personal_data:write":"İstekte `email`, `phone`, `address`, `invoice`, `marketing_consent`, `name` gönderirseniz gerekir."}}},"/customers/{id}/anonymize":{"post":{"description":"Müşterinin KVKK silme isteğini yerine getirin: kişisel bilgiler temizlenir, sipariş ve muhasebe kayıtları kalır. Geri alınamaz. Gövdede confirm=\"anonymize\" zorunludur; reason isteğe bağlıdır ve denetimde maskelenir. Panel ve AI ile aynı servis kartın ve siparişlerin kişisel alanlarını temizler; sipariş, kesilmiş fatura ve muhasebe kayıtları kalır. Açık sipariş varsa 409 customer_anonymization_blocked döner. Arşivdeki kart da anonimleşir; zaten anonim kartta 200 ve değişiklik yoktur. Marka sınırı korunur. Yanıt güncel müşteri modelidir; kişisel alanların görünmesi ayrıca personal_data:read ister. customer.anonymized olayı kişisel veri taşımaz. Önceden hazırlanmış dışa aktarma dosyalarının erişimi oluşturulduklarından 7 gün sonra kapanır. Gerekli kapsamlar: customers:erase, customers:write, personal_data:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"anonymize_customers__id__anonymize_post","parameters":[{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","example":"cus_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"confirm":"anonymize"},"schema":{"$ref":"#/components/schemas/AnonymizeCustomer"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":true,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":3,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"customer_anonymization_blocked":{"summary":"Müşteri mevcut durumda anonimleştirilemiyor. Açık siparişlerini tamamlayın veya iptal edin.","value":{"code":"customer_anonymization_blocked","detail":"Müşteri mevcut durumda anonimleştirilemiyor. Açık siparişlerini tamamlayın veya iptal edin.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:customer_anonymization_blocked"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. customer_anonymization_blocked: Müşteri mevcut durumda anonimleştirilemiyor. Açık siparişlerini tamamlayın veya iptal edin. Paneldeki anonimleştirme önkoşulunu giderip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["customers:erase","customers:write","personal_data:write"]}],"summary":"Müşteriyi anonimleştir (KVKK)","tags":["Müşteriler"],"x-data-class":"customers","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","customer_anonymization_blocked"],"x-include-cost":false,"x-notes":"Geri alınamaz. Gövdede confirm=\"anonymize\" zorunludur; reason isteğe bağlıdır ve denetimde maskelenir. Panel ve AI ile aynı servis kartın ve siparişlerin kişisel alanlarını temizler; sipariş, kesilmiş fatura ve muhasebe kayıtları kalır. Açık sipariş varsa 409 customer_anonymization_blocked döner. Arşivdeki kart da anonimleşir; zaten anonim kartta 200 ve değişiklik yoktur. Marka sınırı korunur. Yanıt güncel müşteri modelidir; kişisel alanların görünmesi ayrıca personal_data:read ister. customer.anonymized olayı kişisel veri taşımaz. Önceden hazırlanmış dışa aktarma dosyalarının erişimi oluşturulduklarından 7 gün sonra kapanır.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Müşterinin KVKK silme isteğini yerine getirin: kişisel bilgiler temizlenir, sipariş ve muhasebe kayıtları kalır.","x-read-cost":1,"x-required-scopes":["customers:erase","customers:write","personal_data:write"]}},"/customers/{id}/archive":{"post":{"description":"Müşteri kartını etkin listeden kaldırın; kart ve siparişleri silinmez. Kart, siparişleri ve üyelik bağı korunur; fiziksel silme ve KVKK anonimleştirmesi yapılmaz. Boş JSON nesnesi gönderin; archive:write gerekir. If-Match desteklenir. Gerekli kapsamlar: archive:write, customers:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"customer_archive_customers__id__archive_post","parameters":[{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","example":"cus_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CustomerAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":1,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","customers:write"]}],"summary":"Müşteriyi arşivle","tags":["Müşteriler"],"x-data-class":"customers","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","invalid_if_match","revision_mismatch"],"x-include-cost":false,"x-notes":"Kart, siparişleri ve üyelik bağı korunur; fiziksel silme ve KVKK anonimleştirmesi yapılmaz. Boş JSON nesnesi gönderin; archive:write gerekir. If-Match desteklenir.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Müşteri kartını etkin listeden kaldırın; kart ve siparişleri silinmez.","x-read-cost":1,"x-required-scopes":["archive:write","customers:write"]}},"/customers/{id}/restore":{"post":{"description":"Arşivdeki müşteri kartını etkin listeye geri getirin. Panelin arşiv servisi kullanılır. Boş JSON nesnesi gönderin; archive:write gerekir. If-Match desteklenir. KVKK ile anonimleşmiş kart geri getirilemez. Gerekli kapsamlar: archive:write, customers:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"customer_restore_customers__id__restore_post","parameters":[{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","example":"cus_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın cus_ önekli dış kimliği.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CustomerAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"created_at":"2026-10-16T09:00:00Z","id":"cus_1234567890abcdef1234567890abcdef","revision":1,"store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Customer"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"3\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"customer_restore_conflict":{"summary":"Müşteri geri getirilemedi.","value":{"code":"customer_restore_conflict","detail":"Müşteri geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:customer_restore_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. customer_restore_conflict: Müşteri geri getirilemedi. Kartın arşiv durumunu ve üyelik bağını panelden kontrol edin; anonimleşmiş kart geri getirilemez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","customers:write"]}],"summary":"Müşteriyi geri getir","tags":["Müşteriler"],"x-data-class":"customers","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","invalid_if_match","revision_mismatch","customer_restore_conflict"],"x-include-cost":false,"x-notes":"Panelin arşiv servisi kullanılır. Boş JSON nesnesi gönderin; archive:write gerekir. If-Match desteklenir. KVKK ile anonimleşmiş kart geri getirilemez.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Arşivdeki müşteri kartını etkin listeye geri getirin.","x-read-cost":1,"x-required-scopes":["archive:write","customers:write"]}},"/events":{"get":{"description":"Sipariş, stok, ürün ve müşterideki kalıcı değişiklikleri yayın sırasıyla okuyun; webhook yerine düzenli sorgulamak için kullanın. events:read yanında olay kaynağının okuma kapsamı da gerekir. Olayları evt_ kimliğiyle tekilleştirin; uygulama ve imleç kaydını aynı işlemde yapın. Boş data ve has_more=true olabilir; ilerleyin. has_more=false olunca bekleyip dönen next_cursor ile tekrar sorun. Dışa aktarmanın resume_cursor değerine types eklemeyin. Gerekli kapsamlar: events:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Son/boş olay sayfasının imleci korunur.","operationId":"events_events_get","parameters":[{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}},{"description":"Virgülle ayrılmış olay türleri; her türün kaynak okuma kapsamı gerekir.","example":"order.created,order.status_changed","in":"query","name":"types","required":false,"schema":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"description":"Virgülle ayrılmış olay türleri; her türün kaynak okuma kapsamı gerekir.","examples":["order.created,order.status_changed"],"title":"Types"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{},"previous":{}},"object":{"id":"ord_1234567890abcdef1234567890abcdef"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"order.created"}],"has_more":false,"next_cursor":"SUNUCUDAN_DONEN_IMLEC"},"schema":{"$ref":"#/components/schemas/EventPage"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"snapshot_publisher_changed":{"summary":"Olay yayıncısının sürümü ilk görüntüyle uyuşmuyor.","value":{"code":"snapshot_publisher_changed","detail":"Olay yayıncısının sürümü ilk görüntüyle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:snapshot_publisher_changed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"snapshot_publisher_changed: Olay yayıncısının sürümü ilk görüntüyle uyuşmuyor. Yeni tutarlı dışa aktarma ve onun resume_cursor değeriyle başlayın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_event_types":{"summary":"Olay türü geçersiz veya izinli tür yok.","value":{"code":"invalid_event_types","detail":"Olay türü geçersiz veya izinli tür yok.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_event_types"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_event_types: Olay türü geçersiz veya izinli tür yok. Olay kataloğundan tür seçin ve kaynak kapsamını açın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["events:read"]}],"summary":"Olayları listele","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_event_types","snapshot_publisher_changed"],"x-event-scopes":{"channel.order_imported":"channels:read","channel.problem":"channels:read","channel.recovered":"channels:read","collection.recorded":"payments:read","collection.reversed":"payments:read","coupon.archived":"coupons:read","coupon.created":"coupons:read","coupon.restored":"coupons:read","coupon.updated":"coupons:read","customer.anonymized":"customers:read","customer.archived":"customers:read","customer.created":"customers:read","customer.restored":"customers:read","customer.updated":"customers:read","inventory.document_created":"inventory:read","inventory.document_reversed":"inventory:read","inventory.level_changed":"inventory:read","inventory.low":"inventory:read","invoice.cancelled":"invoices:read","invoice.failed":"invoices:read","invoice.issued":"invoices:read","job.completed":["exports:write","products:write","inventory:write"],"order.created":"orders:read","order.status_changed":"orders:read","order.updated":"orders:read","payment.failed":"payments:read","product.archived":"products:read","product.created":"products:read","product.restored":"products:read","product.updated":"products:read","refund.succeeded":"payments:read","return.approved":"returns:read","return.closed":"returns:read","return.received":"returns:read","return.rejected":"returns:read","return.requested":"returns:read","shipment.cod_changed":"shipments:read","shipment.created":"shipments:read","shipment.status_changed":"shipments:read","store_price.updated":"products:read","store_product.linked":"products:read","store_product.unlinked":"products:read","subscription.cancelled":"subscriptions:read","subscription.created":"subscriptions:read","subscription.paused":"subscriptions:read","subscription.payment_issue":"subscriptions:read","subscription.renewed":"subscriptions:read","subscription.resumed":"subscriptions:read","variant.archived":"products:read","variant.created":"products:read","variant.restored":"products:read","variant.updated":"products:read"},"x-include-cost":false,"x-notes":"events:read yanında olay kaynağının okuma kapsamı da gerekir. Olayları evt_ kimliğiyle tekilleştirin; uygulama ve imleç kaydını aynı işlemde yapın. Boş data ve has_more=true olabilir; ilerleyin. has_more=false olunca bekleyip dönen next_cursor ile tekrar sorun. Dışa aktarmanın resume_cursor değerine types eklemeyin.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Sipariş, stok, ürün ve müşterideki kalıcı değişiklikleri yayın sırasıyla okuyun; webhook yerine düzenli sorgulamak için kullanın.","x-read-cost":2,"x-required-scopes":["events:read"]}},"/events/{id}":{"get":{"description":"Tek bir olayın değişiklik özetini okuyun; tekil teslimi incelemek için kullanın. Olay kişisel veri içermez; güncel nesne ilgili kaynak ucundan okunur. events:read yanında kaynağın kapsamı gerekir. Gerekli kapsamlar: events:read.","operationId":"event_events__id__get","parameters":[{"description":"Okunacak kaynağın evt_ önekli dış kimliği.","example":"evt_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın evt_ önekli dış kimliği.","examples":["evt_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{},"previous":{}},"object":{"id":"ord_1234567890abcdef1234567890abcdef"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"order.created"},"schema":{"$ref":"#/components/schemas/Event"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["events:read"]}],"summary":"Olayı getir","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-event-scopes":{"channel.order_imported":"channels:read","channel.problem":"channels:read","channel.recovered":"channels:read","collection.recorded":"payments:read","collection.reversed":"payments:read","coupon.archived":"coupons:read","coupon.created":"coupons:read","coupon.restored":"coupons:read","coupon.updated":"coupons:read","customer.anonymized":"customers:read","customer.archived":"customers:read","customer.created":"customers:read","customer.restored":"customers:read","customer.updated":"customers:read","inventory.document_created":"inventory:read","inventory.document_reversed":"inventory:read","inventory.level_changed":"inventory:read","inventory.low":"inventory:read","invoice.cancelled":"invoices:read","invoice.failed":"invoices:read","invoice.issued":"invoices:read","job.completed":["exports:write","products:write","inventory:write"],"order.created":"orders:read","order.status_changed":"orders:read","order.updated":"orders:read","payment.failed":"payments:read","product.archived":"products:read","product.created":"products:read","product.restored":"products:read","product.updated":"products:read","refund.succeeded":"payments:read","return.approved":"returns:read","return.closed":"returns:read","return.received":"returns:read","return.rejected":"returns:read","return.requested":"returns:read","shipment.cod_changed":"shipments:read","shipment.created":"shipments:read","shipment.status_changed":"shipments:read","store_price.updated":"products:read","store_product.linked":"products:read","store_product.unlinked":"products:read","subscription.cancelled":"subscriptions:read","subscription.created":"subscriptions:read","subscription.paused":"subscriptions:read","subscription.payment_issue":"subscriptions:read","subscription.renewed":"subscriptions:read","subscription.resumed":"subscriptions:read","variant.archived":"products:read","variant.created":"products:read","variant.restored":"products:read","variant.updated":"products:read"},"x-include-cost":false,"x-notes":"Olay kişisel veri içermez; güncel nesne ilgili kaynak ucundan okunur. events:read yanında kaynağın kapsamı gerekir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Tek bir olayın değişiklik özetini okuyun; tekil teslimi incelemek için kullanın.","x-read-cost":1,"x-required-scopes":["events:read"]}},"/exports":{"post":{"description":"İlk eşitleme için siparişlerin, müşterilerin, ürünlerin veya stoğun tek andaki tutarlı dosyasını hazırlatın. JSONL/CSV görünümü hazırlanır; exports:write yanında kaynağın okuma kapsamı gerekir. Idempotency-Key zorunludur: aynı işin tekrarında aynı gövde/anahtarı kullanın. Aynı işletmede tek hazırlama çalışır; include desteklenmez. Hazır dosyayı tamamen uyguladıktan sonra resume_cursor (dosyanın bittiği andaki olay konumu) ile olaylara geçin. Gerekli kapsamlar: exports:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_exports_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"format":"jsonl","mode":"consistent_snapshot","resource":"orders"},"schema":{"discriminator":{"mapping":{"customers":"#/components/schemas/CustomersExportInput","inventory_levels":"#/components/schemas/InventoryLevelsExportInput","orders":"#/components/schemas/OrdersExportInput","products":"#/components/schemas/ProductsExportInput","variants":"#/components/schemas/VariantsExportInput"},"propertyName":"resource"},"oneOf":[{"$ref":"#/components/schemas/OrdersExportInput"},{"$ref":"#/components/schemas/CustomersExportInput"},{"$ref":"#/components/schemas/ProductsExportInput"},{"$ref":"#/components/schemas/VariantsExportInput"},{"$ref":"#/components/schemas/InventoryLevelsExportInput"}],"title":"Body"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"completed_at":null,"created_at":"2026-10-16T09:00:00Z","error_code":null,"file":null,"format":"jsonl","id":"exp_1234567890abcdef1234567890abcdef","resource":"orders","resume_cursor":null,"row_count":0,"status":"queued"},"schema":{"$ref":"#/components/schemas/Export"}}},"description":"Hazırlama kuyruğa alındı; dosya henüz hazır değildir.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"export_access_changed":{"summary":"Dosya oluşturulduktan sonra erişim kapsamı değişmiş.","value":{"code":"export_access_changed","detail":"Dosya oluşturulduktan sonra erişim kapsamı değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:export_access_changed"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. export_access_changed: Dosya oluşturulduktan sonra erişim kapsamı değişmiş. Güncel izinlerle yeni dışa aktarma başlatın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"export_in_progress":{"summary":"Bu işletmede başka bir dosya hazırlanıyor.","value":{"code":"export_in_progress","detail":"Bu işletmede başka bir dosya hazırlanıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:export_in_progress"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. export_in_progress: Bu işletmede başka bir dosya hazırlanıyor. Retry-After kadar bekleyin; mevcut hazırlama bitince yeni Idempotency-Key ile isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_date_range":{"summary":"Zaman aralığının başlangıcı bitişten sonra.","value":{"code":"invalid_date_range","detail":"Zaman aralığının başlangıcı bitişten sonra.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_date_range"}},"invalid_datetime":{"summary":"Zamanın saat dilimi eksik.","value":{"code":"invalid_datetime","detail":"Zamanın saat dilimi eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_datetime"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_range":{"summary":"Zaman aralığının başlangıcı bitişten önce değil.","value":{"code":"invalid_range","detail":"Zaman aralığının başlangıcı bitişten önce değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_range"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_range: Zaman aralığının başlangıcı bitişten önce değil. Başlangıç dahil, bitiş hariç olacak şekilde başlangıcı bitişten önce seçin. invalid_date_range: Zaman aralığının başlangıcı bitişten sonra. Başlangıç ve bitiş sırasını düzeltin. invalid_datetime: Zamanın saat dilimi eksik. RFC 3339 değere Z veya +03:00 gibi saat dilimi ekleyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["exports:write"]}],"summary":"Dışa aktarma başlat","tags":["Dışa aktarma"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","export_access_changed","invalid_id","export_in_progress","invalid_range","invalid_date_range","invalid_datetime"],"x-include-cost":false,"x-notes":"JSONL/CSV görünümü hazırlanır; exports:write yanında kaynağın okuma kapsamı gerekir. Idempotency-Key zorunludur: aynı işin tekrarında aynı gövde/anahtarı kullanın. Aynı işletmede tek hazırlama çalışır; include desteklenmez. Hazır dosyayı tamamen uyguladıktan sonra resume_cursor (dosyanın bittiği andaki olay konumu) ile olaylara geçin.","x-optional-scopes":[],"x-personal-data":true,"x-purpose":"İlk eşitleme için siparişlerin, müşterilerin, ürünlerin veya stoğun tek andaki tutarlı dosyasını hazırlatın.","x-read-cost":60,"x-required-scopes":["exports:write"],"x-resource-scopes":{"customers":"customers:read","inventory_levels":"inventory:read","orders":"orders:read","products":"products:read","variants":"products:read"}}},"/exports/{id}":{"get":{"description":"Dosyanın hazırlanmasını izleyin; hazır olunca dosya ve devam imleci gelir. Kaynağın okuma kapsamı da gerekir. status=failed ise error_code inceleyin; completed olunca dosyayı indirin. Gerekli kapsamlar: exports:write.","operationId":"detail_exports__id__get","parameters":[{"description":"Okunacak kaynağın exp_ önekli dış kimliği.","example":"exp_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın exp_ önekli dış kimliği.","examples":["exp_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"completed_at":"2026-10-16T09:00:10Z","created_at":"2026-10-16T09:00:00Z","error_code":null,"file":{"bytes":2048,"content_type":"application/x-ndjson","download_path":"/v1/files/fil_1234567890abcdef1234567890abcdef","expires_at":"2026-10-23T09:00:00Z","id":"fil_1234567890abcdef1234567890abcdef"},"format":"jsonl","id":"exp_1234567890abcdef1234567890abcdef","resource":"orders","resume_cursor":"SUNUCUDAN_DONEN_IMLEC","row_count":1,"status":"completed"},"schema":{"$ref":"#/components/schemas/Export"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"export_access_changed":{"summary":"Dosya oluşturulduktan sonra erişim kapsamı değişmiş.","value":{"code":"export_access_changed","detail":"Dosya oluşturulduktan sonra erişim kapsamı değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:export_access_changed"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. export_access_changed: Dosya oluşturulduktan sonra erişim kapsamı değişmiş. Güncel izinlerle yeni dışa aktarma başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["exports:write"]}],"summary":"Dışa aktarmanın durumunu getir","tags":["Dışa aktarma"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id","export_access_changed"],"x-include-cost":false,"x-notes":"Kaynağın okuma kapsamı da gerekir. status=failed ise error_code inceleyin; completed olunca dosyayı indirin.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Dosyanın hazırlanmasını izleyin; hazır olunca dosya ve devam imleci gelir.","x-read-cost":1,"x-required-scopes":["exports:write"],"x-resource-scopes":{"customers":"customers:read","inventory_levels":"inventory:read","orders":"orders:read","products":"products:read","variants":"products:read"}}},"/external_orders":{"post":{"description":"Ödemesi başka bir kanalda (ör. Etsy, fuar, kendi kasanız) alınmış kesinleşmiş satışı stoktan düşmek ve listede görmek için kaydedin. Kalem fiyatları ve external_reference zorunludur; dış numara bu bağlantı ve channel_name içinde tekildir. source=api_external olur. Pazaryeriyle aynı stok, kanal tahsilatı ve müşteri yolu kullanılır; sayılan stok yetmezse eksiye iner, müşteriye e-posta/SMS gitmez. Yerel kasa tahsilatı veya kart çekimi yapılmaz. 201 sipariş okuma modeli, ETag ve Location döner. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_external_orders_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"channel_name":"Etsy","customer":{"email":"musteri@example.com","name":"Örnek Müşteri"},"external_reference":"ETSY-2026-001","items":[{"quantity":"2","sku":"KUPA-MAVI","unit_price":"120.00"}],"ordered_at":"2026-10-15T09:00:00Z","paid_at":"2026-10-15T09:01:00Z"},"schema":{"$ref":"#/components/schemas/CreateExternalOrder"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"channel":"Etsy","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"marketplace","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api_external","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"240.00","tax_status":"standard","tax_total":"20.00","total":"240.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Bildirilen satışın sipariş okuma yolu.","schema":{"examples":["/v1/orders/ord_1234567890abcdef1234567890abcdef"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"duplicate_external_reference":{"summary":"Bu dış numarayla sipariş zaten açılmış.","value":{"code":"duplicate_external_reference","detail":"Bu dış numarayla sipariş zaten açılmış.","errors":[],"existing_order":"ord_1234567890abcdef1234567890abcdef","request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:duplicate_external_reference"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. duplicate_external_reference: Bu dış numarayla sipariş zaten açılmış. existing_order içindeki ord_ kimliğini kullanın; ikinci sipariş açılmadı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Başka kanaldaki satışı bildir","tags":["Başka kanaldaki satış"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","conflict","invalid_id","store_required","store_forbidden","duplicate_external_reference"],"x-include-cost":false,"x-notes":"Kalem fiyatları ve external_reference zorunludur; dış numara bu bağlantı ve channel_name içinde tekildir. source=api_external olur. Pazaryeriyle aynı stok, kanal tahsilatı ve müşteri yolu kullanılır; sayılan stok yetmezse eksiye iner, müşteriye e-posta/SMS gitmez. Yerel kasa tahsilatı veya kart çekimi yapılmaz. 201 sipariş okuma modeli, ETag ve Location döner.","x-optional-scopes":["personal_data:write","personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Ödemesi başka bir kanalda (ör. Etsy, fuar, kendi kasanız) alınmış kesinleşmiş satışı stoktan düşmek ve listede görmek için kaydedin.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":true,"x-scope-conditions":{"personal_data:write":"İstekte `customer`, `shipping_address` gönderirseniz gerekir."}}},"/files/{id}":{"get":{"description":"Hazırlanan JSONL/CSV dosyasını indirin. Güncel marka/kapsam yetkisiyle indirilir; kaynağın okuma kapsamı da gerekir. 8 MiB üzeri dosya en çok 60 saniyelik imzalı adrese 307 dönebilir; Bearer başlığını hedefe taşımayın. created_at + 7 gün anında 410 file_expired döner; iş ve olay geçmişi korunur. Gerekli kapsamlar: exports:write.","operationId":"download_files__id__get","parameters":[{"description":"Okunacak kaynağın fil_ önekli dış kimliği.","example":"fil_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın fil_ önekli dış kimliği.","examples":["fil_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/x-ndjson":{"example":"{\"channel\": \"whatsapp\", \"created_at\": \"2026-10-16T09:00:00Z\", \"currency\": \"TRY\", \"delivery_day\": \"2026-10-17\", \"delivery_method\": \"shipping\", \"discount_total\": \"0.00\", \"gift_wrap_fee\": \"0.00\", \"id\": \"ord_1234567890abcdef1234567890abcdef\", \"number\": \"48273910\", \"payment_fee\": \"0.00\", \"payment_method\": \"bank_transfer\", \"payment_state\": \"paid\", \"shipping_total\": \"0.00\", \"source\": \"panel\", \"status\": \"confirmed\", \"store\": \"sto_1234567890abcdef1234567890abcdef\", \"subtotal\": \"120.00\", \"tax_status\": \"standard\", \"tax_total\": \"20.00\", \"total\": \"120.00\", \"updated_at\": \"2026-10-16T10:00:00Z\", \"customer\": null, \"preorder_from\": null}\n","schema":{"type":"string"}},"text/csv":{"example":"channel,created_at,currency,delivery_day,delivery_method,discount_total,gift_wrap_fee,id,number,payment_fee,payment_method,payment_state,shipping_total,source,status,store,subtotal,tax_status,tax_total,total,updated_at,customer,preorder_from\r\n\"\"\"whatsapp\"\"\",\"\"\"2026-10-16T09:00:00Z\"\"\",\"\"\"TRY\"\"\",\"\"\"2026-10-17\"\"\",\"\"\"shipping\"\"\",\"\"\"0.00\"\"\",\"\"\"0.00\"\"\",\"\"\"ord_1234567890abcdef1234567890abcdef\"\"\",\"\"\"48273910\"\"\",\"\"\"0.00\"\"\",\"\"\"bank_transfer\"\"\",\"\"\"paid\"\"\",\"\"\"0.00\"\"\",\"\"\"panel\"\"\",\"\"\"confirmed\"\"\",\"\"\"sto_1234567890abcdef1234567890abcdef\"\"\",\"\"\"120.00\"\"\",\"\"\"standard\"\"\",\"\"\"20.00\"\"\",\"\"\"120.00\"\"\",\"\"\"2026-10-16T10:00:00Z\"\"\",null,null\r\n","schema":{"type":"string"}}},"description":"Okuma uçlarındaki nesneler: JSONL satırı veya aynı üst alanları taşıyan CSV satırı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"307":{"description":"Yalnız 8 MiB üstü dosyada, en çok 60 saniyelik ve dosyanın kalan erişim süresini aşmayan imzalı adres.","headers":{"Location":{"description":"En çok 60 saniyelik indirme adresi; Bearer başlığını bu hedefe göndermeyin.","schema":{"examples":["https://example.com/signed-export"],"format":"uri","type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}},"x-example":{"body":"","headers":{"Location":"https://example.com/signed-export"},"status":307}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"export_access_changed":{"summary":"Dosya oluşturulduktan sonra erişim kapsamı değişmiş.","value":{"code":"export_access_changed","detail":"Dosya oluşturulduktan sonra erişim kapsamı değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:export_access_changed"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. export_access_changed: Dosya oluşturulduktan sonra erişim kapsamı değişmiş. Güncel izinlerle yeni dışa aktarma başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"export_not_ready":{"summary":"Dosya henüz hazır değil.","value":{"code":"export_not_ready","detail":"Dosya henüz hazır değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:export_not_ready"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"export_not_ready: Dosya henüz hazır değil. Dışa aktarma durumunu okuyup completed olmasını bekleyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"410":{"content":{"application/problem+json":{"examples":{"file_expired":{"summary":"Dosyanın 7 günlük erişim süresi dolmuş.","value":{"code":"file_expired","detail":"Dosyanın 7 günlük erişim süresi dolmuş.","errors":[],"request_id":"req_ornek_20261016","status":410,"title":"Gone","type":"urn:siparis:problem:file_expired"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"file_expired: Dosyanın 7 günlük erişim süresi dolmuş. Yeni dışa aktarma başlatın; mevcut olay devam imleci kullanılabilir.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"file_unavailable":{"summary":"Hazır dosyaya şu an erişilemiyor.","value":{"code":"file_unavailable","detail":"Hazır dosyaya şu an erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:file_unavailable"}},"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin. file_unavailable: Hazır dosyaya şu an erişilemiyor. Retry-After kadar bekleyip indirmeyi yeniden deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["exports:write"]}],"summary":"Dışa aktarma dosyasını indir","tags":["Dışa aktarma"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id","export_access_changed","file_expired","export_not_ready","file_unavailable"],"x-include-cost":false,"x-notes":"Güncel marka/kapsam yetkisiyle indirilir; kaynağın okuma kapsamı da gerekir. 8 MiB üzeri dosya en çok 60 saniyelik imzalı adrese 307 dönebilir; Bearer başlığını hedefe taşımayın. created_at + 7 gün anında 410 file_expired döner; iş ve olay geçmişi korunur.","x-optional-scopes":[],"x-personal-data":true,"x-purpose":"Hazırlanan JSONL/CSV dosyasını indirin.","x-read-cost":5,"x-required-scopes":["exports:write"],"x-resource-scopes":{"customers":"customers:read","inventory_levels":"inventory:read","orders":"orders:read","products":"products:read","variants":"products:read"}}},"/inventory/counts":{"post":{"description":"Depoda saydığınız miktarı stoğa yazın. Her satırda quantity ve expected zorunludur. expected, sayımdan önce okuduğunuz depo miktarıdır; stok sayılmıyorsa null gönderilir. Araya hareket girdiyse 409 stock_changed döner. Gerekli kapsamlar: inventory:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"inventory_counts_inventory_counts_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"lines":[{"expected":"10","quantity":"12","sku":"KUPA-MAVI"}],"location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/CountStock"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"changed":false},"schema":{"$ref":"#/components/schemas/UnchangedCount"}}},"description":"Miktar aynı; belge açılmadı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"201":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"doc_1234567890abcdef1234567890abcdef","kind":"receipt","location":"loc_1234567890abcdef1234567890abcdef","movements":{"data":[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}],"has_more":false,"next_cursor":null},"reversed_by":null,"reverses":null,"revision":1,"to_location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/Document"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Stok belgesinin güçlü sürüm etiketi.","schema":{"examples":["\"1\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni stok belgesinin API kökenine göre yolu.","schema":{"examples":["/v1/inventory/documents/doc_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"stock_changed":{"summary":"Sayım sırasında stok değişmiş.","value":{"code":"stock_changed","current_quantity":"9.000","detail":"Sayım sırasında stok değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:stock_changed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. stock_changed: Sayım sırasında stok değişmiş. Güncel depo miktarını okuyup expected alanını yenileyin; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_stock_operation":{"summary":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","value":{"code":"invalid_stock_operation","detail":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_stock_operation"}},"reserved_note":{"summary":"Bu açıklama sistem işlemlerine ayrılmıştır.","value":{"code":"reserved_note","detail":"Bu açıklama sistem işlemlerine ayrılmıştır.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:reserved_note"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_stock_operation: Stok işlemi ürünün veya deponun kurallarına uygun değil. Birimi, depo durumunu, sayılmayan stoğu ve belge türünü kontrol edin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın. reserved_note: Bu açıklama sistem işlemlerine ayrılmıştır. İşlemi kendi sözcüklerinizle açıklayın; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:write"]}],"summary":"Stok sayımı yap","tags":["Stok"],"x-data-class":"inventory","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_stock_operation","store_required","store_forbidden","reserved_note","stock_changed"],"x-include-cost":false,"x-notes":"Her satırda quantity ve expected zorunludur. expected, sayımdan önce okuduğunuz depo miktarıdır; stok sayılmıyorsa null gönderilir. Araya hareket girdiyse 409 stock_changed döner.","x-optional-scopes":["costs:read","internal_notes:read","internal_notes:write"],"x-personal-data":false,"x-purpose":"Depoda saydığınız miktarı stoğa yazın.","x-read-cost":1,"x-required-scopes":["inventory:write"],"x-scope-conditions":{"internal_notes:write":"İstekte `note` gönderirseniz gerekir."}}},"/inventory/documents/{id}":{"get":{"description":"Bir stok girişi, sayım, fire veya taşıma belgesini hareketleriyle okuyun. Görünür hareketi yoksa 404 döner. Devam imlecini aynı belgeyle burada veya document süzgeciyle inventory/movements ucunda kullanın. Gerekli kapsamlar: inventory:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"document_inventory_documents__id__get","parameters":[{"description":"Okunacak kaynağın doc_ önekli dış kimliği.","example":"doc_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın doc_ önekli dış kimliği.","examples":["doc_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"doc_1234567890abcdef1234567890abcdef","kind":"receipt","location":"loc_1234567890abcdef1234567890abcdef","movements":{"data":[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}],"has_more":false,"next_cursor":null},"reversed_by":null,"reverses":null,"revision":1,"to_location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/Document"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Stok belgesinin güçlü sürüm etiketi.","schema":{"examples":["\"1\""],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:read"]}],"summary":"Stok belgesini getir","tags":["Stok"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Görünür hareketi yoksa 404 döner. Devam imlecini aynı belgeyle burada veya document süzgeciyle inventory/movements ucunda kullanın.","x-optional-scopes":["costs:read","internal_notes:read"],"x-personal-data":false,"x-purpose":"Bir stok girişi, sayım, fire veya taşıma belgesini hareketleriyle okuyun.","x-read-cost":2,"x-required-scopes":["inventory:read"]}},"/inventory/documents/{id}/reverse":{"post":{"description":"Yanlış girilmiş mal girişini veya fireyi ters kayıtla düzeltin. Yalnız mal girişi veya fire belgesi bir kez ters kayıtla düzeltilir. Sayım yeniden sayılarak, taşıma ters yönde yeni taşıma yapılarak düzeltilir. If-Match belge kilidi altında denetlenir. Gerekli kapsamlar: inventory:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"reverse_inventory_documents__id__reverse_post","parameters":[{"description":"Okunacak kaynağın doc_ önekli dış kimliği.","example":"doc_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın doc_ önekli dış kimliği.","examples":["doc_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/ReverseStock"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"doc_1234567890abcdef1234567890abcdef","kind":"receipt","location":"loc_1234567890abcdef1234567890abcdef","movements":{"data":[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}],"has_more":false,"next_cursor":null},"reversed_by":null,"reverses":null,"revision":1,"to_location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/Document"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Stok belgesinin güçlü sürüm etiketi.","schema":{"examples":["\"1\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni stok belgesinin API kökenine göre yolu.","schema":{"examples":["/v1/inventory/documents/doc_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"document_forbidden":{"summary":"Belgenin tüm satırları marka kapsamında değil.","value":{"code":"document_forbidden","detail":"Belgenin tüm satırları marka kapsamında değil.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:document_forbidden"}},"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. document_forbidden: Belgenin tüm satırları marka kapsamında değil. İşletmenin tümüne yetkili stok bağlantısı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"document_already_reversed":{"summary":"Bu stok belgesi zaten tersine çevrilmiş.","value":{"code":"document_already_reversed","detail":"Bu stok belgesi zaten tersine çevrilmiş.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:document_already_reversed"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. document_already_reversed: Bu stok belgesi zaten tersine çevrilmiş. Güncel belgedeki reversed_by kaydını okuyun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_stock_operation":{"summary":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","value":{"code":"invalid_stock_operation","detail":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_stock_operation"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_stock_operation: Stok işlemi ürünün veya deponun kurallarına uygun değil. Birimi, depo durumunu, sayılmayan stoğu ve belge türünü kontrol edin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:write"]}],"summary":"Stok belgesini geri al","tags":["Stok"],"x-data-class":"inventory","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_stock_operation","store_required","store_forbidden","document_forbidden","document_already_reversed","invalid_if_match","revision_mismatch"],"x-include-cost":false,"x-notes":"Yalnız mal girişi veya fire belgesi bir kez ters kayıtla düzeltilir. Sayım yeniden sayılarak, taşıma ters yönde yeni taşıma yapılarak düzeltilir. If-Match belge kilidi altında denetlenir.","x-optional-scopes":["costs:read","internal_notes:read"],"x-personal-data":false,"x-purpose":"Yanlış girilmiş mal girişini veya fireyi ters kayıtla düzeltin.","x-read-cost":1,"x-required-scopes":["inventory:write"]}},"/inventory/levels":{"get":{"description":"Seçenek ve depo bazında eldeki fiziksel miktarı alın; ERP stok görünümünü güncellerken kullanın. Bu miktar sipariş verilebilir miktar değildir. Sayılmayan/sipariş üzerine stokta quantity=null olur. Gerekli kapsamlar: inventory:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"levels_inventory_levels_get","parameters":[{"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","example":"var_1234567890abcdef1234567890abcdef","in":"query","name":"variant","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},{"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","example":"prd_1234567890abcdef1234567890abcdef","in":"query","name":"product","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product"}},{"description":"Depo dış kimliği (loc_ ve 32 küçük onaltılık karakter).","example":"loc_1234567890abcdef1234567890abcdef","in":"query","name":"location","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Depo dış kimliği (loc_ ve 32 küçük onaltılık karakter).","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Başlangıç dahil; saat dilimli RFC 3339 zamanı.","example":"2026-10-16T09:00:00Z","in":"query","name":"updated_after","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç dahil; saat dilimli RFC 3339 zamanı.","examples":["2026-10-16T09:00:00Z"],"title":"Updated After"}},{"description":"Bitiş hariç; saat dilimli RFC 3339 zamanı.","example":"2026-10-17T09:00:00Z","in":"query","name":"updated_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş hariç; saat dilimli RFC 3339 zamanı.","examples":["2026-10-17T09:00:00Z"],"title":"Updated Before"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"archived":false,"id":"lvl_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","made_to_order":false,"product":"prd_1234567890abcdef1234567890abcdef","quantity":"12.000","quantity_unit":"adet","revision":1,"stock_state":"counted","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z","variant":"var_1234567890abcdef1234567890abcdef"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Level_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_date_range":{"summary":"Zaman aralığının başlangıcı bitişten sonra.","value":{"code":"invalid_date_range","detail":"Zaman aralığının başlangıcı bitişten sonra.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_date_range"}},"invalid_datetime":{"summary":"Zamanın saat dilimi eksik.","value":{"code":"invalid_datetime","detail":"Zamanın saat dilimi eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_datetime"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_datetime: Zamanın saat dilimi eksik. RFC 3339 değere Z veya +03:00 gibi saat dilimi ekleyin. invalid_date_range: Zaman aralığının başlangıcı bitişten sonra. Başlangıç ve bitiş sırasını düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:read"]}],"summary":"Stok miktarlarını listele","tags":["Stok"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id","invalid_datetime","invalid_date_range"],"x-include-cost":false,"x-notes":"Bu miktar sipariş verilebilir miktar değildir. Sayılmayan/sipariş üzerine stokta quantity=null olur.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Seçenek ve depo bazında eldeki fiziksel miktarı alın; ERP stok görünümünü güncellerken kullanın.","x-read-cost":2,"x-required-scopes":["inventory:read"]}},"/inventory/movements":{"get":{"description":"Stok değişimlerinin değişmez geçmişini alın; mutabakat yaparken kullanın. variant_balance_after seçenek toplamıdır, depo bakiyesi değildir; arşivlenmiş kaynağın geçmişi de görünür. Gerekli kapsamlar: inventory:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"movements_inventory_movements_get","parameters":[{"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","example":"var_1234567890abcdef1234567890abcdef","in":"query","name":"variant","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},{"description":"Depo dış kimliği (loc_ ve 32 küçük onaltılık karakter).","example":"loc_1234567890abcdef1234567890abcdef","in":"query","name":"location","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Depo dış kimliği (loc_ ve 32 küçük onaltılık karakter).","examples":["loc_1234567890abcdef1234567890abcdef"],"title":"Location"}},{"description":"Stok belgesi dış kimliği (doc_ ve 32 küçük onaltılık karakter).","example":"doc_1234567890abcdef1234567890abcdef","in":"query","name":"document","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stok belgesi dış kimliği (doc_ ve 32 küçük onaltılık karakter).","examples":["doc_1234567890abcdef1234567890abcdef"],"title":"Document"}},{"description":"Sipariş dış kimliği (ord_ ve 32 küçük onaltılık karakter).","example":"ord_1234567890abcdef1234567890abcdef","in":"query","name":"order","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sipariş dış kimliği (ord_ ve 32 küçük onaltılık karakter).","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Order"}},{"description":"Stok hareketinin nedenine göre tam eşitlik süzgeci.","example":"sale","in":"query","name":"reason","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stok hareketinin nedenine göre tam eşitlik süzgeci.","examples":["sale"],"title":"Reason"}},{"description":"Başlangıç dahil; saat dilimli RFC 3339 zamanı.","example":"2026-10-16T09:00:00Z","in":"query","name":"created_after","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç dahil; saat dilimli RFC 3339 zamanı.","examples":["2026-10-16T09:00:00Z"],"title":"Created After"}},{"description":"Bitiş hariç; saat dilimli RFC 3339 zamanı.","example":"2026-10-17T09:00:00Z","in":"query","name":"created_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş hariç; saat dilimli RFC 3339 zamanı.","examples":["2026-10-17T09:00:00Z"],"title":"Created Before"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Movement_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_date_range":{"summary":"Zaman aralığının başlangıcı bitişten sonra.","value":{"code":"invalid_date_range","detail":"Zaman aralığının başlangıcı bitişten sonra.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_date_range"}},"invalid_datetime":{"summary":"Zamanın saat dilimi eksik.","value":{"code":"invalid_datetime","detail":"Zamanın saat dilimi eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_datetime"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_datetime: Zamanın saat dilimi eksik. RFC 3339 değere Z veya +03:00 gibi saat dilimi ekleyin. invalid_date_range: Zaman aralığının başlangıcı bitişten sonra. Başlangıç ve bitiş sırasını düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:read"]}],"summary":"Stok hareketlerini listele","tags":["Stok"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id","invalid_datetime","invalid_date_range"],"x-include-cost":false,"x-notes":"variant_balance_after seçenek toplamıdır, depo bakiyesi değildir; arşivlenmiş kaynağın geçmişi de görünür.","x-optional-scopes":["costs:read","internal_notes:read"],"x-personal-data":false,"x-purpose":"Stok değişimlerinin değişmez geçmişini alın; mutabakat yaparken kullanın.","x-read-cost":2,"x-required-scopes":["inventory:read"]}},"/inventory/receipts":{"post":{"description":"Depoya gelen malı stoğa ekleyin. Seçilen depoya mal girişi yazar. Alış fiyatı ve tedarikçi costs:write ister; ağırlıklı ortalama maliyet panelin ortak kuralıyla hesaplanır. Gerekli kapsamlar: inventory:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"inventory_receipts_inventory_receipts_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"lines":[{"quantity":"2","sku":"KUPA-MAVI"}],"location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/ReceiveStock"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"doc_1234567890abcdef1234567890abcdef","kind":"receipt","location":"loc_1234567890abcdef1234567890abcdef","movements":{"data":[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}],"has_more":false,"next_cursor":null},"reversed_by":null,"reverses":null,"revision":1,"to_location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/Document"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Stok belgesinin güçlü sürüm etiketi.","schema":{"examples":["\"1\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni stok belgesinin API kökenine göre yolu.","schema":{"examples":["/v1/inventory/documents/doc_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_stock_operation":{"summary":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","value":{"code":"invalid_stock_operation","detail":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_stock_operation"}},"reserved_note":{"summary":"Bu açıklama sistem işlemlerine ayrılmıştır.","value":{"code":"reserved_note","detail":"Bu açıklama sistem işlemlerine ayrılmıştır.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:reserved_note"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_stock_operation: Stok işlemi ürünün veya deponun kurallarına uygun değil. Birimi, depo durumunu, sayılmayan stoğu ve belge türünü kontrol edin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın. reserved_note: Bu açıklama sistem işlemlerine ayrılmıştır. İşlemi kendi sözcüklerinizle açıklayın; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:write"]}],"summary":"Stok girişi yap","tags":["Stok"],"x-data-class":"inventory","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_stock_operation","store_required","store_forbidden","reserved_note","reference_namespace_forbidden","external_reference_conflict"],"x-include-cost":false,"x-notes":"Seçilen depoya mal girişi yazar. Alış fiyatı ve tedarikçi costs:write ister; ağırlıklı ortalama maliyet panelin ortak kuralıyla hesaplanır.","x-optional-scopes":["costs:read","internal_notes:read","internal_notes:write","costs:write"],"x-personal-data":false,"x-purpose":"Depoya gelen malı stoğa ekleyin.","x-read-cost":1,"x-required-scopes":["inventory:write"],"x-scope-conditions":{"costs:write":"İstekte `lines[].unit_price`, `vat_included`, `supplier`, `invoice_number`, `invoice_date` gönderirseniz gerekir.","internal_notes:write":"İstekte `note` gönderirseniz gerekir."}}},"/inventory/transfers":{"post":{"description":"Bir depodaki malı başka bir depoya taşıyın. location kaynağından to_location hedefine taşır. Toplam stok ve ortalama maliyet değişmez; kaynakta yeterli stok gerekir. Gerekli kapsamlar: inventory:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"inventory_transfers_inventory_transfers_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"lines":[{"quantity":"2","sku":"KUPA-MAVI"}],"location":"loc_1234567890abcdef1234567890abcdef","to_location":"loc_abcdef1234567890abcdef1234567890"},"schema":{"$ref":"#/components/schemas/TransferStock"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"doc_1234567890abcdef1234567890abcdef","kind":"receipt","location":"loc_1234567890abcdef1234567890abcdef","movements":{"data":[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}],"has_more":false,"next_cursor":null},"reversed_by":null,"reverses":null,"revision":1,"to_location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/Document"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Stok belgesinin güçlü sürüm etiketi.","schema":{"examples":["\"1\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni stok belgesinin API kökenine göre yolu.","schema":{"examples":["/v1/inventory/documents/doc_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_stock_operation":{"summary":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","value":{"code":"invalid_stock_operation","detail":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_stock_operation"}},"reserved_note":{"summary":"Bu açıklama sistem işlemlerine ayrılmıştır.","value":{"code":"reserved_note","detail":"Bu açıklama sistem işlemlerine ayrılmıştır.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:reserved_note"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_stock_operation: Stok işlemi ürünün veya deponun kurallarına uygun değil. Birimi, depo durumunu, sayılmayan stoğu ve belge türünü kontrol edin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın. reserved_note: Bu açıklama sistem işlemlerine ayrılmıştır. İşlemi kendi sözcüklerinizle açıklayın; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:write"]}],"summary":"Depolar arası taşı","tags":["Stok"],"x-data-class":"inventory","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_stock_operation","store_required","store_forbidden","reserved_note","insufficient_stock"],"x-include-cost":false,"x-notes":"location kaynağından to_location hedefine taşır. Toplam stok ve ortalama maliyet değişmez; kaynakta yeterli stok gerekir.","x-optional-scopes":["costs:read","internal_notes:read","internal_notes:write"],"x-personal-data":false,"x-purpose":"Bir depodaki malı başka bir depoya taşıyın.","x-read-cost":1,"x-required-scopes":["inventory:write"],"x-scope-conditions":{"internal_notes:write":"İstekte `note` gönderirseniz gerekir."}}},"/inventory/write_offs":{"post":{"description":"Kırılan, kaybolan veya kullanılamayan ürünü stoktan düşün. Panelin sektör nedenlerinden biriyle fire/kayıp yazar. other nedeninde açıklama zorunludur; depo bakiyesini aşan azalma reddedilir. Gerekli kapsamlar: inventory:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"inventory_write_offs_inventory_write_offs_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"lines":[{"quantity":"2","sku":"KUPA-MAVI"}],"location":"loc_1234567890abcdef1234567890abcdef","reason":"broken"},"schema":{"$ref":"#/components/schemas/WriteOffStock"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"doc_1234567890abcdef1234567890abcdef","kind":"receipt","location":"loc_1234567890abcdef1234567890abcdef","movements":{"data":[{"count_reason":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","document":"doc_1234567890abcdef1234567890abcdef","id":"mov_1234567890abcdef1234567890abcdef","location":"loc_1234567890abcdef1234567890abcdef","order":"ord_1234567890abcdef1234567890abcdef","product":"prd_1234567890abcdef1234567890abcdef","quantity_change":"-1.000","reason":"sale","variant":"var_1234567890abcdef1234567890abcdef","variant_balance_after":"12.000"}],"has_more":false,"next_cursor":null},"reversed_by":null,"reverses":null,"revision":1,"to_location":"loc_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/Document"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Stok belgesinin güçlü sürüm etiketi.","schema":{"examples":["\"1\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni stok belgesinin API kökenine göre yolu.","schema":{"examples":["/v1/inventory/documents/doc_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_stock_operation":{"summary":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","value":{"code":"invalid_stock_operation","detail":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_stock_operation"}},"reserved_note":{"summary":"Bu açıklama sistem işlemlerine ayrılmıştır.","value":{"code":"reserved_note","detail":"Bu açıklama sistem işlemlerine ayrılmıştır.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:reserved_note"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_stock_operation: Stok işlemi ürünün veya deponun kurallarına uygun değil. Birimi, depo durumunu, sayılmayan stoğu ve belge türünü kontrol edin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın. reserved_note: Bu açıklama sistem işlemlerine ayrılmıştır. İşlemi kendi sözcüklerinizle açıklayın; yeni tekrar anahtarı kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:write"]}],"summary":"Fire ve kayıp yaz","tags":["Stok"],"x-data-class":"inventory","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","invalid_id","invalid_stock_operation","store_required","store_forbidden","reserved_note","insufficient_stock"],"x-include-cost":false,"x-notes":"Panelin sektör nedenlerinden biriyle fire/kayıp yazar. other nedeninde açıklama zorunludur; depo bakiyesini aşan azalma reddedilir.","x-optional-scopes":["costs:read","internal_notes:read","internal_notes:write"],"x-personal-data":false,"x-purpose":"Kırılan, kaybolan veya kullanılamayan ürünü stoktan düşün.","x-read-cost":1,"x-required-scopes":["inventory:write"],"x-scope-conditions":{"internal_notes:write":"İstekte `note` gönderirseniz gerekir."}}},"/invoices/{id}":{"get":{"description":"Faturanın kesilip kesilmediğini ve iptal durumunu okuyun. Fatura durumu pending, issued, failed veya cancelled olur. cancellation_status iptal işinin pending, unknown, failed veya succeeded durumudur; fatura kesin iptale kadar issued kalır. error_code sabit hata kodudur. Kaynak okuması sağlayıcıya istek göndermez. Gerekli kapsamlar: invoices:read.","operationId":"get_invoices__id__get","parameters":[{"description":"Okunacak kaynağın inv_ önekli dış kimliği.","example":"inv_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın inv_ önekli dış kimliği.","examples":["inv_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"cancelled_at":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"inv_1234567890abcdef1234567890abcdef","issued_at":"2026-10-16T09:00:00Z","kind":"e_arsiv","status":"issued","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Invoice"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Location":{"description":"Faturayı izleme yolu.","schema":{"examples":["/v1/invoices/inv_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["invoices:read"]}],"summary":"Faturayı getir","tags":["Fatura"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-notes":"Fatura durumu pending, issued, failed veya cancelled olur. cancellation_status iptal işinin pending, unknown, failed veya succeeded durumudur; fatura kesin iptale kadar issued kalır. error_code sabit hata kodudur. Kaynak okuması sağlayıcıya istek göndermez.","x-optional-scopes":["personal_data:read"],"x-personal-data":true,"x-purpose":"Faturanın kesilip kesilmediğini ve iptal durumunu okuyun.","x-read-cost":1,"x-required-scopes":["invoices:read"]}},"/invoices/{id}/cancel":{"post":{"description":"Kesilmiş faturayı iptal edin. API destekliyorsa iptal kuyruğa alınır: 202 ve cancellation_status=pending. Portal gerekiyorsa 409 invoice_portal_required ve panelin açıklaması döner; portalda tamamladıktan sonra portal_done=true gönderin. Bu onay ve zaten iptal edilmiş fatura 200 döner. Yanıtsız dış iptal unknown kalır ve körlemesine tekrarlanmaz; portalda doğrulandıktan sonra portal_done=true ile kaydı tamamlayın. Para iadesi başlatmaz, muhasebe kaydı silinmez. Gerekli kapsamlar: invoices:write, money_out:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"cancel_invoices__id__cancel_post","parameters":[{"description":"Okunacak kaynağın inv_ önekli dış kimliği.","example":"inv_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın inv_ önekli dış kimliği.","examples":["inv_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CancelInvoice"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"cancellation_status":"succeeded","cancelled_at":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"inv_1234567890abcdef1234567890abcdef","issued_at":"2026-10-16T09:00:00Z","kind":"e_arsiv","status":"cancelled","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Invoice"}}},"description":"İptal kaydedildi veya fatura zaten iptal edilmiş.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Faturayı izleme yolu.","schema":{"examples":["/v1/invoices/inv_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"202":{"content":{"application/json":{"example":{"cancellation_status":"pending","cancelled_at":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"inv_1234567890abcdef1234567890abcdef","issued_at":"2026-10-16T09:00:00Z","kind":"e_arsiv","status":"issued","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Invoice"}}},"description":"Fatura işlemi kuyruğa alındı; Location ile izleyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Faturayı izleme yolu.","schema":{"examples":["/v1/invoices/inv_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"invoice_seller_invalid":{"summary":"İşletmenin vergi bilgileri eksik.","value":{"code":"invoice_seller_invalid","detail":"İşletmenin vergi bilgileri eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invoice_seller_invalid"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invoice_seller_invalid: İşletmenin vergi bilgileri eksik. İşletme bilgilerini tamamlayın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"invoice_already_cancelled":{"summary":"Fatura zaten iptal edilmiş.","value":{"code":"invoice_already_cancelled","detail":"Fatura zaten iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_already_cancelled"}},"invoice_billing_invalid":{"summary":"Siparişin fatura bilgileri uygun değil.","value":{"code":"invoice_billing_invalid","detail":"Siparişin fatura bilgileri uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_billing_invalid"}},"invoice_cancel_running":{"summary":"Fatura iptali sürüyor.","value":{"code":"invoice_cancel_running","detail":"Fatura iptali sürüyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_cancel_running"}},"invoice_cancel_uncertain":{"summary":"Fatura iptalinin sonucu belirsiz.","value":{"code":"invoice_cancel_uncertain","detail":"Fatura iptalinin sonucu belirsiz.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_cancel_uncertain"}},"invoice_connection_changed":{"summary":"Fatura sağlayıcı bağlantısı değişti.","value":{"code":"invoice_connection_changed","detail":"Fatura sağlayıcı bağlantısı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_connection_changed"}},"invoice_empty_order":{"summary":"Siparişte ürün yok; fatura kesilemez.","value":{"code":"invoice_empty_order","detail":"Siparişte ürün yok; fatura kesilemez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_empty_order"}},"invoice_exists":{"summary":"Siparişin etkin faturası var.","value":{"code":"invoice_exists","detail":"Siparişin etkin faturası var.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_exists"}},"invoice_not_allowed":{"summary":"Fatura işlemi şu an yapılamıyor.","value":{"code":"invoice_not_allowed","detail":"Fatura işlemi şu an yapılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_allowed"}},"invoice_not_connected":{"summary":"Fatura sağlayıcısı bağlı değil.","value":{"code":"invoice_not_connected","detail":"Fatura sağlayıcısı bağlı değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_connected"}},"invoice_not_ready":{"summary":"Fatura belgesi henüz hazır değil.","value":{"code":"invoice_not_ready","detail":"Fatura belgesi henüz hazır değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_ready"}},"invoice_order_not_allowed":{"summary":"Bu siparişe fatura kesilemez.","value":{"code":"invoice_order_not_allowed","detail":"Bu siparişe fatura kesilemez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_order_not_allowed"}},"invoice_payment_required":{"summary":"Ödeme gelince fatura kesilebilir.","value":{"code":"invoice_payment_required","detail":"Ödeme gelince fatura kesilebilir.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_payment_required"}},"invoice_portal_required":{"summary":"Sağlayıcı portalından iptal gerekiyor.","value":{"code":"invoice_portal_required","detail":"Sağlayıcı portalından iptal gerekiyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_portal_required"}},"invoice_provider_auth":{"summary":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","value":{"code":"invoice_provider_auth","detail":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_provider_auth"}},"invoice_provider_error":{"summary":"Fatura sağlayıcısı işlemi tamamlayamadı.","value":{"code":"invoice_provider_error","detail":"Fatura sağlayıcısı işlemi tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_provider_error"}},"invoice_zero_total":{"summary":"Sipariş tutarı 0 TL; fatura kesilmez.","value":{"code":"invoice_zero_total","detail":"Sipariş tutarı 0 TL; fatura kesilmez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_zero_total"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. invoice_not_connected: Fatura sağlayıcısı bağlı değil. İşletme > Entegrasyonlar bölümünden sağlayıcınızı bağlayın. invoice_order_not_allowed: Bu siparişe fatura kesilemez. Siparişin iptal/iade durumunu kontrol edin. invoice_zero_total: Sipariş tutarı 0 TL; fatura kesilmez. Sipariş tutarını kontrol edin. invoice_payment_required: Ödeme gelince fatura kesilebilir. Ödeme kaydını kontrol edin. invoice_billing_invalid: Siparişin fatura bilgileri uygun değil. Paneldeki açıklamaya göre fatura bilgilerini tamamlayın. invoice_empty_order: Siparişte ürün yok; fatura kesilemez. Sipariş kalemlerini kontrol edin. invoice_exists: Siparişin etkin faturası var. Mevcut faturayı okuyun; hazırlanan fatura için yeni istek açmayın. invoice_not_allowed: Fatura işlemi şu an yapılamıyor. Açıklamadaki panel kuralını izleyin. invoice_already_cancelled: Fatura zaten iptal edilmiş. Güncel faturayı okuyun. invoice_not_ready: Fatura belgesi henüz hazır değil. Faturanın numarası kesinleşince yeniden deneyin. invoice_portal_required: Sağlayıcı portalından iptal gerekiyor. Portalda tamamladıktan sonra portal_done=true gönderin. invoice_cancel_running: Fatura iptali sürüyor. Süren çağrının bitmesini bekleyin. invoice_connection_changed: Fatura sağlayıcı bağlantısı değişti. Önceki sağlayıcı hesabında faturayı kontrol edin. invoice_cancel_uncertain: Fatura iptalinin sonucu belirsiz. Yeni dış iptal gönderilmez; portalda doğrulayıp portal_done=true ile tamamlayın. invoice_provider_auth: Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi. İşletme > Entegrasyonlar bölümünden bağlantıyı düzeltin; aynı faturayı izleyin. invoice_provider_error: Fatura sağlayıcısı işlemi tamamlayamadı. Faturanın durumunu ve sağlayıcı portalını kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["invoices:write","money_out:write"]}],"summary":"Faturayı iptal et","tags":["Fatura"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","invoice_not_connected","invoice_order_not_allowed","invoice_zero_total","invoice_payment_required","invoice_billing_invalid","invoice_seller_invalid","invoice_empty_order","invoice_exists","invoice_not_allowed","invoice_already_cancelled","invoice_not_ready","invoice_portal_required","invoice_cancel_running","invoice_connection_changed","invoice_cancel_uncertain","invoice_provider_auth","invoice_provider_error","invalid_id"],"x-include-cost":false,"x-notes":"API destekliyorsa iptal kuyruğa alınır: 202 ve cancellation_status=pending. Portal gerekiyorsa 409 invoice_portal_required ve panelin açıklaması döner; portalda tamamladıktan sonra portal_done=true gönderin. Bu onay ve zaten iptal edilmiş fatura 200 döner. Yanıtsız dış iptal unknown kalır ve körlemesine tekrarlanmaz; portalda doğrulandıktan sonra portal_done=true ile kaydı tamamlayın. Para iadesi başlatmaz, muhasebe kaydı silinmez.","x-optional-scopes":["personal_data:read"],"x-personal-data":true,"x-purpose":"Kesilmiş faturayı iptal edin.","x-read-cost":1,"x-required-scopes":["invoices:write","money_out:write"]}},"/invoices/{id}/cancel/preview":{"post":{"description":"Faturanın API ile mi, sağlayıcı portalından mı iptal edileceğini öğrenin. Yan etkisiz POST; Idempotency-Key gerekmez. Panelin iptal planı API ile iptal veya portal gereğini açıklar. e-Fatura ve Paraşüt e-belgelerinde önce sağlayıcının portalından işlem gerekir. İptal yazmasıyla aynı kapsamlar gerekir. Gerekli kapsamlar: invoices:write, money_out:write.","operationId":"cancel_preview_invoices__id__cancel_preview_post","parameters":[{"description":"Okunacak kaynağın inv_ önekli dış kimliği.","example":"inv_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın inv_ önekli dış kimliği.","examples":["inv_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/InvoiceInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"code":null,"detail":null,"invoice":"inv_1234567890abcdef1234567890abcdef","portal_required":false,"via_api":true},"schema":{"$ref":"#/components/schemas/InvoiceCancelPreview"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"invoice_seller_invalid":{"summary":"İşletmenin vergi bilgileri eksik.","value":{"code":"invoice_seller_invalid","detail":"İşletmenin vergi bilgileri eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invoice_seller_invalid"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invoice_seller_invalid: İşletmenin vergi bilgileri eksik. İşletme bilgilerini tamamlayın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"invoice_already_cancelled":{"summary":"Fatura zaten iptal edilmiş.","value":{"code":"invoice_already_cancelled","detail":"Fatura zaten iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_already_cancelled"}},"invoice_billing_invalid":{"summary":"Siparişin fatura bilgileri uygun değil.","value":{"code":"invoice_billing_invalid","detail":"Siparişin fatura bilgileri uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_billing_invalid"}},"invoice_cancel_running":{"summary":"Fatura iptali sürüyor.","value":{"code":"invoice_cancel_running","detail":"Fatura iptali sürüyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_cancel_running"}},"invoice_cancel_uncertain":{"summary":"Fatura iptalinin sonucu belirsiz.","value":{"code":"invoice_cancel_uncertain","detail":"Fatura iptalinin sonucu belirsiz.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_cancel_uncertain"}},"invoice_connection_changed":{"summary":"Fatura sağlayıcı bağlantısı değişti.","value":{"code":"invoice_connection_changed","detail":"Fatura sağlayıcı bağlantısı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_connection_changed"}},"invoice_empty_order":{"summary":"Siparişte ürün yok; fatura kesilemez.","value":{"code":"invoice_empty_order","detail":"Siparişte ürün yok; fatura kesilemez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_empty_order"}},"invoice_exists":{"summary":"Siparişin etkin faturası var.","value":{"code":"invoice_exists","detail":"Siparişin etkin faturası var.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_exists"}},"invoice_not_allowed":{"summary":"Fatura işlemi şu an yapılamıyor.","value":{"code":"invoice_not_allowed","detail":"Fatura işlemi şu an yapılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_allowed"}},"invoice_not_connected":{"summary":"Fatura sağlayıcısı bağlı değil.","value":{"code":"invoice_not_connected","detail":"Fatura sağlayıcısı bağlı değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_connected"}},"invoice_not_ready":{"summary":"Fatura belgesi henüz hazır değil.","value":{"code":"invoice_not_ready","detail":"Fatura belgesi henüz hazır değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_ready"}},"invoice_order_not_allowed":{"summary":"Bu siparişe fatura kesilemez.","value":{"code":"invoice_order_not_allowed","detail":"Bu siparişe fatura kesilemez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_order_not_allowed"}},"invoice_payment_required":{"summary":"Ödeme gelince fatura kesilebilir.","value":{"code":"invoice_payment_required","detail":"Ödeme gelince fatura kesilebilir.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_payment_required"}},"invoice_portal_required":{"summary":"Sağlayıcı portalından iptal gerekiyor.","value":{"code":"invoice_portal_required","detail":"Sağlayıcı portalından iptal gerekiyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_portal_required"}},"invoice_provider_auth":{"summary":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","value":{"code":"invoice_provider_auth","detail":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_provider_auth"}},"invoice_provider_error":{"summary":"Fatura sağlayıcısı işlemi tamamlayamadı.","value":{"code":"invoice_provider_error","detail":"Fatura sağlayıcısı işlemi tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_provider_error"}},"invoice_zero_total":{"summary":"Sipariş tutarı 0 TL; fatura kesilmez.","value":{"code":"invoice_zero_total","detail":"Sipariş tutarı 0 TL; fatura kesilmez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_zero_total"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invoice_not_connected: Fatura sağlayıcısı bağlı değil. İşletme > Entegrasyonlar bölümünden sağlayıcınızı bağlayın. invoice_order_not_allowed: Bu siparişe fatura kesilemez. Siparişin iptal/iade durumunu kontrol edin. invoice_zero_total: Sipariş tutarı 0 TL; fatura kesilmez. Sipariş tutarını kontrol edin. invoice_payment_required: Ödeme gelince fatura kesilebilir. Ödeme kaydını kontrol edin. invoice_billing_invalid: Siparişin fatura bilgileri uygun değil. Paneldeki açıklamaya göre fatura bilgilerini tamamlayın. invoice_empty_order: Siparişte ürün yok; fatura kesilemez. Sipariş kalemlerini kontrol edin. invoice_exists: Siparişin etkin faturası var. Mevcut faturayı okuyun; hazırlanan fatura için yeni istek açmayın. invoice_not_allowed: Fatura işlemi şu an yapılamıyor. Açıklamadaki panel kuralını izleyin. invoice_already_cancelled: Fatura zaten iptal edilmiş. Güncel faturayı okuyun. invoice_not_ready: Fatura belgesi henüz hazır değil. Faturanın numarası kesinleşince yeniden deneyin. invoice_portal_required: Sağlayıcı portalından iptal gerekiyor. Portalda tamamladıktan sonra portal_done=true gönderin. invoice_cancel_running: Fatura iptali sürüyor. Süren çağrının bitmesini bekleyin. invoice_connection_changed: Fatura sağlayıcı bağlantısı değişti. Önceki sağlayıcı hesabında faturayı kontrol edin. invoice_cancel_uncertain: Fatura iptalinin sonucu belirsiz. Yeni dış iptal gönderilmez; portalda doğrulayıp portal_done=true ile tamamlayın. invoice_provider_auth: Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi. İşletme > Entegrasyonlar bölümünden bağlantıyı düzeltin; aynı faturayı izleyin. invoice_provider_error: Fatura sağlayıcısı işlemi tamamlayamadı. Faturanın durumunu ve sağlayıcı portalını kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["invoices:write","money_out:write"]}],"summary":"Fatura iptalini önizle","tags":["Fatura"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invoice_not_connected","invoice_order_not_allowed","invoice_zero_total","invoice_payment_required","invoice_billing_invalid","invoice_seller_invalid","invoice_empty_order","invoice_exists","invoice_not_allowed","invoice_already_cancelled","invoice_not_ready","invoice_portal_required","invoice_cancel_running","invoice_connection_changed","invoice_cancel_uncertain","invoice_provider_auth","invoice_provider_error","invalid_id"],"x-include-cost":false,"x-notes":"Yan etkisiz POST; Idempotency-Key gerekmez. Panelin iptal planı API ile iptal veya portal gereğini açıklar. e-Fatura ve Paraşüt e-belgelerinde önce sağlayıcının portalından işlem gerekir. İptal yazmasıyla aynı kapsamlar gerekir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Faturanın API ile mi, sağlayıcı portalından mı iptal edileceğini öğrenin.","x-read-cost":1,"x-required-scopes":["invoices:write","money_out:write"],"x-side-effect-free":true}},"/invoices/{id}/document":{"get":{"description":"Faturanın yazdırılabilir HTML görünümünü indirin. Panelle aynı yazdırılabilir HTML görünümüdür; resmî e-belge sağlayıcı portalındadır. invoices:read ve personal_data:read birlikte gerekir. Güncel marka ve kapsam her indirmede denetlenir; no-store, nosniff ve CSP sandbox kullanılır. Hazırlanan/başarısız faturada 409 invoice_not_ready; iptal edilmiş faturada iptal damgalı belge verilir. Gerekli kapsamlar: invoices:read, personal_data:read.","operationId":"document_invoices__id__document_get","parameters":[{"description":"Okunacak kaynağın inv_ önekli dış kimliği.","example":"inv_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın inv_ önekli dış kimliği.","examples":["inv_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"text/html":{"example":"<!doctype html><html lang=\"tr\"><title>Fatura</title><body>Fatura görünümü</body></html>","schema":{"type":"string"}}},"description":"Panelle aynı yazdırılabilir HTML; resmî belge sağlayıcı portalındadır.","headers":{"Cache-Control":{"description":"Kişisel belge önbelleklenmez.","schema":{"examples":["no-store"],"type":"string"}},"Content-Disposition":{"description":"Panelle aynı yazdırılabilir HTML dosyası.","schema":{"examples":["attachment; filename=\"fatura-inv_1234567890abcdef1234567890abcdef.html\""],"type":"string"}},"Content-Security-Policy":{"description":"Betikleri ve dış kaynakları engeller.","schema":{"examples":["default-src 'none'; style-src 'unsafe-inline'; sandbox"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Content-Type-Options":{"description":"Tarayıcı içerik türünü tahmin etmez.","schema":{"examples":["nosniff"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"invoice_not_ready":{"summary":"Fatura belgesi henüz hazır değil.","value":{"code":"invoice_not_ready","detail":"Fatura belgesi henüz hazır değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_ready"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invoice_not_ready: Fatura belgesi henüz hazır değil. Faturanın numarası kesinleşince yeniden deneyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["invoices:read","personal_data:read"]}],"summary":"Fatura belgesini indir","tags":["Fatura"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invoice_not_ready","invalid_id"],"x-include-cost":false,"x-notes":"Panelle aynı yazdırılabilir HTML görünümüdür; resmî e-belge sağlayıcı portalındadır. invoices:read ve personal_data:read birlikte gerekir. Güncel marka ve kapsam her indirmede denetlenir; no-store, nosniff ve CSP sandbox kullanılır. Hazırlanan/başarısız faturada 409 invoice_not_ready; iptal edilmiş faturada iptal damgalı belge verilir.","x-optional-scopes":[],"x-personal-data":true,"x-purpose":"Faturanın yazdırılabilir HTML görünümünü indirin.","x-read-cost":1,"x-required-scopes":["invoices:read","personal_data:read"]}},"/jobs/{id}":{"get":{"description":"Toplu fiyat veya stok işinin ilerlemesini ve sonucunu izleyin. Yalnız işi açan bağlantı ve işin products:write veya inventory:write kapsamıyla okunur. Maliyet içeren iş costs:write da ister. processed başarısız satırlar dahil sonuçlanan satır sayısıdır. Geçerli Bearer anahtarı yeterlidir; ek kapsam gerekmez.","operationId":"detail_jobs__id__get","parameters":[{"description":"Okunacak kaynağın job_ önekli dış kimliği.","example":"job_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın job_ önekli dış kimliği.","examples":["job_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","error_code":null,"failed":0,"finished_at":null,"id":"job_1234567890abcdef1234567890abcdef","kind":"prices","processed":0,"status":"queued","total":10000},"schema":{"$ref":"#/components/schemas/BulkJob"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"bulk_access_changed":{"summary":"İşin erişim kapsamı değişti.","value":{"code":"bulk_access_changed","detail":"İşin erişim kapsamı değişti.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:bulk_access_changed"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. bulk_access_changed: İşin erişim kapsamı değişti. İşin açıldığı bağlantı ve kaynak kapsamlarını kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":[]}],"summary":"Toplu işin durumunu getir","tags":["Toplu işler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id","bulk_access_changed"],"x-include-cost":false,"x-notes":"Yalnız işi açan bağlantı ve işin products:write veya inventory:write kapsamıyla okunur. Maliyet içeren iş costs:write da ister. processed başarısız satırlar dahil sonuçlanan satır sayısıdır.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Toplu fiyat veya stok işinin ilerlemesini ve sonucunu izleyin.","x-read-cost":1,"x-required-scopes":[],"x-resource-scopes":{"inventory":"inventory:write","prices":"products:write"}}},"/jobs/{id}/errors":{"get":{"description":"Toplu işte işlenemeyen satırları ve nedenlerini alın. İşle aynı bağlantı ve kapsam gerekir. 1 ile başlayan satır numarası, gönderilen kimlik, sabit kod ve açıklama verir. limit ve cursor ile sayfalanır. Geçerli Bearer anahtarı yeterlidir; ek kapsam gerekmez. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"errors_jobs__id__errors_get","parameters":[{"description":"Okunacak kaynağın job_ önekli dış kimliği.","example":"job_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın job_ önekli dış kimliği.","examples":["job_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"code":"not_found","detail":"Seçenek bulunamadı.","identifier":"BULUNAMAYAN-KOD","line":2}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/BulkErrorPage"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"bulk_access_changed":{"summary":"İşin erişim kapsamı değişti.","value":{"code":"bulk_access_changed","detail":"İşin erişim kapsamı değişti.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:bulk_access_changed"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. bulk_access_changed: İşin erişim kapsamı değişti. İşin açıldığı bağlantı ve kaynak kapsamlarını kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":[]}],"summary":"Toplu işin hatalarını listele","tags":["Toplu işler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id","bulk_access_changed"],"x-include-cost":false,"x-notes":"İşle aynı bağlantı ve kapsam gerekir. 1 ile başlayan satır numarası, gönderilen kimlik, sabit kod ve açıklama verir. limit ve cursor ile sayfalanır.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Toplu işte işlenemeyen satırları ve nedenlerini alın.","x-read-cost":2,"x-required-scopes":[],"x-resource-scopes":{"inventory":"inventory:write","prices":"products:write"}}},"/locations":{"get":{"description":"Anahtarın görebildiği depoları alın; stok miktarlarındaki location kimliğini kendi depo adınızla eşleştirin. Markalar aynı fiziksel stoğu paylaşabilir. Gerekli kapsamlar: inventory:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"locations_locations_get","parameters":[{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"active":true,"created_at":"2026-10-16T09:00:00Z","id":"loc_1234567890abcdef1234567890abcdef","is_default":true,"name":"Ana depo","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Location_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["inventory:read"]}],"summary":"Depoları listele","tags":["Stok"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor"],"x-include-cost":false,"x-notes":"Markalar aynı fiziksel stoğu paylaşabilir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Anahtarın görebildiği depoları alın; stok miktarlarındaki location kimliğini kendi depo adınızla eşleştirin.","x-read-cost":2,"x-required-scopes":["inventory:read"]}},"/me":{"get":{"description":"Anahtarın çalıştığını, kapsamlarını, erişebildiği markaları ve bu ortamın API adresini görün; ilk istekte ve yetki sorunlarını çözerken kullanın. Geçerli Bearer anahtarı yeterlidir; ek kapsam gerekmez.","operationId":"me_me_get","responses":{"200":{"content":{"application/json":{"example":{"api_url":"https://api.siparis.app/v1","api_version":"v1","environment":"live","id":"grt_1234567890abcdef1234567890abcdef","scopes":["orders:read","events:read"],"stores":[{"id":"sto_1234567890abcdef1234567890abcdef","name":"Örnek Marka"}]},"schema":{"$ref":"#/components/schemas/Identity"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":[]}],"summary":"Bağlantıyı doğrula","tags":["Hesap"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable"],"x-include-cost":false,"x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Anahtarın çalıştığını, kapsamlarını, erişebildiği markaları ve bu ortamın API adresini görün; ilk istekte ve yetki sorunlarını çözerken kullanın.","x-read-cost":1,"x-required-scopes":[]}},"/openapi.json":{"get":{"description":"Bütün uçları, alanları ve örnekleri içeren OpenAPI 3.1 belgesini indirin; istemci üretimi, alan doğrulama ve AI entegrasyonu için kullanın. Kimlik doğrulama gerektirmez. servers adresi /v1 içerir; paths yollarına ikinci kez /v1 eklemeyin. Herkese açıktır; anahtar veya kapsam gerekmez.","operationId":"openapi_document_openapi_json_get","responses":{"200":{"content":{"application/json":{"example":{"info":{"title":"siparis.app Açık API","version":"v1"},"openapi":"3.1.0","paths":{}},"schema":{"additionalProperties":true,"title":"Response Openapi Document Openapi Json Get","type":"object"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[],"summary":"OpenAPI sözleşmesini indir","tags":["Referans"],"x-data-class":"metadata","x-error-codes":["method_not_allowed","internal_error","service_unavailable"],"x-include-cost":false,"x-notes":"Kimlik doğrulama gerektirmez. servers adresi /v1 içerir; paths yollarına ikinci kez /v1 eklemeyin.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bütün uçları, alanları ve örnekleri içeren OpenAPI 3.1 belgesini indirin; istemci üretimi, alan doğrulama ve AI entegrasyonu için kullanın.","x-read-cost":0,"x-required-scopes":[]}},"/orders":{"get":{"description":"Yetkili markaların siparişlerini zaman, durum, marka ve görünen numarayla süzerek alın; ERP sipariş aktarımında kullanın. Varsayılan sıra updated_at,id artandır; sort=-created_at en yeni siparişi önce getirir. customer=cus_... yalnız sort=-created_at ile kullanılır ve o karta bağlı siparişleri verir; başka sıra veya sort alanının atlanması 422 döner. Alt kayıtlar sipariş ayrıntısından veya alt uçlardan okunur. Gerekli kapsamlar: orders:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"orders_orders_get","parameters":[{"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}},{"description":"updated_at: son değişiklikten ileri; -created_at: en yeni sipariş önce. Sıra değişirse yeni sayfalama başlatın.","example":"-created_at","in":"query","name":"sort","required":false,"schema":{"default":"updated_at","description":"updated_at: son değişiklikten ileri; -created_at: en yeni sipariş önce. Sıra değişirse yeni sayfalama başlatın.","enum":["updated_at","-created_at"],"examples":["-created_at"],"title":"Sort","type":"string"}},{"description":"Siparişin bağlı olduğu cus_ müşteri kimliği; yalnız sort=-created_at ile kullanılabilir. Başka markanın müşterisi marka sınırlı anahtara görünmez.","example":"cus_1234567890abcdef1234567890abcdef","in":"query","name":"customer","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Siparişin bağlı olduğu cus_ müşteri kimliği; yalnız sort=-created_at ile kullanılabilir. Başka markanın müşterisi marka sınırlı anahtara görünmez.","examples":["cus_1234567890abcdef1234567890abcdef"],"title":"Customer"}},{"description":"Sipariş durumu eşitlik süzgeci. payment_pending eski değerdir: 19 Ekim 2026'dan beri hiçbir sipariş bu durumda açılmaz, süzgeç boş sonuç verir; ödemesi beklenen sipariş payment_state=awaiting ya da partial taşır.","example":"confirmed","in":"query","name":"status","required":false,"schema":{"anyOf":[{"enum":["pending","payment_pending","confirmed","processing","shipped","delivered","cancelled","refunded"],"type":"string"},{"type":"null"}],"description":"Sipariş durumu eşitlik süzgeci. payment_pending eski değerdir: 19 Ekim 2026'dan beri hiçbir sipariş bu durumda açılmaz, süzgeç boş sonuç verir; ödemesi beklenen sipariş payment_state=awaiting ya da partial taşır.","examples":["confirmed"],"title":"Status"}},{"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","example":"sto_1234567890abcdef1234567890abcdef","in":"query","name":"store","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"}},{"description":"Siparişin görünen sekiz haneli numarası; kaynak kimliği değildir.","example":"48273910","in":"query","name":"number","required":false,"schema":{"anyOf":[{"pattern":"^[0-9]{8}$","type":"string"},{"type":"null"}],"description":"Siparişin görünen sekiz haneli numarası; kaynak kimliği değildir.","examples":["48273910"],"title":"Number"}},{"description":"Başlangıç zamanı dahil; saat dilimli RFC 3339 gönderin.","example":"2026-10-16T09:00:00Z","in":"query","name":"created_at_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç zamanı dahil; saat dilimli RFC 3339 gönderin.","examples":["2026-10-16T09:00:00Z"],"title":"Created At From"}},{"description":"Bitiş zamanı hariç; saat dilimli RFC 3339 gönderin.","example":"2026-10-17T09:00:00Z","in":"query","name":"created_at_to","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş zamanı hariç; saat dilimli RFC 3339 gönderin.","examples":["2026-10-17T09:00:00Z"],"title":"Created At To"}},{"description":"Başlangıç zamanı dahil; saat dilimli RFC 3339 gönderin.","example":"2026-10-16T09:00:00Z","in":"query","name":"updated_at_from","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç zamanı dahil; saat dilimli RFC 3339 gönderin.","examples":["2026-10-16T09:00:00Z"],"title":"Updated At From"}},{"description":"Bitiş zamanı hariç; saat dilimli RFC 3339 gönderin.","example":"2026-10-17T09:00:00Z","in":"query","name":"updated_at_to","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş zamanı hariç; saat dilimli RFC 3339 gönderin.","examples":["2026-10-17T09:00:00Z"],"title":"Updated At To"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"panel","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Order_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_date_range":{"summary":"Zaman aralığının başlangıcı bitişten sonra.","value":{"code":"invalid_date_range","detail":"Zaman aralığının başlangıcı bitişten sonra.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_date_range"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_range":{"summary":"Zaman aralığının başlangıcı bitişten önce değil.","value":{"code":"invalid_range","detail":"Zaman aralığının başlangıcı bitişten önce değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_range"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_range: Zaman aralığının başlangıcı bitişten önce değil. Başlangıç dahil, bitiş hariç olacak şekilde başlangıcı bitişten önce seçin. invalid_date_range: Zaman aralığının başlangıcı bitişten sonra. Başlangıç ve bitiş sırasını düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:read"]}],"summary":"Siparişleri listele","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id","invalid_range","invalid_date_range"],"x-include-cost":false,"x-notes":"Varsayılan sıra updated_at,id artandır; sort=-created_at en yeni siparişi önce getirir. customer=cus_... yalnız sort=-created_at ile kullanılır ve o karta bağlı siparişleri verir; başka sıra veya sort alanının atlanması 422 döner. Alt kayıtlar sipariş ayrıntısından veya alt uçlardan okunur.","x-optional-scopes":["personal_data:read","costs:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Yetkili markaların siparişlerini zaman, durum, marka ve görünen numarayla süzerek alın; ERP sipariş aktarımında kullanın.","x-read-cost":2,"x-required-scopes":["orders:read"]},"post":{"description":"Kendi sitenizden, ERP’nizden veya başka bir yazılımdan yeni satış açın; stok ve tahsilat paneldeki elle siparişle aynı kuralla işlenir. source=api olur. Tek markada store atlanabilir; çok markada zorunludur. Müşteri veya adres için personal_data:write, iç not için internal_notes:write gerekir. Birim fiyat verilmezse marka fiyatı ve kampanyası uygulanır; verilirse orders.price eylemi denetlenir (orders:write). Kupon müşteriye tanımlı olmalıdır. external_reference.id (sizin sisteminizdeki sipariş numarası) bu bağlantıda tekildir. 201 yanıtı okuma modeli, Location yeni sipariş yoludur. Satış kotaya girmez; sayaç arızası satışı durdurmaz. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_orders_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"customer":{"email":"musteri@example.com","name":"Örnek Müşteri","phone":"05000000000"},"delivery_method":"hand","external_reference":{"id":"WEB-2026-001"},"items":[{"quantity":"2","sku":"KUPA-MAVI"}],"paid":true,"payment_method":"cash"},"schema":{"$ref":"#/components/schemas/CreateOrder"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni kaydın API kökenine göre yolu.","schema":{"examples":["/v1/orders/ord_1234567890abcdef1234567890abcdef"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"duplicate_external_reference":{"summary":"Bu dış numarayla sipariş zaten açılmış.","value":{"code":"duplicate_external_reference","detail":"Bu dış numarayla sipariş zaten açılmış.","errors":[],"existing_order":"ord_1234567890abcdef1234567890abcdef","request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:duplicate_external_reference"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. duplicate_external_reference: Bu dış numarayla sipariş zaten açılmış. existing_order içindeki ord_ kimliğini kullanın; ikinci sipariş açılmadı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Sipariş oluştur","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","store_required","store_forbidden","reference_namespace_forbidden","duplicate_external_reference"],"x-include-cost":false,"x-notes":"source=api olur. Tek markada store atlanabilir; çok markada zorunludur. Müşteri veya adres için personal_data:write, iç not için internal_notes:write gerekir. Birim fiyat verilmezse marka fiyatı ve kampanyası uygulanır; verilirse orders.price eylemi denetlenir (orders:write). Kupon müşteriye tanımlı olmalıdır. external_reference.id (sizin sisteminizdeki sipariş numarası) bu bağlantıda tekildir. 201 yanıtı okuma modeli, Location yeni sipariş yoludur. Satış kotaya girmez; sayaç arızası satışı durdurmaz.","x-optional-scopes":["personal_data:read","internal_notes:read","personal_data:write","internal_notes:write"],"x-personal-data":true,"x-purpose":"Kendi sitenizden, ERP’nizden veya başka bir yazılımdan yeni satış açın; stok ve tahsilat paneldeki elle siparişle aynı kuralla işlenir.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":true,"x-scope-conditions":{"internal_notes:write":"İstekte `note` gönderirseniz gerekir.","personal_data:write":"İstekte `customer`, `shipping_address`, `billing_address`, `customer_note` gönderirseniz gerekir."}}},"/orders/{id}":{"get":{"description":"Siparişin güncel durumunu ve tutarlarını okuyun; olay geldikten sonra ERP kaydını güncellemek için kullanın. include seçilen alt kaynakların ilk 50 kaydını getirir; devamı ilgili alt uçtan okunur. Gerekli kapsamlar: orders:read.","operationId":"order_orders__id__get","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Virgülle ayrılmış genişletmeler: lines,payments,shipments,returns. Alt kaynakların kapsamları da gerekir.","example":"lines","in":"query","name":"include","required":false,"schema":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"description":"Virgülle ayrılmış genişletmeler: lines,payments,shipments,returns. Alt kaynakların kapsamları da gerekir.","examples":["lines"],"title":"Include"}}],"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"panel","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_include":{"summary":"Genişletme adı geçersiz veya yineleniyor.","value":{"code":"invalid_include","detail":"Genişletme adı geçersiz veya yineleniyor.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_include"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_include: Genişletme adı geçersiz veya yineleniyor. Yalnız ucun desteklediği include değerlerini birer kez gönderin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:read"]}],"summary":"Siparişi getir","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id","invalid_include"],"x-include-cost":true,"x-notes":"include seçilen alt kaynakların ilk 50 kaydını getirir; devamı ilgili alt uçtan okunur.","x-optional-scopes":["personal_data:read","costs:read","internal_notes:read","payments:read","shipments:read","returns:read"],"x-personal-data":true,"x-purpose":"Siparişin güncel durumunu ve tutarlarını okuyun; olay geldikten sonra ERP kaydını güncellemek için kullanın.","x-read-cost":1,"x-required-scopes":["orders:read"],"x-scope-conditions":{"payments:read":"include=payments gönderirseniz gerekir.","returns:read":"include=returns gönderirseniz gerekir.","shipments:read":"include=shipments gönderirseniz gerekir."}},"patch":{"description":"Siparişin adresini, notlarını, teslim gününü veya kalemlerini değiştirin. Panelin düzeltme servisi kullanılır. Verilmeyen alan korunur; delivery_day=null günü kaldırır. Durum bu uçtan değişmez. Adres/müşteri notu personal_data:write, iç not internal_notes:write ister. Kalem değiştirme, çıkarma, ekleme ve geri eklemede panelin stok/kargo/fatura kilitleri geçerlidir. Para dönen düzeltme money_out:write ve refund_confirm yanıtındaki refund_amount ile yeni tekrar anahtarı gerektirir. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"patch_orders__id__patch","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"delivery_day":"2026-10-17"},"schema":{"$ref":"#/components/schemas/PatchOrder"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"refund_confirm":{"summary":"Düzeltme müşteriye para döndürüyor; tutar teyidi gerekiyor.","value":{"code":"refund_confirm","detail":"Düzeltme müşteriye para döndürüyor; tutar teyidi gerekiyor.","errors":[],"refund_amount":"100.00","request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:refund_confirm"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin. refund_confirm: Düzeltme müşteriye para döndürüyor; tutar teyidi gerekiyor. İade tutarını kontrol edip refund_amount alanıyla ve yeni tekrar anahtarıyla gönderin; money_out:write gerekir.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"duplicate_line":{"summary":"Aynı sipariş satırı birden çok kez gönderilmiş.","value":{"code":"duplicate_line","detail":"Aynı sipariş satırı birden çok kez gönderilmiş.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:duplicate_line"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_patch":{"summary":"Düzeltilecek alan veya seçenek uygun değil.","value":{"code":"invalid_patch","detail":"Düzeltilecek alan veya seçenek uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_patch"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_patch: Düzeltilecek alan veya seçenek uygun değil. Değişmeyecek alanı atlayın; seçeneğin sipariş satırındaki ürüne ait olduğunu ve alan kurallarını kontrol edin. duplicate_line: Aynı sipariş satırı birden çok kez gönderilmiş. Her lin_ kimliğini yalnız bir kez yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Siparişi düzelt","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch","invalid_patch","duplicate_line","refund_confirm"],"x-include-cost":false,"x-notes":"Panelin düzeltme servisi kullanılır. Verilmeyen alan korunur; delivery_day=null günü kaldırır. Durum bu uçtan değişmez. Adres/müşteri notu personal_data:write, iç not internal_notes:write ister. Kalem değiştirme, çıkarma, ekleme ve geri eklemede panelin stok/kargo/fatura kilitleri geçerlidir. Para dönen düzeltme money_out:write ve refund_confirm yanıtındaki refund_amount ile yeni tekrar anahtarı gerektirir.","x-optional-scopes":["personal_data:read","internal_notes:read","personal_data:write","internal_notes:write","money_out:write"],"x-personal-data":true,"x-purpose":"Siparişin adresini, notlarını, teslim gününü veya kalemlerini değiştirin.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":false,"x-scope-conditions":{"internal_notes:write":"İstekte `note` gönderirseniz gerekir.","money_out:write":"İstekte `refund_amount` gönderirseniz gerekir.","personal_data:write":"İstekte `shipping_address`, `customer_note` gönderirseniz gerekir."}}},"/orders/{id}/cancel":{"post":{"description":"Siparişi iptal edin; stok geri gelir, ödeme ve iade paneldeki iptal kuralıyla işlenir. Panelin aynı iptal, stok iadesi ve mevcut ödeme/iade kuralını uygular. Kargoda iptal sağlayıcı sonucunu bekleyebilir; yanıtın güncel durumunu izleyin. Bağımsız iade için refunds uçlarını kullanın. Panelin mevcut iptali kart iadesi başlatıyorsa aynı davranış sürer. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"order_cancel_orders__id__cancel_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"expected_status":"confirmed","reason":"Müşteriyle görüşüldü."},"schema":{"$ref":"#/components/schemas/OrderAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"cancelled","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Siparişi iptal et","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch"],"x-include-cost":false,"x-notes":"Panelin aynı iptal, stok iadesi ve mevcut ödeme/iade kuralını uygular. Kargoda iptal sağlayıcı sonucunu bekleyebilir; yanıtın güncel durumunu izleyin. Bağımsız iade için refunds uçlarını kullanın. Panelin mevcut iptali kart iadesi başlatıyorsa aynı davranış sürer.","x-optional-scopes":["personal_data:read","internal_notes:read","money_out:write"],"x-personal-data":true,"x-purpose":"Siparişi iptal edin; stok geri gelir, ödeme ve iade paneldeki iptal kuralıyla işlenir.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":false,"x-scope-conditions":{"money_out:write":"İptal müşteriye yerel para iadesi doğuruyorsa (ör. alınmış nakit veya havale ödemesi) gerekir."}}},"/orders/{id}/confirm":{"post":{"description":"Yeni (bekleyen) siparişi onaylandı durumuna geçirin. Mevcut onay kuralı uygulanır. expected_status (beklediğiniz güncel durum) verilirse güncel durumla uyuşmalıdır. Ödeme alındı kaydı oluşturmaz; bunun için payment-received kullanılır. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"order_confirm_orders__id__confirm_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"expected_status":"pending","reason":"Müşteriyle görüşüldü."},"schema":{"$ref":"#/components/schemas/OrderAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Siparişi onayla","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch"],"x-include-cost":false,"x-notes":"Mevcut onay kuralı uygulanır. expected_status (beklediğiniz güncel durum) verilirse güncel durumla uyuşmalıdır. Ödeme alındı kaydı oluşturmaz; bunun için payment-received kullanılır.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Yeni (bekleyen) siparişi onaylandı durumuna geçirin.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":false}},"/orders/{id}/correct-status":{"post":{"description":"Yanlışlıkla seçilmiş sipariş durumunu gerekçe yazarak düzeltin. Panelin gerekçeli durum düzeltmesini uygular; reason zorunludur. Olağan ilerletme için ilgili eylem ucunu kullanın. Stok, ödeme ve kargo kısıtları panelle aynıdır; refunded hedefi desteklenmez. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"order_correct_status_orders__id__correct_status_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"expected_status":"processing","reason":"Hazırlanıyor yanlışlıkla seçildi.","status":"confirmed"},"schema":{"$ref":"#/components/schemas/CorrectOrderStatus"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Sipariş durumunu düzelt","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch"],"x-include-cost":false,"x-notes":"Panelin gerekçeli durum düzeltmesini uygular; reason zorunludur. Olağan ilerletme için ilgili eylem ucunu kullanın. Stok, ödeme ve kargo kısıtları panelle aynıdır; refunded hedefi desteklenmez.","x-optional-scopes":["personal_data:read","internal_notes:read","money_out:write"],"x-personal-data":true,"x-purpose":"Yanlışlıkla seçilmiş sipariş durumunu gerekçe yazarak düzeltin.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":false,"x-scope-conditions":{"money_out:write":"Düzeltme müşteriye yerel para iadesi doğuruyorsa gerekir."}}},"/orders/{id}/deliver":{"post":{"description":"Elden, markadan veya kargoyla teslim edilen siparişi teslim edildi durumuna geçirin. Panelde teslim edilebilen sipariş için geçerlidir. Kalan ödeme varsa collection_method gerekir; later yalnız markanın mevcut kuralı izin veriyorsa borcu açık bırakır. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"order_deliver_orders__id__deliver_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"expected_status":"confirmed","reason":"Müşteriyle görüşüldü."},"schema":{"$ref":"#/components/schemas/DeliverOrder"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"delivered","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Siparişi teslim et","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch"],"x-include-cost":false,"x-notes":"Panelde teslim edilebilen sipariş için geçerlidir. Kalan ödeme varsa collection_method gerekir; later yalnız markanın mevcut kuralı izin veriyorsa borcu açık bırakır.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Elden, markadan veya kargoyla teslim edilen siparişi teslim edildi durumuna geçirin.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":false}},"/orders/{id}/history":{"get":{"description":"Siparişin durum geçişlerini sırasıyla okuyun; işlem sırasını açıklamak için kullanın. Kişi kimlikleri yayımlanmaz. Gerekli kapsamlar: orders:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"history_orders__id__history_get","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"actor_type":"user","created_at":"2026-10-16T09:00:00Z","previous_status":"pending","status":"confirmed","type":"order.status_changed"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_History_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:read"]}],"summary":"Sipariş geçmişini getir","tags":["Siparişler"],"x-data-class":"history","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Kişi kimlikleri yayımlanmaz.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Siparişin durum geçişlerini sırasıyla okuyun; işlem sırasını açıklamak için kullanın.","x-read-cost":2,"x-required-scopes":["orders:read"]}},"/orders/{id}/invoices":{"get":{"description":"Bir siparişin fatura kayıtlarını ve durumlarını alın; ERP fatura mutabakatında kullanın. Alıcı ve fatura numarası kişisel veri kapsamıyla açılır. Gerekli kapsamlar: orders:read, invoices:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"invoices_orders__id__invoices_get","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"cancelled_at":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"inv_1234567890abcdef1234567890abcdef","issued_at":"2026-10-16T09:00:00Z","kind":"e_arsiv","status":"issued","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Invoice_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:read","invoices:read"]}],"summary":"Siparişin faturalarını listele","tags":["Fatura"],"x-data-class":"invoices","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_if_match","revision_mismatch","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Alıcı ve fatura numarası kişisel veri kapsamıyla açılır.","x-optional-scopes":["personal_data:read"],"x-personal-data":true,"x-purpose":"Bir siparişin fatura kayıtlarını ve durumlarını alın; ERP fatura mutabakatında kullanın.","x-read-cost":2,"x-required-scopes":["orders:read","invoices:read"]},"post":{"description":"Bağlı fatura sağlayıcınızla siparişin e-Arşiv veya e-Fatura belgesini kesin. Panelin aynı doğrulamasıyla kalıcı fatura isteği oluşturur; 202 ve pending döner. Location ile izleyin. If-Match siparişin ETag değeridir. Alıcıyı değiştirmek için önce sipariş düzeltme ucunu, orders:write ve personal_data:write kapsamlarıyla kullanın. Aynı anahtar tekrarında aynı fatura okunur; başka anahtarla ikinci etkin fatura açılamaz. Sağlayıcı yanıtı belirsizse aynı kayıt ve ETTN üzerinden sorgulanır. Gerekli kapsamlar: invoices:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"issue_orders__id__invoices_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/InvoiceInput"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"cancelled_at":null,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"inv_1234567890abcdef1234567890abcdef","issued_at":"2026-10-16T09:00:00Z","kind":"e_arsiv","status":"pending","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Invoice"}}},"description":"Fatura işlemi kuyruğa alındı; Location ile izleyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Faturayı izleme yolu.","schema":{"examples":["/v1/invoices/inv_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"invoice_seller_invalid":{"summary":"İşletmenin vergi bilgileri eksik.","value":{"code":"invoice_seller_invalid","detail":"İşletmenin vergi bilgileri eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invoice_seller_invalid"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invoice_seller_invalid: İşletmenin vergi bilgileri eksik. İşletme bilgilerini tamamlayın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"invoice_already_cancelled":{"summary":"Fatura zaten iptal edilmiş.","value":{"code":"invoice_already_cancelled","detail":"Fatura zaten iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_already_cancelled"}},"invoice_billing_invalid":{"summary":"Siparişin fatura bilgileri uygun değil.","value":{"code":"invoice_billing_invalid","detail":"Siparişin fatura bilgileri uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_billing_invalid"}},"invoice_cancel_running":{"summary":"Fatura iptali sürüyor.","value":{"code":"invoice_cancel_running","detail":"Fatura iptali sürüyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_cancel_running"}},"invoice_cancel_uncertain":{"summary":"Fatura iptalinin sonucu belirsiz.","value":{"code":"invoice_cancel_uncertain","detail":"Fatura iptalinin sonucu belirsiz.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_cancel_uncertain"}},"invoice_connection_changed":{"summary":"Fatura sağlayıcı bağlantısı değişti.","value":{"code":"invoice_connection_changed","detail":"Fatura sağlayıcı bağlantısı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_connection_changed"}},"invoice_empty_order":{"summary":"Siparişte ürün yok; fatura kesilemez.","value":{"code":"invoice_empty_order","detail":"Siparişte ürün yok; fatura kesilemez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_empty_order"}},"invoice_exists":{"summary":"Siparişin etkin faturası var.","value":{"code":"invoice_exists","detail":"Siparişin etkin faturası var.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_exists"}},"invoice_not_allowed":{"summary":"Fatura işlemi şu an yapılamıyor.","value":{"code":"invoice_not_allowed","detail":"Fatura işlemi şu an yapılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_allowed"}},"invoice_not_connected":{"summary":"Fatura sağlayıcısı bağlı değil.","value":{"code":"invoice_not_connected","detail":"Fatura sağlayıcısı bağlı değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_connected"}},"invoice_not_ready":{"summary":"Fatura belgesi henüz hazır değil.","value":{"code":"invoice_not_ready","detail":"Fatura belgesi henüz hazır değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_ready"}},"invoice_order_not_allowed":{"summary":"Bu siparişe fatura kesilemez.","value":{"code":"invoice_order_not_allowed","detail":"Bu siparişe fatura kesilemez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_order_not_allowed"}},"invoice_payment_required":{"summary":"Ödeme gelince fatura kesilebilir.","value":{"code":"invoice_payment_required","detail":"Ödeme gelince fatura kesilebilir.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_payment_required"}},"invoice_portal_required":{"summary":"Sağlayıcı portalından iptal gerekiyor.","value":{"code":"invoice_portal_required","detail":"Sağlayıcı portalından iptal gerekiyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_portal_required"}},"invoice_provider_auth":{"summary":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","value":{"code":"invoice_provider_auth","detail":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_provider_auth"}},"invoice_provider_error":{"summary":"Fatura sağlayıcısı işlemi tamamlayamadı.","value":{"code":"invoice_provider_error","detail":"Fatura sağlayıcısı işlemi tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_provider_error"}},"invoice_zero_total":{"summary":"Sipariş tutarı 0 TL; fatura kesilmez.","value":{"code":"invoice_zero_total","detail":"Sipariş tutarı 0 TL; fatura kesilmez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_zero_total"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. invoice_not_connected: Fatura sağlayıcısı bağlı değil. İşletme > Entegrasyonlar bölümünden sağlayıcınızı bağlayın. invoice_order_not_allowed: Bu siparişe fatura kesilemez. Siparişin iptal/iade durumunu kontrol edin. invoice_zero_total: Sipariş tutarı 0 TL; fatura kesilmez. Sipariş tutarını kontrol edin. invoice_payment_required: Ödeme gelince fatura kesilebilir. Ödeme kaydını kontrol edin. invoice_billing_invalid: Siparişin fatura bilgileri uygun değil. Paneldeki açıklamaya göre fatura bilgilerini tamamlayın. invoice_empty_order: Siparişte ürün yok; fatura kesilemez. Sipariş kalemlerini kontrol edin. invoice_exists: Siparişin etkin faturası var. Mevcut faturayı okuyun; hazırlanan fatura için yeni istek açmayın. invoice_not_allowed: Fatura işlemi şu an yapılamıyor. Açıklamadaki panel kuralını izleyin. invoice_already_cancelled: Fatura zaten iptal edilmiş. Güncel faturayı okuyun. invoice_not_ready: Fatura belgesi henüz hazır değil. Faturanın numarası kesinleşince yeniden deneyin. invoice_portal_required: Sağlayıcı portalından iptal gerekiyor. Portalda tamamladıktan sonra portal_done=true gönderin. invoice_cancel_running: Fatura iptali sürüyor. Süren çağrının bitmesini bekleyin. invoice_connection_changed: Fatura sağlayıcı bağlantısı değişti. Önceki sağlayıcı hesabında faturayı kontrol edin. invoice_cancel_uncertain: Fatura iptalinin sonucu belirsiz. Yeni dış iptal gönderilmez; portalda doğrulayıp portal_done=true ile tamamlayın. invoice_provider_auth: Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi. İşletme > Entegrasyonlar bölümünden bağlantıyı düzeltin; aynı faturayı izleyin. invoice_provider_error: Fatura sağlayıcısı işlemi tamamlayamadı. Faturanın durumunu ve sağlayıcı portalını kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["invoices:write"]}],"summary":"Fatura kes","tags":["Fatura"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","invoice_not_connected","invoice_order_not_allowed","invoice_zero_total","invoice_payment_required","invoice_billing_invalid","invoice_seller_invalid","invoice_empty_order","invoice_exists","invoice_not_allowed","invoice_already_cancelled","invoice_not_ready","invoice_portal_required","invoice_cancel_running","invoice_connection_changed","invoice_cancel_uncertain","invoice_provider_auth","invoice_provider_error","invalid_if_match","revision_mismatch","invalid_id"],"x-include-cost":false,"x-notes":"Panelin aynı doğrulamasıyla kalıcı fatura isteği oluşturur; 202 ve pending döner. Location ile izleyin. If-Match siparişin ETag değeridir. Alıcıyı değiştirmek için önce sipariş düzeltme ucunu, orders:write ve personal_data:write kapsamlarıyla kullanın. Aynı anahtar tekrarında aynı fatura okunur; başka anahtarla ikinci etkin fatura açılamaz. Sağlayıcı yanıtı belirsizse aynı kayıt ve ETTN üzerinden sorgulanır.","x-optional-scopes":["personal_data:read"],"x-personal-data":true,"x-purpose":"Bağlı fatura sağlayıcınızla siparişin e-Arşiv veya e-Fatura belgesini kesin.","x-read-cost":1,"x-required-scopes":["invoices:write"]}},"/orders/{id}/invoices/preview":{"post":{"description":"Fatura kesmeden önce alıcıyı, kalemleri, tutarı ve fatura türünü görün. Yan etkisiz POST; Idempotency-Key gerekmez. Panelin aynı alıcı, kalem ve tutar hesabını kullanır. Alıcı siparişin fatura bilgilerinden seçilir; burada kişisel alan yazılmaz. Mükellef sorgusu türü belirler; yanıt alınamazsa kind=null ve uyarı gelir. Alıcı alanları personal_data:read ile açılır. Her sorgu 10 hız puanıdır. Gerekli kapsamlar: invoices:write.","operationId":"preview_orders__id__invoices_preview_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/InvoiceInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"kind":"e_arsiv","lines":[{"discount":"0.00","name":"Örnek ürün","net":"100.00","quantity":"2","tax_amount":"20.00","tax_rate":"20","total":"120.00","unit":"adet","unit_price":"50.0000"}],"order":"ord_1234567890abcdef1234567890abcdef","tax_total":"20.00","total":"120.00","warnings":[{"code":"invoice_kind_unknown","detail":"Belge türü sağlayıcı yanıt verdiğinde kesinleşir."}]},"schema":{"$ref":"#/components/schemas/InvoicePreview"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"invoice_seller_invalid":{"summary":"İşletmenin vergi bilgileri eksik.","value":{"code":"invoice_seller_invalid","detail":"İşletmenin vergi bilgileri eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invoice_seller_invalid"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invoice_seller_invalid: İşletmenin vergi bilgileri eksik. İşletme bilgilerini tamamlayın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"invoice_already_cancelled":{"summary":"Fatura zaten iptal edilmiş.","value":{"code":"invoice_already_cancelled","detail":"Fatura zaten iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_already_cancelled"}},"invoice_billing_invalid":{"summary":"Siparişin fatura bilgileri uygun değil.","value":{"code":"invoice_billing_invalid","detail":"Siparişin fatura bilgileri uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_billing_invalid"}},"invoice_cancel_running":{"summary":"Fatura iptali sürüyor.","value":{"code":"invoice_cancel_running","detail":"Fatura iptali sürüyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_cancel_running"}},"invoice_cancel_uncertain":{"summary":"Fatura iptalinin sonucu belirsiz.","value":{"code":"invoice_cancel_uncertain","detail":"Fatura iptalinin sonucu belirsiz.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_cancel_uncertain"}},"invoice_connection_changed":{"summary":"Fatura sağlayıcı bağlantısı değişti.","value":{"code":"invoice_connection_changed","detail":"Fatura sağlayıcı bağlantısı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_connection_changed"}},"invoice_empty_order":{"summary":"Siparişte ürün yok; fatura kesilemez.","value":{"code":"invoice_empty_order","detail":"Siparişte ürün yok; fatura kesilemez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_empty_order"}},"invoice_exists":{"summary":"Siparişin etkin faturası var.","value":{"code":"invoice_exists","detail":"Siparişin etkin faturası var.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_exists"}},"invoice_not_allowed":{"summary":"Fatura işlemi şu an yapılamıyor.","value":{"code":"invoice_not_allowed","detail":"Fatura işlemi şu an yapılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_allowed"}},"invoice_not_connected":{"summary":"Fatura sağlayıcısı bağlı değil.","value":{"code":"invoice_not_connected","detail":"Fatura sağlayıcısı bağlı değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_connected"}},"invoice_not_ready":{"summary":"Fatura belgesi henüz hazır değil.","value":{"code":"invoice_not_ready","detail":"Fatura belgesi henüz hazır değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_not_ready"}},"invoice_order_not_allowed":{"summary":"Bu siparişe fatura kesilemez.","value":{"code":"invoice_order_not_allowed","detail":"Bu siparişe fatura kesilemez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_order_not_allowed"}},"invoice_payment_required":{"summary":"Ödeme gelince fatura kesilebilir.","value":{"code":"invoice_payment_required","detail":"Ödeme gelince fatura kesilebilir.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_payment_required"}},"invoice_portal_required":{"summary":"Sağlayıcı portalından iptal gerekiyor.","value":{"code":"invoice_portal_required","detail":"Sağlayıcı portalından iptal gerekiyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_portal_required"}},"invoice_provider_auth":{"summary":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","value":{"code":"invoice_provider_auth","detail":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_provider_auth"}},"invoice_provider_error":{"summary":"Fatura sağlayıcısı işlemi tamamlayamadı.","value":{"code":"invoice_provider_error","detail":"Fatura sağlayıcısı işlemi tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_provider_error"}},"invoice_zero_total":{"summary":"Sipariş tutarı 0 TL; fatura kesilmez.","value":{"code":"invoice_zero_total","detail":"Sipariş tutarı 0 TL; fatura kesilmez.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:invoice_zero_total"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invoice_not_connected: Fatura sağlayıcısı bağlı değil. İşletme > Entegrasyonlar bölümünden sağlayıcınızı bağlayın. invoice_order_not_allowed: Bu siparişe fatura kesilemez. Siparişin iptal/iade durumunu kontrol edin. invoice_zero_total: Sipariş tutarı 0 TL; fatura kesilmez. Sipariş tutarını kontrol edin. invoice_payment_required: Ödeme gelince fatura kesilebilir. Ödeme kaydını kontrol edin. invoice_billing_invalid: Siparişin fatura bilgileri uygun değil. Paneldeki açıklamaya göre fatura bilgilerini tamamlayın. invoice_empty_order: Siparişte ürün yok; fatura kesilemez. Sipariş kalemlerini kontrol edin. invoice_exists: Siparişin etkin faturası var. Mevcut faturayı okuyun; hazırlanan fatura için yeni istek açmayın. invoice_not_allowed: Fatura işlemi şu an yapılamıyor. Açıklamadaki panel kuralını izleyin. invoice_already_cancelled: Fatura zaten iptal edilmiş. Güncel faturayı okuyun. invoice_not_ready: Fatura belgesi henüz hazır değil. Faturanın numarası kesinleşince yeniden deneyin. invoice_portal_required: Sağlayıcı portalından iptal gerekiyor. Portalda tamamladıktan sonra portal_done=true gönderin. invoice_cancel_running: Fatura iptali sürüyor. Süren çağrının bitmesini bekleyin. invoice_connection_changed: Fatura sağlayıcı bağlantısı değişti. Önceki sağlayıcı hesabında faturayı kontrol edin. invoice_cancel_uncertain: Fatura iptalinin sonucu belirsiz. Yeni dış iptal gönderilmez; portalda doğrulayıp portal_done=true ile tamamlayın. invoice_provider_auth: Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi. İşletme > Entegrasyonlar bölümünden bağlantıyı düzeltin; aynı faturayı izleyin. invoice_provider_error: Fatura sağlayıcısı işlemi tamamlayamadı. Faturanın durumunu ve sağlayıcı portalını kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["invoices:write"]}],"summary":"Faturayı önizle","tags":["Fatura"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invoice_not_connected","invoice_order_not_allowed","invoice_zero_total","invoice_payment_required","invoice_billing_invalid","invoice_seller_invalid","invoice_empty_order","invoice_exists","invoice_not_allowed","invoice_already_cancelled","invoice_not_ready","invoice_portal_required","invoice_cancel_running","invoice_connection_changed","invoice_cancel_uncertain","invoice_provider_auth","invoice_provider_error","invalid_id"],"x-include-cost":false,"x-notes":"Yan etkisiz POST; Idempotency-Key gerekmez. Panelin aynı alıcı, kalem ve tutar hesabını kullanır. Alıcı siparişin fatura bilgilerinden seçilir; burada kişisel alan yazılmaz. Mükellef sorgusu türü belirler; yanıt alınamazsa kind=null ve uyarı gelir. Alıcı alanları personal_data:read ile açılır. Her sorgu 10 hız puanıdır.","x-optional-scopes":["personal_data:read"],"x-personal-data":true,"x-purpose":"Fatura kesmeden önce alıcıyı, kalemleri, tutarı ve fatura türünü görün.","x-read-cost":10,"x-required-scopes":["invoices:write"],"x-side-effect-free":true}},"/orders/{id}/lines":{"get":{"description":"Sipariş anındaki ürün, seçenek, miktar ve fiyatları alın; ERP sipariş kalemlerini oluştururken kullanın. Bu değerleri güncel ürün fiyatıyla yeniden hesaplamayın. Gerekli kapsamlar: orders:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"lines_orders__id__lines_get","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"currency":"TRY","discount":"0.00","id":"lin_1234567890abcdef1234567890abcdef","name":"Kupa","product":null,"quantity":"1.000","refunded_quantity":"0.000","tax_amount":"20.00","tax_rate":"20.00","total":"120.00","unit":"adet","unit_price":"120.00","variant":null,"variant_name":null}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Line_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:read"]}],"summary":"Sipariş satırlarını listele","tags":["Siparişler"],"x-data-class":"lines","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Bu değerleri güncel ürün fiyatıyla yeniden hesaplamayın.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Sipariş anındaki ürün, seçenek, miktar ve fiyatları alın; ERP sipariş kalemlerini oluştururken kullanın.","x-read-cost":2,"x-required-scopes":["orders:read"]}},"/orders/{id}/payment-received":{"post":{"description":"Müşteriden gerçekten aldığınız nakit, POS veya havale ödemesini siparişe yazın. Ödeme parçaları ortak tahsilat servisine yazılır. expected_due gördüğünüz kalan tutardır; değişmişse tahsilat yazılmaz. Kart çekmez, mevcut ödeme mantığını kullanır. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"order_payment_received_orders__id__payment_received_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"expected_due":"120.00","expected_status":"confirmed","parts":[{"amount":"120.00","method":"cash"}],"reason":"Müşteriyle görüşüldü."},"schema":{"$ref":"#/components/schemas/ReceiveOrderPayment"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"confirmed","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Alınan ödemeyi kaydet","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch"],"x-include-cost":false,"x-notes":"Ödeme parçaları ortak tahsilat servisine yazılır. expected_due gördüğünüz kalan tutardır; değişmişse tahsilat yazılmaz. Kart çekmez, mevcut ödeme mantığını kullanır.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Müşteriden gerçekten aldığınız nakit, POS veya havale ödemesini siparişe yazın.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":false}},"/orders/{id}/payments":{"get":{"description":"Siparişin tahsilat ve geri ödemelerini ve bütün siparişin para özetini okuyun; mutabakatta kullanın. Para özeti defterden hesaplanır. Mutabakatta summary kullanın; sayfa toplamını bütün siparişin toplamı sanmayın. Gerekli kapsamlar: orders:read, payments:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"payments_orders__id__payments_get","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"amount":"120.00","channel":"bank","created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"col_1234567890abcdef1234567890abcdef","kind":"payment","settled_at":"2026-10-16T09:00:00Z","status":"succeeded","test":false,"type":"collection"}],"has_more":false,"next_cursor":null,"summary":{"carried":"0.00","collect_due":"0.00","collected":"120.00","currency":"TRY","has_collection":true,"kept":"120.00","legacy":false,"refund_due":"0.00","reserved":"0.00","returned":"0.00","test":false}},"schema":{"$ref":"#/components/schemas/Payments"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:read","payments:read"]}],"summary":"Ödemeleri ve para özetini getir","tags":["Siparişler"],"x-data-class":"payments","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Para özeti defterden hesaplanır. Mutabakatta summary kullanın; sayfa toplamını bütün siparişin toplamı sanmayın.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Siparişin tahsilat ve geri ödemelerini ve bütün siparişin para özetini okuyun; mutabakatta kullanın.","x-read-cost":2,"x-required-scopes":["orders:read","payments:read"]}},"/orders/{id}/processing":{"post":{"description":"Onaylı siparişi hazırlanıyor durumuna geçirin. expected_status önkoşulu kilit altında denetlenir. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"order_processing_orders__id__processing_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"expected_status":"confirmed","reason":"Müşteriyle görüşüldü."},"schema":{"$ref":"#/components/schemas/OrderAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"processing","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Siparişi hazırlamaya başla","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch"],"x-include-cost":false,"x-notes":"expected_status önkoşulu kilit altında denetlenir.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Onaylı siparişi hazırlanıyor durumuna geçirin.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":false}},"/orders/{id}/ready":{"post":{"description":"Markadan teslim alınacak sipariş hazır olduğunda ve müşteriye haber verdiğinizde kullanın. Müşteriye haber verdikten sonra notified=true gönderin. Hazır bilgisi kaydedilir; sipariş durumu processing olur. Bu uç müşteriye bildirim göndermez. Gerekli kapsamlar: orders:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"order_ready_orders__id__ready_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"expected_status":"confirmed","notified":true,"reason":"Müşteriyle görüşüldü."},"schema":{"$ref":"#/components/schemas/ReadyOrder"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"channel":"whatsapp","created_at":"2026-10-16T09:00:00Z","currency":"TRY","customer":null,"delivery_day":"2026-10-17","delivery_method":"shipping","discount_total":"0.00","gift_wrap_fee":"0.00","id":"ord_1234567890abcdef1234567890abcdef","number":"48273910","payment_fee":"0.00","payment_method":"bank_transfer","payment_state":"paid","preorder_from":null,"shipping_total":"0.00","source":"api","status":"processing","store":"sto_1234567890abcdef1234567890abcdef","subtotal":"120.00","tax_status":"standard","tax_total":"20.00","total":"120.00","updated_at":"2026-10-16T10:00:00Z"},"schema":{"$ref":"#/components/schemas/Order"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Kaynağın güçlü sürüm etiketi; If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:write"]}],"summary":"Teslim almaya hazır işaretle","tags":["Siparişler"],"x-data-class":"orders","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch"],"x-include-cost":false,"x-notes":"Müşteriye haber verdikten sonra notified=true gönderin. Hazır bilgisi kaydedilir; sipariş durumu processing olur. Bu uç müşteriye bildirim göndermez.","x-optional-scopes":["personal_data:read","internal_notes:read"],"x-personal-data":true,"x-purpose":"Markadan teslim alınacak sipariş hazır olduğunda ve müşteriye haber verdiğinizde kullanın.","x-read-cost":1,"x-required-scopes":["orders:write"],"x-sale":false}},"/orders/{id}/refunds":{"post":{"description":"Ürünü geri alın ve parayı müşteriye iade edin. Panelin ortak iade servisini çalıştırır; expected_amount (önizlemede gördüğünüz tutar) ve Idempotency-Key zorunludur. Tutar değişirse 409 amount_changed ve current_amount döner. Kart iadesi aynı işçiye kaydedilir; yanıt paranın müşteriye ulaştığı anlamına gelmez. Aynı anahtarla tekrar güncel kaydı okur. payments alanı yalnız payments:read ile görünür. Değişimde refund_distribution da önizlemeden aynen gönderilir. Gerekli kapsamlar: returns:write, money_out:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_refund_orders__id__refunds_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"expected_amount":"120.00","items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1"}]},"schema":{"$ref":"#/components/schemas/CreateRefund"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"amount":"120.00","card_status":"pending","id":"ret_1234567890abcdef1234567890abcdef","items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","unit":"adet"}],"money_returned":false,"order":"ord_1234567890abcdef1234567890abcdef","remaining_amount":"120.00","restock":true},"schema":{"$ref":"#/components/schemas/RefundResult"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"amount_changed":{"summary":"İade tutarı değişti; yeniden önizleyip onaylayın.","value":{"code":"amount_changed","current_amount":"120.00","detail":"İade tutarı değişti; yeniden önizleyip onaylayın.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:amount_changed"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"refund_distribution_confirm":{"summary":"Kart ve elle ödeme dağılımı değişti.","value":{"code":"refund_distribution_confirm","detail":"Kart ve elle ödeme dağılımı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:refund_distribution_confirm"}},"return_not_requested":{"summary":"Bu kayıt bir müşteri iade talebi değil.","value":{"code":"return_not_requested","detail":"Bu kayıt bir müşteri iade talebi değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:return_not_requested"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin. amount_changed: İade tutarı değişti; yeniden önizleyip onaylayın. current_amount güncel TRY tutarıdır; önizlemeyi okuyup yeni anahtar ve expected_amount ile gönderin. return_not_requested: Bu kayıt bir müşteri iade talebi değil. Siparişin returns listesinden müşteri talebini seçin. refund_distribution_confirm: Kart ve elle ödeme dağılımı değişti. Yeniden önizleyip refund_distribution alanını aynen ve yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"duplicate_line":{"summary":"Aynı sipariş satırı birden çok kez gönderilmiş.","value":{"code":"duplicate_line","detail":"Aynı sipariş satırı birden çok kez gönderilmiş.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:duplicate_line"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. duplicate_line: Aynı sipariş satırı birden çok kez gönderilmiş. Her lin_ kimliğini yalnız bir kez yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["returns:write","money_out:write"]}],"summary":"İade başlat","tags":["İade"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch","duplicate_line","amount_changed","return_not_requested","refund_distribution_confirm"],"x-include-cost":false,"x-notes":"Panelin ortak iade servisini çalıştırır; expected_amount (önizlemede gördüğünüz tutar) ve Idempotency-Key zorunludur. Tutar değişirse 409 amount_changed ve current_amount döner. Kart iadesi aynı işçiye kaydedilir; yanıt paranın müşteriye ulaştığı anlamına gelmez. Aynı anahtarla tekrar güncel kaydı okur. payments alanı yalnız payments:read ile görünür. Değişimde refund_distribution da önizlemeden aynen gönderilir.","x-optional-scopes":["payments:read"],"x-personal-data":false,"x-purpose":"Ürünü geri alın ve parayı müşteriye iade edin.","x-read-cost":1,"x-required-scopes":["returns:write","money_out:write"]}},"/orders/{id}/refunds/preview":{"post":{"description":"İade yapmadan önce iade edilecek tutarı, stok etkisini ve uyarıları görün. Yan etkisiz panel hesabı: kalem başına uygulanacak restock, tutar, yöntem, kargo dahil bilgisi ve uyarılar. Stok seçimi belirtilmezse panel/AI varsayılanı uygulanır. Idempotency-Key gerekmez. amount değerini oluşturma isteğinde expected_amount olarak gönderin. Gerekli kapsamlar: returns:write.","operationId":"preview_orders__id__refunds_preview_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1"}]},"schema":{"$ref":"#/components/schemas/RefundInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"amount":"120.00","completes":true,"items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","restock":true,"unit":"adet"}],"order":"ord_1234567890abcdef1234567890abcdef","refund_distribution":{"card":"100.00","manual":"20.00","provider":"PayTR"},"refund_method":"iban","remaining":"120.00","shipping_included":true,"suggested_amount":"120.00","warnings":[]},"schema":{"$ref":"#/components/schemas/RefundPreview"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"insufficient_stock":{"summary":"Sipariş için yeterli stok yok.","value":{"code":"insufficient_stock","detail":"Sipariş için yeterli stok yok.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:insufficient_stock"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. insufficient_stock: Sipariş için yeterli stok yok. Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"amount_changed":{"summary":"İade tutarı değişti; yeniden önizleyip onaylayın.","value":{"code":"amount_changed","current_amount":"120.00","detail":"İade tutarı değişti; yeniden önizleyip onaylayın.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:amount_changed"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"refund_distribution_confirm":{"summary":"Kart ve elle ödeme dağılımı değişti.","value":{"code":"refund_distribution_confirm","detail":"Kart ve elle ödeme dağılımı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:refund_distribution_confirm"}},"return_not_requested":{"summary":"Bu kayıt bir müşteri iade talebi değil.","value":{"code":"return_not_requested","detail":"Bu kayıt bir müşteri iade talebi değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:return_not_requested"}},"status_mismatch":{"summary":"Sipariş durumu expected_status ile uyuşmuyor.","value":{"code":"status_mismatch","detail":"Sipariş durumu expected_status ile uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:status_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. status_mismatch: Sipariş durumu expected_status ile uyuşmuyor. Güncel durumu okuyup yeni tekrar anahtarıyla deneyin. amount_changed: İade tutarı değişti; yeniden önizleyip onaylayın. current_amount güncel TRY tutarıdır; önizlemeyi okuyup yeni anahtar ve expected_amount ile gönderin. return_not_requested: Bu kayıt bir müşteri iade talebi değil. Siparişin returns listesinden müşteri talebini seçin. refund_distribution_confirm: Kart ve elle ödeme dağılımı değişti. Yeniden önizleyip refund_distribution alanını aynen ve yeni tekrar anahtarıyla gönderin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"duplicate_line":{"summary":"Aynı sipariş satırı birden çok kez gönderilmiş.","value":{"code":"duplicate_line","detail":"Aynı sipariş satırı birden çok kez gönderilmiş.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:duplicate_line"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. duplicate_line: Aynı sipariş satırı birden çok kez gönderilmiş. Her lin_ kimliğini yalnız bir kez yazın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["returns:write"]}],"summary":"İadeyi önizle","tags":["İade"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","forbidden","conflict","insufficient_stock","invalid_id","invalid_if_match","revision_mismatch","status_mismatch","duplicate_line","amount_changed","return_not_requested","refund_distribution_confirm"],"x-include-cost":false,"x-notes":"Yan etkisiz panel hesabı: kalem başına uygulanacak restock, tutar, yöntem, kargo dahil bilgisi ve uyarılar. Stok seçimi belirtilmezse panel/AI varsayılanı uygulanır. Idempotency-Key gerekmez. amount değerini oluşturma isteğinde expected_amount olarak gönderin.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"İade yapmadan önce iade edilecek tutarı, stok etkisini ve uyarıları görün.","x-read-cost":1,"x-required-scopes":["returns:write"],"x-side-effect-free":true}},"/orders/{id}/returns":{"get":{"description":"Siparişe bağlı iade ve değişim kayıtlarını alın; ERP iade durumlarını izlerken kullanın. Kişisel açıklamalar personal_data:read gerektirir. Gerekli kapsamlar: orders:read, returns:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"returns_orders__id__returns_get","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"created_at":"2026-10-16T09:00:00Z","currency":"TRY","id":"ret_1234567890abcdef1234567890abcdef","kind":"return","refund_amount":null,"requested_at":"2026-10-16T09:00:00Z","source":"customer","status":"requested","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Return_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:read","returns:read"]}],"summary":"Siparişin iadelerini listele","tags":["İade"],"x-data-class":"returns","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Kişisel açıklamalar personal_data:read gerektirir.","x-optional-scopes":["personal_data:read"],"x-personal-data":true,"x-purpose":"Siparişe bağlı iade ve değişim kayıtlarını alın; ERP iade durumlarını izlerken kullanın.","x-read-cost":2,"x-required-scopes":["orders:read","returns:read"]}},"/orders/{id}/shipments":{"get":{"description":"Bir siparişin gönderilerini ve kapıda ödeme bilgilerini alın. Ortak gönderide ücret ve tutarlar yalnız bu siparişin payıdır. Takip bilgileri kişisel veri kapsamıyla açılır. Gerekli kapsamlar: orders:read, shipments:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"shipments_orders__id__shipments_get","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına kayıt/olay adayı sayısı; varsayılan 50, en az 1, en çok 100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıtın next_cursor değeri; çözmeyin, aynı kaynak, yetki ve süzgeçlerle aynen gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"carrier":"YURTICI","cod_amount":"120.00","collected_amount":null,"combined":true,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","delivered_at":null,"id":"shp_1234567890abcdef1234567890abcdef","shipping_fee":"0.00","state":"ready","status":"created","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Shipment_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["orders:read","shipments:read"]}],"summary":"Siparişin gönderilerini listele","tags":["Kargo"],"x-data-class":"shipments","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Ortak gönderide ücret ve tutarlar yalnız bu siparişin payıdır. Takip bilgileri kişisel veri kapsamıyla açılır.","x-optional-scopes":["personal_data:read","costs:read"],"x-personal-data":true,"x-purpose":"Bir siparişin gönderilerini ve kapıda ödeme bilgilerini alın.","x-read-cost":2,"x-required-scopes":["orders:read","shipments:read"]},"post":{"description":"Siparişi kargoya verin: seçtiğiniz firmayla BasitKargo gönderisi açılır, ücret bakiyenizden düşer. Panelin Kargoya ver işlemini kuyruğa alır. 202 ve pending döner; Location ile izleyin. Zaman aşımında aynı anahtar/gövde aynı gönderiye döner; ikinci gönderi açılmaz. Başarısız tamamlanırsa failed ve error_code gelir. If-Match siparişin ETag değeridir. Birleştirme merge_orders ile açıkça seçilir; aynı marka, alıcı, adres ve depo kuralları geçerlidir. Gerekli kapsamlar: shipments:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_orders__id__shipments_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"carrier":"YURTICI"},"schema":{"$ref":"#/components/schemas/CreateShipment"}}},"required":true},"responses":{"202":{"content":{"application/json":{"example":{"carrier":"YURTICI","cod_amount":"120.00","collected_amount":null,"combined":false,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","delivered_at":null,"id":"shp_1234567890abcdef1234567890abcdef","shipping_fee":"0.00","state":"ready","status":"pending","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Shipment"}}},"description":"Kargo işlemi kuyruğa alındı; gönderiyi Location ile izleyin.","headers":{"ETag":{"description":"Gönderinin API görünümünden hesaplanan güçlü sürüm etiketi; iptalin If-Match başlığında kullanın.","schema":{"examples":["\"123456789\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Gönderiyi izleme yolu.","schema":{"examples":["/v1/shipments/shp_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"shipping_address_invalid":{"summary":"Alıcı adresi eksik veya geçersiz.","value":{"code":"shipping_address_invalid","detail":"Alıcı adresi eksik veya geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_address_invalid"}},"shipping_balance_insufficient":{"summary":"Kargo bakiyesi yetersiz.","value":{"code":"shipping_balance_insufficient","detail":"Kargo bakiyesi yetersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_balance_insufficient"}},"shipping_carrier_disabled":{"summary":"Kargo firması kapalı veya seçilemez.","value":{"code":"shipping_carrier_disabled","detail":"Kargo firması kapalı veya seçilemez.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_carrier_disabled"}},"shipping_cod_unavailable":{"summary":"Kapıda ödeme bu hesapta veya firmada kullanılamıyor.","value":{"code":"shipping_cod_unavailable","detail":"Kapıda ödeme bu hesapta veya firmada kullanılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_cod_unavailable"}},"shipping_quote_unavailable":{"summary":"Bu paket ve ödeme yöntemi için ücret bulunamadı.","value":{"code":"shipping_quote_unavailable","detail":"Bu paket ve ödeme yöntemi için ücret bulunamadı.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_quote_unavailable"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. shipping_balance_insufficient: Kargo bakiyesi yetersiz. BasitKargo bakiyesini yükleyin; yeni tekrar anahtarıyla deneyin. shipping_address_invalid: Alıcı adresi eksik veya geçersiz. Siparişin il, ilçe, mahalle ve açık adresini düzeltin; yeni tekrar anahtarı kullanın. shipping_carrier_disabled: Kargo firması kapalı veya seçilemez. Fiyat yanıtındaki açık firma kodunu seçin. shipping_cod_unavailable: Kapıda ödeme bu hesapta veya firmada kullanılamıyor. BasitKargo kapıda ödeme ayarlarını ve siparişin ödeme yöntemini kontrol edin. shipping_quote_unavailable: Bu paket ve ödeme yöntemi için ücret bulunamadı. Koli ölçülerini ve firma seçimini kontrol edin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"shipment_not_allowed":{"summary":"Gönderinin veya siparişin durumu bu işleme uygun değil.","value":{"code":"shipment_not_allowed","detail":"Gönderinin veya siparişin durumu bu işleme uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:shipment_not_allowed"}},"shipping_not_connected":{"summary":"BasitKargo hesabı bağlı değil.","value":{"code":"shipping_not_connected","detail":"BasitKargo hesabı bağlı değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:shipping_not_connected"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. shipment_not_allowed: Gönderinin veya siparişin durumu bu işleme uygun değil. Güncel gönderiyi ve siparişi okuyun; bekleyen işlemin sonuçlanmasını izleyin. shipping_not_connected: BasitKargo hesabı bağlı değil. İşletme ayarları > Kargo’dan hesabı bağlayın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}},"shipping_rate_limited":{"summary":"Kargo sağlayıcısının istek sınırına ulaşıldı.","value":{"code":"shipping_rate_limited","detail":"Kargo sağlayıcısının istek sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:shipping_rate_limited"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın. shipping_rate_limited: Kargo sağlayıcısının istek sınırına ulaşıldı. Retry-After saniye bekleyin; gönderi açılışında aynı anahtarı koruyun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}},"shipping_unavailable":{"summary":"Kargo hizmetine şu an ulaşılamıyor.","value":{"code":"shipping_unavailable","detail":"Kargo hizmetine şu an ulaşılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:shipping_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin. shipping_unavailable: Kargo hizmetine şu an ulaşılamıyor. Retry-After saniye bekleyin; aynı anahtar/gövdeyle tekrar edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["shipments:write"]}],"summary":"Gönderi oluştur","tags":["Kargo"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","shipment_not_allowed","shipping_balance_insufficient","shipping_address_invalid","shipping_carrier_disabled","shipping_cod_unavailable","shipping_quote_unavailable","shipping_not_connected","shipping_rate_limited","shipping_unavailable","invalid_if_match","revision_mismatch","invalid_id"],"x-include-cost":false,"x-notes":"Panelin Kargoya ver işlemini kuyruğa alır. 202 ve pending döner; Location ile izleyin. Zaman aşımında aynı anahtar/gövde aynı gönderiye döner; ikinci gönderi açılmaz. Başarısız tamamlanırsa failed ve error_code gelir. If-Match siparişin ETag değeridir. Birleştirme merge_orders ile açıkça seçilir; aynı marka, alıcı, adres ve depo kuralları geçerlidir.","x-optional-scopes":["personal_data:read","costs:read"],"x-personal-data":true,"x-purpose":"Siparişi kargoya verin: seçtiğiniz firmayla BasitKargo gönderisi açılır, ücret bakiyenizden düşer.","x-read-cost":10,"x-required-scopes":["shipments:write"]}},"/orders/{id}/shipments/quote":{"post":{"description":"Gönderi açmadan önce açık kargo firmalarının fiyatını ve gönderim engellerini görün. Yan etkisiz POST: Idempotency-Key gerekmez; bakiye düşmez, sipariş ve koli bilgileri değişmez. Her sorgu 10 hız sınırı puanı tüketir; ayrıca işletmenin bütün bağlantı ve markaları için ortak 60 saniyede 20 fiyat sorgusu sınırı vardır. Aşımda 429 quote_rate_limited ve Retry-After saniye gelir. Gönderi açma bu sayacı tüketmez. Bakiye en çok 60 saniyelik önbellekten okunur; açılışta taze denetlenir. Kapıda ödeme ve kapora siparişten hesaplanır. Gerekli kapsamlar: shipments:write.","operationId":"quote_orders__id__shipments_quote_post","parameters":[{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","example":"ord_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ord_ önekli dış kimliği.","examples":["ord_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/QuoteInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"boxes":[{"depth":20,"height":20,"weight":1,"width":20}],"carriers":[{"available":true,"cod_fee":"29.90","code":"YURTICI","detail":null,"fee":"124.80","name":"Yurtiçi Kargo","note":null,"problem_code":null}],"cod_amount":"120.00","cod_type":"cash","default_carrier":"YURTICI","order":"ord_1234567890abcdef1234567890abcdef","package_version":"0123456789abcdef","package_warning":null,"payment_warning":null},"schema":{"$ref":"#/components/schemas/ShipmentQuote"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"shipping_address_invalid":{"summary":"Alıcı adresi eksik veya geçersiz.","value":{"code":"shipping_address_invalid","detail":"Alıcı adresi eksik veya geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_address_invalid"}},"shipping_balance_insufficient":{"summary":"Kargo bakiyesi yetersiz.","value":{"code":"shipping_balance_insufficient","detail":"Kargo bakiyesi yetersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_balance_insufficient"}},"shipping_carrier_disabled":{"summary":"Kargo firması kapalı veya seçilemez.","value":{"code":"shipping_carrier_disabled","detail":"Kargo firması kapalı veya seçilemez.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_carrier_disabled"}},"shipping_cod_unavailable":{"summary":"Kapıda ödeme bu hesapta veya firmada kullanılamıyor.","value":{"code":"shipping_cod_unavailable","detail":"Kapıda ödeme bu hesapta veya firmada kullanılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_cod_unavailable"}},"shipping_quote_unavailable":{"summary":"Bu paket ve ödeme yöntemi için ücret bulunamadı.","value":{"code":"shipping_quote_unavailable","detail":"Bu paket ve ödeme yöntemi için ücret bulunamadı.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_quote_unavailable"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. shipping_balance_insufficient: Kargo bakiyesi yetersiz. BasitKargo bakiyesini yükleyin; yeni tekrar anahtarıyla deneyin. shipping_address_invalid: Alıcı adresi eksik veya geçersiz. Siparişin il, ilçe, mahalle ve açık adresini düzeltin; yeni tekrar anahtarı kullanın. shipping_carrier_disabled: Kargo firması kapalı veya seçilemez. Fiyat yanıtındaki açık firma kodunu seçin. shipping_cod_unavailable: Kapıda ödeme bu hesapta veya firmada kullanılamıyor. BasitKargo kapıda ödeme ayarlarını ve siparişin ödeme yöntemini kontrol edin. shipping_quote_unavailable: Bu paket ve ödeme yöntemi için ücret bulunamadı. Koli ölçülerini ve firma seçimini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"shipment_not_allowed":{"summary":"Gönderinin veya siparişin durumu bu işleme uygun değil.","value":{"code":"shipment_not_allowed","detail":"Gönderinin veya siparişin durumu bu işleme uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:shipment_not_allowed"}},"shipping_not_connected":{"summary":"BasitKargo hesabı bağlı değil.","value":{"code":"shipping_not_connected","detail":"BasitKargo hesabı bağlı değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:shipping_not_connected"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"shipment_not_allowed: Gönderinin veya siparişin durumu bu işleme uygun değil. Güncel gönderiyi ve siparişi okuyun; bekleyen işlemin sonuçlanmasını izleyin. shipping_not_connected: BasitKargo hesabı bağlı değil. İşletme ayarları > Kargo’dan hesabı bağlayın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"quote_rate_limited":{"summary":"İşletmenin kargo fiyatı sorgulama sınırına ulaşıldı.","value":{"code":"quote_rate_limited","detail":"İşletmenin kargo fiyatı sorgulama sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:quote_rate_limited"}},"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}},"shipping_rate_limited":{"summary":"Kargo sağlayıcısının istek sınırına ulaşıldı.","value":{"code":"shipping_rate_limited","detail":"Kargo sağlayıcısının istek sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:shipping_rate_limited"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın. shipping_rate_limited: Kargo sağlayıcısının istek sınırına ulaşıldı. Retry-After saniye bekleyin; gönderi açılışında aynı anahtarı koruyun. quote_rate_limited: İşletmenin kargo fiyatı sorgulama sınırına ulaşıldı. Retry-After saniye bekleyin; 60 saniyede 20 sorgu bütün bağlantı ve markalarda ortaktır. Gönderi açma bu sayaçtan etkilenmez.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}},"shipping_unavailable":{"summary":"Kargo hizmetine şu an ulaşılamıyor.","value":{"code":"shipping_unavailable","detail":"Kargo hizmetine şu an ulaşılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:shipping_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin. shipping_unavailable: Kargo hizmetine şu an ulaşılamıyor. Retry-After saniye bekleyin; aynı anahtar/gövdeyle tekrar edin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["shipments:write"]}],"summary":"Kargo fiyatı sor","tags":["Kargo"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","forbidden","shipment_not_allowed","shipping_balance_insufficient","shipping_address_invalid","shipping_carrier_disabled","shipping_cod_unavailable","shipping_quote_unavailable","shipping_not_connected","shipping_rate_limited","shipping_unavailable","quote_rate_limited","invalid_id"],"x-include-cost":false,"x-notes":"Yan etkisiz POST: Idempotency-Key gerekmez; bakiye düşmez, sipariş ve koli bilgileri değişmez. Her sorgu 10 hız sınırı puanı tüketir; ayrıca işletmenin bütün bağlantı ve markaları için ortak 60 saniyede 20 fiyat sorgusu sınırı vardır. Aşımda 429 quote_rate_limited ve Retry-After saniye gelir. Gönderi açma bu sayacı tüketmez. Bakiye en çok 60 saniyelik önbellekten okunur; açılışta taze denetlenir. Kapıda ödeme ve kapora siparişten hesaplanır.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Gönderi açmadan önce açık kargo firmalarının fiyatını ve gönderim engellerini görün.","x-read-cost":10,"x-required-scopes":["shipments:write"],"x-side-effect-free":true}},"/products":{"get":{"description":"Görünür ürünleri ve istenirse seçeneklerini, kategorilerini ve marka fiyatlarını alın; katalog aktarımı ve ürün kimliği eşleştirmesi için kullanın. Kalıcı eşitlemeye dışa aktarma ile başlayın. Gerekli kapsamlar: products:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"products_products_get","parameters":[{"description":"Virgülle ayrılmış genişletmeler: variants,categories,store_prices. Alt kaynakların kapsamları da gerekir.","example":"variants","in":"query","name":"include","required":false,"schema":{"default":"","description":"Virgülle ayrılmış genişletmeler: variants,categories,store_prices. Alt kaynakların kapsamları da gerekir.","examples":["variants"],"maxLength":100,"title":"Include","type":"string"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","example":"sto_1234567890abcdef1234567890abcdef","in":"query","name":"store","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"}},{"description":"Durum eşitlik süzgeci; desteklenen değerler şemada listelenir.","example":"active","in":"query","name":"status","required":false,"schema":{"anyOf":[{"enum":["active","draft","inactive"],"type":"string"},{"type":"null"}],"description":"Durum eşitlik süzgeci; desteklenen değerler şemada listelenir.","examples":["active"],"title":"Status"}},{"description":"Başlangıç dahil; saat dilimli RFC 3339 zamanı.","example":"2026-10-16T09:00:00Z","in":"query","name":"updated_after","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Başlangıç dahil; saat dilimli RFC 3339 zamanı.","examples":["2026-10-16T09:00:00Z"],"title":"Updated After"}},{"description":"Bitiş hariç; saat dilimli RFC 3339 zamanı.","example":"2026-10-17T09:00:00Z","in":"query","name":"updated_before","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Bitiş hariç; saat dilimli RFC 3339 zamanı.","examples":["2026-10-17T09:00:00Z"],"title":"Updated Before"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"archived":false,"brand":"brd_1234567890abcdef1234567890abcdef","code":"KUPA-001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","description":"Seramik kupa, 300 ml.","id":"prd_1234567890abcdef1234567890abcdef","images":["https://example.com/kupa.jpg"],"kind":"standard","made_to_order":false,"maximum_quantity":"100.000","minimum_quantity":"1.000","name":"Seramik Kupa","pool_unit":"adet","preparation":"3 iş günü","price":"120.00","quantity_step":"1.000","short_description":"Seramik kupa","slug":"ornek-kupa","status":"active","tax_rate":"20.00","tax_status":"standard","unit":"adet","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Product_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_date_range":{"summary":"Zaman aralığının başlangıcı bitişten sonra.","value":{"code":"invalid_date_range","detail":"Zaman aralığının başlangıcı bitişten sonra.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_date_range"}},"invalid_datetime":{"summary":"Zamanın saat dilimi eksik.","value":{"code":"invalid_datetime","detail":"Zamanın saat dilimi eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_datetime"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_include":{"summary":"Genişletme adı geçersiz veya yineleniyor.","value":{"code":"invalid_include","detail":"Genişletme adı geçersiz veya yineleniyor.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_include"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_include: Genişletme adı geçersiz veya yineleniyor. Yalnız ucun desteklediği include değerlerini birer kez gönderin. invalid_datetime: Zamanın saat dilimi eksik. RFC 3339 değere Z veya +03:00 gibi saat dilimi ekleyin. invalid_date_range: Zaman aralığının başlangıcı bitişten sonra. Başlangıç ve bitiş sırasını düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Ürünleri listele","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id","invalid_include","invalid_datetime","invalid_date_range"],"x-include-cost":true,"x-notes":"Kalıcı eşitlemeye dışa aktarma ile başlayın.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Görünür ürünleri ve istenirse seçeneklerini, kategorilerini ve marka fiyatlarını alın; katalog aktarımı ve ürün kimliği eşleştirmesi için kullanın.","x-read-cost":2,"x-required-scopes":["products:read"]},"post":{"description":"Ürünü seçenekleri, kategorileri ve ürün markasıyla birlikte tek istekte açın. Panelin tek kayıt servisi kullanılır. Tek markada store atlanabilir; çok markada store veya stores seçilir. costs:write maliyet, inventory:write açılış stoğu içindir. Görsel URL’leri mevcut güvenli kopyalama kuyruğuna girer. external_reference bu bağlantıda tekildir. Yanıt ürün, seçenekler, kategoriler, marka fiyatları, ETag ve Location içerir. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_products_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"name":"Seramik Kupa","price":"120.00","sku":"KUPA-001"},"schema":{"$ref":"#/components/schemas/CreateProduct"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"archived":false,"brand":"brd_1234567890abcdef1234567890abcdef","code":"KUPA-001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","description":"Seramik kupa, 300 ml.","id":"prd_1234567890abcdef1234567890abcdef","images":["https://example.com/kupa.jpg"],"kind":"standard","made_to_order":false,"maximum_quantity":"100.000","minimum_quantity":"1.000","name":"Seramik Kupa","pool_unit":"adet","preparation":"3 iş günü","price":"120.00","quantity_step":"1.000","short_description":"Seramik kupa","slug":"ornek-kupa","status":"active","tax_rate":"20.00","tax_status":"standard","unit":"adet","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Product"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni kaydın API kökenine göre yolu.","schema":{"examples":["/v1/products/prd_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"code_taken":{"summary":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","value":{"code":"code_taken","detail":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:code_taken"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. code_taken: Stok kodu veya barkod başka bir kayıtta kullanılıyor. Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Ürün oluştur","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","code_taken","invalid_if_match","revision_mismatch","store_required","store_forbidden","reference_namespace_forbidden","external_reference_conflict"],"x-include-cost":false,"x-notes":"Panelin tek kayıt servisi kullanılır. Tek markada store atlanabilir; çok markada store veya stores seçilir. costs:write maliyet, inventory:write açılış stoğu içindir. Görsel URL’leri mevcut güvenli kopyalama kuyruğuna girer. external_reference bu bağlantıda tekildir. Yanıt ürün, seçenekler, kategoriler, marka fiyatları, ETag ve Location içerir.","x-optional-scopes":["costs:read","costs:write","inventory:write"],"x-personal-data":false,"x-purpose":"Ürünü seçenekleri, kategorileri ve ürün markasıyla birlikte tek istekte açın.","x-read-cost":1,"x-required-scopes":["products:write"],"x-scope-conditions":{"costs:write":"İstekte `cost`, `variants[].cost` gönderirseniz gerekir.","inventory:write":"İstekte `variants[].opening_stock`, `opening_stock` gönderirseniz gerekir."}}},"/products/{id}":{"get":{"description":"Bir ürünün güncel bilgilerini okuyun; ürün olayından sonra kendi kataloğunuzu güncellerken kullanın. Maliyet yalnız costs:read ile görünür. Gerekli kapsamlar: products:read.","operationId":"product_products__id__get","parameters":[{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","example":"prd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Virgülle ayrılmış genişletmeler: variants,categories,store_prices. Alt kaynakların kapsamları da gerekir.","example":"variants","in":"query","name":"include","required":false,"schema":{"default":"","description":"Virgülle ayrılmış genişletmeler: variants,categories,store_prices. Alt kaynakların kapsamları da gerekir.","examples":["variants"],"maxLength":100,"title":"Include","type":"string"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"brand":"brd_1234567890abcdef1234567890abcdef","code":"KUPA-001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","description":"Seramik kupa, 300 ml.","id":"prd_1234567890abcdef1234567890abcdef","images":["https://example.com/kupa.jpg"],"kind":"standard","made_to_order":false,"maximum_quantity":"100.000","minimum_quantity":"1.000","name":"Seramik Kupa","pool_unit":"adet","preparation":"3 iş günü","price":"120.00","quantity_step":"1.000","short_description":"Seramik kupa","slug":"ornek-kupa","status":"active","tax_rate":"20.00","tax_status":"standard","unit":"adet","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Product"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_include":{"summary":"Genişletme adı geçersiz veya yineleniyor.","value":{"code":"invalid_include","detail":"Genişletme adı geçersiz veya yineleniyor.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_include"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_include: Genişletme adı geçersiz veya yineleniyor. Yalnız ucun desteklediği include değerlerini birer kez gönderin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Ürünü getir","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id","invalid_include"],"x-include-cost":true,"x-notes":"Maliyet yalnız costs:read ile görünür.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Bir ürünün güncel bilgilerini okuyun; ürün olayından sonra kendi kataloğunuzu güncellerken kullanın.","x-read-cost":1,"x-required-scopes":["products:read"]},"patch":{"description":"Ürünün adını, fiyatını, açıklamasını, kategorilerini veya satış durumunu değiştirin. Yalnız gönderilen alanlar panelin kayıt servisiyle değişir. If-Match ürün, seçenek ve marka fiyatı değişikliklerini kapsar; stok miktarı ürünün içerik ETag’ini değiştirmez. Fiyat geçmişi, kanal kuyrukları ve vitrin önbelleği panelle aynı yoldan güncellenir. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"patch_products__id__patch","parameters":[{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","example":"prd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"0123456789abcdef\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"0123456789abcdef\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"price":"140.00"},"schema":{"$ref":"#/components/schemas/PatchProduct"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"brand":"brd_1234567890abcdef1234567890abcdef","code":"KUPA-001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","description":"Seramik kupa, 300 ml.","id":"prd_1234567890abcdef1234567890abcdef","images":["https://example.com/kupa.jpg"],"kind":"standard","made_to_order":false,"maximum_quantity":"100.000","minimum_quantity":"1.000","name":"Seramik Kupa","pool_unit":"adet","preparation":"3 iş günü","price":"120.00","quantity_step":"1.000","short_description":"Seramik kupa","slug":"ornek-kupa","status":"active","tax_rate":"20.00","tax_status":"standard","unit":"adet","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Product"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"code_taken":{"summary":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","value":{"code":"code_taken","detail":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:code_taken"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. code_taken: Stok kodu veya barkod başka bir kayıtta kullanılıyor. Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Ürünü güncelle","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","code_taken","invalid_if_match","revision_mismatch","store_required","store_forbidden","reference_namespace_forbidden","external_reference_conflict"],"x-include-cost":false,"x-notes":"Yalnız gönderilen alanlar panelin kayıt servisiyle değişir. If-Match ürün, seçenek ve marka fiyatı değişikliklerini kapsar; stok miktarı ürünün içerik ETag’ini değiştirmez. Fiyat geçmişi, kanal kuyrukları ve vitrin önbelleği panelle aynı yoldan güncellenir.","x-optional-scopes":["costs:read","costs:write"],"x-personal-data":false,"x-purpose":"Ürünün adını, fiyatını, açıklamasını, kategorilerini veya satış durumunu değiştirin.","x-read-cost":1,"x-required-scopes":["products:write"],"x-scope-conditions":{"costs:write":"İstekte `cost` gönderirseniz gerekir."}}},"/products/{id}/archive":{"post":{"description":"Ürünü listeden ve vitrinden kaldırın; kayıtları silinmez. Boş JSON gönderin; archive:write gerekir. Panelin açık sipariş ve iade engeli uygulanır; kayıtlar korunur. Stok panelin sayım yoluyla sıfırlanır. Gerekli kapsamlar: archive:write, products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"product_archive_products__id__archive_post","parameters":[{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","example":"prd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"0123456789abcdef\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"0123456789abcdef\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CatalogAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"brand":"brd_1234567890abcdef1234567890abcdef","code":"KUPA-001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","description":"Seramik kupa, 300 ml.","id":"prd_1234567890abcdef1234567890abcdef","images":["https://example.com/kupa.jpg"],"kind":"standard","made_to_order":false,"maximum_quantity":"100.000","minimum_quantity":"1.000","name":"Seramik Kupa","pool_unit":"adet","preparation":"3 iş günü","price":"120.00","quantity_step":"1.000","short_description":"Seramik kupa","slug":"ornek-kupa","status":"active","tax_rate":"20.00","tax_status":"standard","unit":"adet","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Product"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"code_taken":{"summary":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","value":{"code":"code_taken","detail":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:code_taken"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. code_taken: Stok kodu veya barkod başka bir kayıtta kullanılıyor. Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","products:write"]}],"summary":"Ürünü arşivle","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","code_taken","invalid_if_match","revision_mismatch","store_required","store_forbidden","reference_namespace_forbidden","external_reference_conflict"],"x-include-cost":false,"x-notes":"Boş JSON gönderin; archive:write gerekir. Panelin açık sipariş ve iade engeli uygulanır; kayıtlar korunur. Stok panelin sayım yoluyla sıfırlanır.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Ürünü listeden ve vitrinden kaldırın; kayıtları silinmez.","x-read-cost":1,"x-required-scopes":["archive:write","products:write"]}},"/products/{id}/restore":{"post":{"description":"Arşivdeki ürünü ve arşivlenen seçeneklerini geri getirin. Panelin arşiv servisi kullanılır; önceki stok defterden döner. Önceden satışta olan ürün draft döner; diğer satış durumları korunur. Kod çakışması geri getirmeyi engeller; archive:write gerekir. Gerekli kapsamlar: archive:write, products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"product_restore_products__id__restore_post","parameters":[{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","example":"prd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"0123456789abcdef\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"0123456789abcdef\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CatalogAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"brand":"brd_1234567890abcdef1234567890abcdef","code":"KUPA-001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","description":"Seramik kupa, 300 ml.","id":"prd_1234567890abcdef1234567890abcdef","images":["https://example.com/kupa.jpg"],"kind":"standard","made_to_order":false,"maximum_quantity":"100.000","minimum_quantity":"1.000","name":"Seramik Kupa","pool_unit":"adet","preparation":"3 iş günü","price":"120.00","quantity_step":"1.000","short_description":"Seramik kupa","slug":"ornek-kupa","status":"active","tax_rate":"20.00","tax_status":"standard","unit":"adet","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Product"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"code_taken":{"summary":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","value":{"code":"code_taken","detail":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:code_taken"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"product_restore_conflict":{"summary":"Ürün geri getirilemedi.","value":{"code":"product_restore_conflict","detail":"Ürün geri getirilemedi.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:product_restore_conflict"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. code_taken: Stok kodu veya barkod başka bir kayıtta kullanılıyor. Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın. product_restore_conflict: Ürün geri getirilemedi. Arşiv durumunu ve stok kodu/barkod çakışmasını panelden kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","products:write"]}],"summary":"Ürünü geri getir","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","code_taken","invalid_if_match","revision_mismatch","store_required","store_forbidden","reference_namespace_forbidden","external_reference_conflict","product_restore_conflict"],"x-include-cost":false,"x-notes":"Panelin arşiv servisi kullanılır; önceki stok defterden döner. Önceden satışta olan ürün draft döner; diğer satış durumları korunur. Kod çakışması geri getirmeyi engeller; archive:write gerekir.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Arşivdeki ürünü ve arşivlenen seçeneklerini geri getirin.","x-read-cost":1,"x-required-scopes":["archive:write","products:write"]}},"/products/{id}/variants":{"post":{"description":"Var olan ürüne renk, beden gibi yeni bir seçenek ekleyin. Panelin seçenek ekleme yoludur. İlk seçenek varsayılanın kimliğini, stok ve sipariş bağlarını korur; açık sipariş olması bu dönüşümü engellemez. Set içindeki varsayılan seçeneğe dönüşüm reddedilir. opening_stock mevcut stoğu değiştiriyorsa expected_stock gerekir. If-Match ürünün API görünümünden hesaplanan içerik ETag’idir. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"add_variant_products__id__variants_post","parameters":[{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","example":"prd_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın prd_ önekli dış kimliği.","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"0123456789abcdef\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"0123456789abcdef\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"price_rule":{"kind":"tl","value":"20.00"},"sku":"KUPA-MAVI"},"schema":{"$ref":"#/components/schemas/CreateVariant"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"archived":false,"barcode":"8690000000001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","expired":false,"id":"var_1234567890abcdef1234567890abcdef","is_default":true,"made_to_order":false,"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"pool_quantity":"1.000","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","sku":"KUPA-MAVI","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Variant"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Yeni kaydın API kökenine göre yolu.","schema":{"examples":["/v1/variants/var_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"code_taken":{"summary":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","value":{"code":"code_taken","detail":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:code_taken"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. code_taken: Stok kodu veya barkod başka bir kayıtta kullanılıyor. Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Ürüne seçenek ekle","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","code_taken","invalid_if_match","revision_mismatch","store_required","store_forbidden","reference_namespace_forbidden","external_reference_conflict"],"x-include-cost":false,"x-notes":"Panelin seçenek ekleme yoludur. İlk seçenek varsayılanın kimliğini, stok ve sipariş bağlarını korur; açık sipariş olması bu dönüşümü engellemez. Set içindeki varsayılan seçeneğe dönüşüm reddedilir. opening_stock mevcut stoğu değiştiriyorsa expected_stock gerekir. If-Match ürünün API görünümünden hesaplanan içerik ETag’idir.","x-optional-scopes":["costs:read","costs:write","inventory:write"],"x-personal-data":false,"x-purpose":"Var olan ürüne renk, beden gibi yeni bir seçenek ekleyin.","x-read-cost":1,"x-required-scopes":["products:write"],"x-scope-conditions":{"costs:write":"İstekte `cost` gönderirseniz gerekir.","inventory:write":"İstekte `opening_stock` gönderirseniz gerekir."}}},"/refunds/{id}":{"get":{"description":"Para iadesinin müşteriye ulaşıp ulaşmadığını izleyin. İade işleminin ret_ kimliğiyle güncel kaydı ve para özetini verir. money_returned ve card_status ile sonucu izleyin; belirsiz kart iadesini yeniden başlatmayın. Gerekli kapsamlar: returns:read, payments:read.","operationId":"get_refund_refunds__id__get","parameters":[{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","example":"ret_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","examples":["ret_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"amount":"120.00","card_status":"pending","id":"ret_1234567890abcdef1234567890abcdef","items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","unit":"adet"}],"money_returned":false,"order":"ord_1234567890abcdef1234567890abcdef","remaining_amount":"120.00","restock":true},"schema":{"$ref":"#/components/schemas/RefundResult"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"amount_changed":{"summary":"İade tutarı değişti; yeniden önizleyip onaylayın.","value":{"code":"amount_changed","current_amount":"120.00","detail":"İade tutarı değişti; yeniden önizleyip onaylayın.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:amount_changed"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"refund_distribution_confirm":{"summary":"Kart ve elle ödeme dağılımı değişti.","value":{"code":"refund_distribution_confirm","detail":"Kart ve elle ödeme dağılımı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:refund_distribution_confirm"}},"return_not_requested":{"summary":"Bu kayıt bir müşteri iade talebi değil.","value":{"code":"return_not_requested","detail":"Bu kayıt bir müşteri iade talebi değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:return_not_requested"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. amount_changed: İade tutarı değişti; yeniden önizleyip onaylayın. current_amount güncel TRY tutarıdır; önizlemeyi okuyup yeni anahtar ve expected_amount ile gönderin. return_not_requested: Bu kayıt bir müşteri iade talebi değil. Siparişin returns listesinden müşteri talebini seçin. refund_distribution_confirm: Kart ve elle ödeme dağılımı değişti. Yeniden önizleyip refund_distribution alanını aynen ve yeni tekrar anahtarıyla gönderin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"duplicate_line":{"summary":"Aynı sipariş satırı birden çok kez gönderilmiş.","value":{"code":"duplicate_line","detail":"Aynı sipariş satırı birden çok kez gönderilmiş.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:duplicate_line"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. duplicate_line: Aynı sipariş satırı birden çok kez gönderilmiş. Her lin_ kimliğini yalnız bir kez yazın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["returns:read","payments:read"]}],"summary":"Para iadesini getir","tags":["İade"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","conflict","invalid_id","duplicate_line","amount_changed","return_not_requested","refund_distribution_confirm"],"x-include-cost":false,"x-notes":"İade işleminin ret_ kimliğiyle güncel kaydı ve para özetini verir. money_returned ve card_status ile sonucu izleyin; belirsiz kart iadesini yeniden başlatmayın.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Para iadesinin müşteriye ulaşıp ulaşmadığını izleyin.","x-read-cost":1,"x-required-scopes":["returns:read","payments:read"]}},"/refunds/{id}/money-returned":{"post":{"description":"Parayı nakit, POS veya havaleyle kendiniz geri verdikten sonra kaydedin. Panelin Parayı iade ettim servisini çağırır. Bekleyen kart denemesi kapatılamaz; belirsiz sonucu yalnız sağlayıcı panelinde doğruladıktan sonra kaydedin. expected_amount ve Idempotency-Key zorunludur. Gerekli kapsamlar: returns:write, money_out:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"money_returned_refunds__id__money_returned_post","parameters":[{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","example":"ret_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","examples":["ret_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"expected_amount":"120.00"},"schema":{"$ref":"#/components/schemas/MoneyReturned"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"amount":"120.00","card_status":"pending","id":"ret_1234567890abcdef1234567890abcdef","items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","unit":"adet"}],"money_returned":false,"order":"ord_1234567890abcdef1234567890abcdef","remaining_amount":"120.00","restock":true},"schema":{"$ref":"#/components/schemas/RefundResult"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"amount_changed":{"summary":"İade tutarı değişti; yeniden önizleyip onaylayın.","value":{"code":"amount_changed","current_amount":"120.00","detail":"İade tutarı değişti; yeniden önizleyip onaylayın.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:amount_changed"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"refund_distribution_confirm":{"summary":"Kart ve elle ödeme dağılımı değişti.","value":{"code":"refund_distribution_confirm","detail":"Kart ve elle ödeme dağılımı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:refund_distribution_confirm"}},"return_not_requested":{"summary":"Bu kayıt bir müşteri iade talebi değil.","value":{"code":"return_not_requested","detail":"Bu kayıt bir müşteri iade talebi değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:return_not_requested"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. amount_changed: İade tutarı değişti; yeniden önizleyip onaylayın. current_amount güncel TRY tutarıdır; önizlemeyi okuyup yeni anahtar ve expected_amount ile gönderin. return_not_requested: Bu kayıt bir müşteri iade talebi değil. Siparişin returns listesinden müşteri talebini seçin. refund_distribution_confirm: Kart ve elle ödeme dağılımı değişti. Yeniden önizleyip refund_distribution alanını aynen ve yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"duplicate_line":{"summary":"Aynı sipariş satırı birden çok kez gönderilmiş.","value":{"code":"duplicate_line","detail":"Aynı sipariş satırı birden çok kez gönderilmiş.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:duplicate_line"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. duplicate_line: Aynı sipariş satırı birden çok kez gönderilmiş. Her lin_ kimliğini yalnız bir kez yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["returns:write","money_out:write"]}],"summary":"Elle verilen iadeyi kaydet","tags":["İade"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","conflict","invalid_id","duplicate_line","amount_changed","return_not_requested","refund_distribution_confirm"],"x-include-cost":false,"x-notes":"Panelin Parayı iade ettim servisini çağırır. Bekleyen kart denemesi kapatılamaz; belirsiz sonucu yalnız sağlayıcı panelinde doğruladıktan sonra kaydedin. expected_amount ve Idempotency-Key zorunludur.","x-optional-scopes":["payments:read"],"x-personal-data":false,"x-purpose":"Parayı nakit, POS veya havaleyle kendiniz geri verdikten sonra kaydedin.","x-read-cost":1,"x-required-scopes":["returns:write","money_out:write"]}},"/returns/{id}":{"get":{"description":"Müşterinin iade talebinin kalemlerini ve kararını okuyun. Sipariş iadeleri listesindeki ret_ kimliği kullanılır. Müşteri notları personal_data:read gerektirir. Gerekli kapsamlar: returns:read.","operationId":"get_return_returns__id__get","parameters":[{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","example":"ret_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","examples":["ret_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"ret_1234567890abcdef1234567890abcdef","items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","unit":"adet"}],"kind":"return","order":"ord_1234567890abcdef1234567890abcdef","refund_amount":"120.00","requested_at":"2026-10-16T09:00:00Z","source":"panel","status":"requested","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/ReturnDetail"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"amount_changed":{"summary":"İade tutarı değişti; yeniden önizleyip onaylayın.","value":{"code":"amount_changed","current_amount":"120.00","detail":"İade tutarı değişti; yeniden önizleyip onaylayın.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:amount_changed"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"refund_distribution_confirm":{"summary":"Kart ve elle ödeme dağılımı değişti.","value":{"code":"refund_distribution_confirm","detail":"Kart ve elle ödeme dağılımı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:refund_distribution_confirm"}},"return_not_requested":{"summary":"Bu kayıt bir müşteri iade talebi değil.","value":{"code":"return_not_requested","detail":"Bu kayıt bir müşteri iade talebi değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:return_not_requested"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. amount_changed: İade tutarı değişti; yeniden önizleyip onaylayın. current_amount güncel TRY tutarıdır; önizlemeyi okuyup yeni anahtar ve expected_amount ile gönderin. return_not_requested: Bu kayıt bir müşteri iade talebi değil. Siparişin returns listesinden müşteri talebini seçin. refund_distribution_confirm: Kart ve elle ödeme dağılımı değişti. Yeniden önizleyip refund_distribution alanını aynen ve yeni tekrar anahtarıyla gönderin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"duplicate_line":{"summary":"Aynı sipariş satırı birden çok kez gönderilmiş.","value":{"code":"duplicate_line","detail":"Aynı sipariş satırı birden çok kez gönderilmiş.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:duplicate_line"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. duplicate_line: Aynı sipariş satırı birden çok kez gönderilmiş. Her lin_ kimliğini yalnız bir kez yazın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["returns:read"]}],"summary":"İade talebini getir","tags":["İade"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","conflict","invalid_id","duplicate_line","amount_changed","return_not_requested","refund_distribution_confirm"],"x-include-cost":false,"x-notes":"Sipariş iadeleri listesindeki ret_ kimliği kullanılır. Müşteri notları personal_data:read gerektirir.","x-optional-scopes":["personal_data:read"],"x-personal-data":true,"x-purpose":"Müşterinin iade talebinin kalemlerini ve kararını okuyun.","x-read-cost":1,"x-required-scopes":["returns:read"]}},"/returns/{id}/approve":{"post":{"description":"Müşterinin iade veya değişim talebini kabul edin; para iadesi ayrı adımdır. Panelin aynı servisi kullanılır; para iadesi başlatmaz. Varsayılan kodsuz onaydır. return_code=true ile açılan geri gönderim kodu BasitKargo bakiyenizden ücretlidir ve ayrıca shipments:write ister. Not ve müşteri e-postası seçilebilir. Kargo kodu bekliyorsa paneldeki aynı süreç devam eder. Gerekli kapsamlar: returns:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"approve_returns__id__approve_post","parameters":[{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","example":"ret_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","examples":["ret_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/Decision"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"ret_1234567890abcdef1234567890abcdef","items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","unit":"adet"}],"kind":"return","order":"ord_1234567890abcdef1234567890abcdef","refund_amount":"120.00","requested_at":"2026-10-16T09:00:00Z","source":"panel","status":"requested","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/ReturnDetail"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"amount_changed":{"summary":"İade tutarı değişti; yeniden önizleyip onaylayın.","value":{"code":"amount_changed","current_amount":"120.00","detail":"İade tutarı değişti; yeniden önizleyip onaylayın.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:amount_changed"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"refund_distribution_confirm":{"summary":"Kart ve elle ödeme dağılımı değişti.","value":{"code":"refund_distribution_confirm","detail":"Kart ve elle ödeme dağılımı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:refund_distribution_confirm"}},"return_not_requested":{"summary":"Bu kayıt bir müşteri iade talebi değil.","value":{"code":"return_not_requested","detail":"Bu kayıt bir müşteri iade talebi değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:return_not_requested"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. amount_changed: İade tutarı değişti; yeniden önizleyip onaylayın. current_amount güncel TRY tutarıdır; önizlemeyi okuyup yeni anahtar ve expected_amount ile gönderin. return_not_requested: Bu kayıt bir müşteri iade talebi değil. Siparişin returns listesinden müşteri talebini seçin. refund_distribution_confirm: Kart ve elle ödeme dağılımı değişti. Yeniden önizleyip refund_distribution alanını aynen ve yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"duplicate_line":{"summary":"Aynı sipariş satırı birden çok kez gönderilmiş.","value":{"code":"duplicate_line","detail":"Aynı sipariş satırı birden çok kez gönderilmiş.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:duplicate_line"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. duplicate_line: Aynı sipariş satırı birden çok kez gönderilmiş. Her lin_ kimliğini yalnız bir kez yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["returns:write"]}],"summary":"İade talebini onayla","tags":["İade"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","conflict","invalid_id","duplicate_line","amount_changed","return_not_requested","refund_distribution_confirm"],"x-include-cost":false,"x-notes":"Panelin aynı servisi kullanılır; para iadesi başlatmaz. Varsayılan kodsuz onaydır. return_code=true ile açılan geri gönderim kodu BasitKargo bakiyenizden ücretlidir ve ayrıca shipments:write ister. Not ve müşteri e-postası seçilebilir. Kargo kodu bekliyorsa paneldeki aynı süreç devam eder.","x-optional-scopes":["personal_data:read","shipments:write"],"x-personal-data":true,"x-purpose":"Müşterinin iade veya değişim talebini kabul edin; para iadesi ayrı adımdır.","x-read-cost":1,"x-required-scopes":["returns:write"],"x-scope-conditions":{"shipments:write":"İstekte `return_code` gönderirseniz gerekir."}}},"/returns/{id}/reject":{"post":{"description":"Müşterinin iade talebini gerekçesiyle reddedin. Panelin aynı servisi kullanılır; para çıkışı olmaz. Karar notu müşteri sayfasında görünür. Bildirim notify_customer ile seçilir. Gerekli kapsamlar: returns:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"reject_returns__id__reject_post","parameters":[{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","example":"ret_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın ret_ önekli dış kimliği.","examples":["ret_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/Decision"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","id":"ret_1234567890abcdef1234567890abcdef","items":[{"item":"lin_1234567890abcdef1234567890abcdef","quantity":"1.000","unit":"adet"}],"kind":"return","order":"ord_1234567890abcdef1234567890abcdef","refund_amount":"120.00","requested_at":"2026-10-16T09:00:00Z","source":"panel","status":"requested","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/ReturnDetail"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"amount_changed":{"summary":"İade tutarı değişti; yeniden önizleyip onaylayın.","value":{"code":"amount_changed","current_amount":"120.00","detail":"İade tutarı değişti; yeniden önizleyip onaylayın.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:amount_changed"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"refund_distribution_confirm":{"summary":"Kart ve elle ödeme dağılımı değişti.","value":{"code":"refund_distribution_confirm","detail":"Kart ve elle ödeme dağılımı değişti.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:refund_distribution_confirm"}},"return_not_requested":{"summary":"Bu kayıt bir müşteri iade talebi değil.","value":{"code":"return_not_requested","detail":"Bu kayıt bir müşteri iade talebi değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:return_not_requested"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. amount_changed: İade tutarı değişti; yeniden önizleyip onaylayın. current_amount güncel TRY tutarıdır; önizlemeyi okuyup yeni anahtar ve expected_amount ile gönderin. return_not_requested: Bu kayıt bir müşteri iade talebi değil. Siparişin returns listesinden müşteri talebini seçin. refund_distribution_confirm: Kart ve elle ödeme dağılımı değişti. Yeniden önizleyip refund_distribution alanını aynen ve yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"duplicate_line":{"summary":"Aynı sipariş satırı birden çok kez gönderilmiş.","value":{"code":"duplicate_line","detail":"Aynı sipariş satırı birden çok kez gönderilmiş.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:duplicate_line"}},"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. duplicate_line: Aynı sipariş satırı birden çok kez gönderilmiş. Her lin_ kimliğini yalnız bir kez yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["returns:write"]}],"summary":"İade talebini reddet","tags":["İade"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","conflict","invalid_id","duplicate_line","amount_changed","return_not_requested","refund_distribution_confirm"],"x-include-cost":false,"x-notes":"Panelin aynı servisi kullanılır; para çıkışı olmaz. Karar notu müşteri sayfasında görünür. Bildirim notify_customer ile seçilir.","x-optional-scopes":["personal_data:read"],"x-personal-data":true,"x-purpose":"Müşterinin iade talebini gerekçesiyle reddedin.","x-read-cost":1,"x-required-scopes":["returns:write"]}},"/shipments/{id}":{"get":{"description":"Gönderinin durumunu, takip kodunu ve kapıda ödeme bilgisini okuyun. Bekleyen ve tamamlanmış gönderi aynı shp_ kimliğini taşır. Ortak gönderide tutarlar fiziksel gönderinin toplamıdır; sipariş alt kaynağı siparişin payını verir. ETag bu görünümün içerik özetidir. cancellation_status varsa iptal işinin durumudur; iptal tamamlanana kadar status değişmeyebilir. Gerekli kapsamlar: shipments:read.","operationId":"get_shipments__id__get","parameters":[{"description":"Okunacak kaynağın shp_ önekli dış kimliği.","example":"shp_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın shp_ önekli dış kimliği.","examples":["shp_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"carrier":"YURTICI","cod_amount":"120.00","collected_amount":null,"combined":true,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","delivered_at":null,"id":"shp_1234567890abcdef1234567890abcdef","shipping_fee":"0.00","state":"ready","status":"created","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Shipment"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Gönderinin API görünümünden hesaplanan güçlü sürüm etiketi; iptalin If-Match başlığında kullanın.","schema":{"examples":["\"123456789\""],"type":"string"}},"Location":{"description":"Gönderiyi izleme yolu.","schema":{"examples":["/v1/shipments/shp_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["shipments:read"]}],"summary":"Gönderiyi getir","tags":["Kargo"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-notes":"Bekleyen ve tamamlanmış gönderi aynı shp_ kimliğini taşır. Ortak gönderide tutarlar fiziksel gönderinin toplamıdır; sipariş alt kaynağı siparişin payını verir. ETag bu görünümün içerik özetidir. cancellation_status varsa iptal işinin durumudur; iptal tamamlanana kadar status değişmeyebilir.","x-optional-scopes":["personal_data:read","costs:read"],"x-personal-data":true,"x-purpose":"Gönderinin durumunu, takip kodunu ve kapıda ödeme bilgisini okuyun.","x-read-cost":1,"x-required-scopes":["shipments:read"]}},"/shipments/{id}/cancel":{"post":{"description":"Kurye almadan önce gönderiyi iptal edin; ücret paneldeki kuralla bakiyenize döner. Panelin durum ve bakiye iadesi kurallarıyla iptali kuyruğa alır. Sonuçlanmamış açılış iptal edilemez; önce izleyin. Sağlayıcıya göre iptal edilebilen gönderide 202; zaten iptal edilmişse 200 gelir. cancellation_status ve shipment.status_changed olaylarını izleyin. If-Match gönderinin ETag değeridir. Siparişi iptal etmez. Gerekli kapsamlar: shipments:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"cancel_shipments__id__cancel_post","parameters":[{"description":"Okunacak kaynağın shp_ önekli dış kimliği.","example":"shp_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın shp_ önekli dış kimliği.","examples":["shp_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"3\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"3\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CancelShipment"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"cancellation_status":"succeeded","carrier":"YURTICI","cod_amount":"120.00","collected_amount":null,"combined":true,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","delivered_at":null,"id":"shp_1234567890abcdef1234567890abcdef","shipping_fee":"0.00","state":"ready","status":"cancelled","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Shipment"}}},"description":"Gönderi zaten iptal edilmiş.","headers":{"ETag":{"description":"Gönderinin API görünümünden hesaplanan güçlü sürüm etiketi; iptalin If-Match başlığında kullanın.","schema":{"examples":["\"123456789\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Gönderiyi izleme yolu.","schema":{"examples":["/v1/shipments/shp_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"202":{"content":{"application/json":{"example":{"cancellation_status":"pending","carrier":"YURTICI","cod_amount":"120.00","collected_amount":null,"combined":true,"created_at":"2026-10-16T09:00:00Z","currency":"TRY","delivered_at":null,"id":"shp_1234567890abcdef1234567890abcdef","shipping_fee":"0.00","state":"ready","status":"created","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Shipment"}}},"description":"Kargo işlemi kuyruğa alındı; gönderiyi Location ile izleyin.","headers":{"ETag":{"description":"Gönderinin API görünümünden hesaplanan güçlü sürüm etiketi; iptalin If-Match başlığında kullanın.","schema":{"examples":["\"123456789\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Location":{"description":"Gönderiyi izleme yolu.","schema":{"examples":["/v1/shipments/shp_1234567890abcdef1234567890abcdef"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"shipping_address_invalid":{"summary":"Alıcı adresi eksik veya geçersiz.","value":{"code":"shipping_address_invalid","detail":"Alıcı adresi eksik veya geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_address_invalid"}},"shipping_balance_insufficient":{"summary":"Kargo bakiyesi yetersiz.","value":{"code":"shipping_balance_insufficient","detail":"Kargo bakiyesi yetersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_balance_insufficient"}},"shipping_carrier_disabled":{"summary":"Kargo firması kapalı veya seçilemez.","value":{"code":"shipping_carrier_disabled","detail":"Kargo firması kapalı veya seçilemez.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_carrier_disabled"}},"shipping_cod_unavailable":{"summary":"Kapıda ödeme bu hesapta veya firmada kullanılamıyor.","value":{"code":"shipping_cod_unavailable","detail":"Kapıda ödeme bu hesapta veya firmada kullanılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_cod_unavailable"}},"shipping_quote_unavailable":{"summary":"Bu paket ve ödeme yöntemi için ücret bulunamadı.","value":{"code":"shipping_quote_unavailable","detail":"Bu paket ve ödeme yöntemi için ücret bulunamadı.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:shipping_quote_unavailable"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. shipping_balance_insufficient: Kargo bakiyesi yetersiz. BasitKargo bakiyesini yükleyin; yeni tekrar anahtarıyla deneyin. shipping_address_invalid: Alıcı adresi eksik veya geçersiz. Siparişin il, ilçe, mahalle ve açık adresini düzeltin; yeni tekrar anahtarı kullanın. shipping_carrier_disabled: Kargo firması kapalı veya seçilemez. Fiyat yanıtındaki açık firma kodunu seçin. shipping_cod_unavailable: Kapıda ödeme bu hesapta veya firmada kullanılamıyor. BasitKargo kapıda ödeme ayarlarını ve siparişin ödeme yöntemini kontrol edin. shipping_quote_unavailable: Bu paket ve ödeme yöntemi için ücret bulunamadı. Koli ölçülerini ve firma seçimini kontrol edin. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"shipment_not_allowed":{"summary":"Gönderinin veya siparişin durumu bu işleme uygun değil.","value":{"code":"shipment_not_allowed","detail":"Gönderinin veya siparişin durumu bu işleme uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:shipment_not_allowed"}},"shipping_not_connected":{"summary":"BasitKargo hesabı bağlı değil.","value":{"code":"shipping_not_connected","detail":"BasitKargo hesabı bağlı değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:shipping_not_connected"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. shipment_not_allowed: Gönderinin veya siparişin durumu bu işleme uygun değil. Güncel gönderiyi ve siparişi okuyun; bekleyen işlemin sonuçlanmasını izleyin. shipping_not_connected: BasitKargo hesabı bağlı değil. İşletme ayarları > Kargo’dan hesabı bağlayın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}},"shipping_rate_limited":{"summary":"Kargo sağlayıcısının istek sınırına ulaşıldı.","value":{"code":"shipping_rate_limited","detail":"Kargo sağlayıcısının istek sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:shipping_rate_limited"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın. shipping_rate_limited: Kargo sağlayıcısının istek sınırına ulaşıldı. Retry-After saniye bekleyin; gönderi açılışında aynı anahtarı koruyun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}},"shipping_unavailable":{"summary":"Kargo hizmetine şu an ulaşılamıyor.","value":{"code":"shipping_unavailable","detail":"Kargo hizmetine şu an ulaşılamıyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:shipping_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin. shipping_unavailable: Kargo hizmetine şu an ulaşılamıyor. Retry-After saniye bekleyin; aynı anahtar/gövdeyle tekrar edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["shipments:write"]}],"summary":"Gönderiyi iptal et","tags":["Kargo"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","shipment_not_allowed","shipping_balance_insufficient","shipping_address_invalid","shipping_carrier_disabled","shipping_cod_unavailable","shipping_quote_unavailable","shipping_not_connected","shipping_rate_limited","shipping_unavailable","invalid_if_match","revision_mismatch","invalid_id"],"x-include-cost":false,"x-notes":"Panelin durum ve bakiye iadesi kurallarıyla iptali kuyruğa alır. Sonuçlanmamış açılış iptal edilemez; önce izleyin. Sağlayıcıya göre iptal edilebilen gönderide 202; zaten iptal edilmişse 200 gelir. cancellation_status ve shipment.status_changed olaylarını izleyin. If-Match gönderinin ETag değeridir. Siparişi iptal etmez.","x-optional-scopes":["personal_data:read","costs:read"],"x-personal-data":true,"x-purpose":"Kurye almadan önce gönderiyi iptal edin; ücret paneldeki kuralla bakiyenize döner.","x-read-cost":1,"x-required-scopes":["shipments:write"]}},"/shipments/{id}/label":{"get":{"description":"Koliye yapıştırılacak kargo etiketini SVG olarak indirin. Panelle aynı image/svg+xml etiketi döner; her koli ayrı SVG’dir. page varsayılan 1, X-Label-Pages toplam etiket sayısıdır; diğer koliler için page artırılır. Olmayan sayfa 404 döner. shipments:read ve personal_data:read birlikte zorunludur. Her indirmede güncel marka, kapsam ve gönderi durumu yeniden denetlenir; Cache-Control: no-store. Etiket dosya eki olarak, nosniff ve betik/dış kaynakları engelleyen CSP sandbox başlıklarıyla sunulur. Etiket hazır değilse veya gönderi iptalse 409 gelir. İndirme 10 hız sınırı puanı tüketir. Gerekli kapsamlar: shipments:read, personal_data:read.","operationId":"label_shipments__id__label_get","parameters":[{"description":"Okunacak kaynağın shp_ önekli dış kimliği.","example":"shp_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın shp_ önekli dış kimliği.","examples":["shp_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Etiket sayfası; ilk koli 1. Toplam sayfa sayısı X-Label-Pages başlığında.","example":1,"in":"query","name":"page","required":false,"schema":{"default":1,"description":"Etiket sayfası; ilk koli 1. Toplam sayfa sayısı X-Label-Pages başlığında.","examples":[1],"minimum":1,"title":"Page","type":"integer"}}],"responses":{"200":{"content":{"image/svg+xml":{"example":"<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 400 600\"><text x=\"20\" y=\"40\">Kargo etiketi</text></svg>","schema":{"format":"binary","type":"string"}}},"description":"Seçilen kolinin SVG etiketi; toplam etiket sayısı X-Label-Pages başlığındadır.","headers":{"Cache-Control":{"description":"Kişisel etiket önbelleklenmez.","schema":{"examples":["no-store"],"type":"string"}},"Content-Disposition":{"description":"Seçilen kolinin SVG etiketi dosya olarak indirilir.","schema":{"examples":["attachment; filename=\"etiket-shp_1234567890abcdef1234567890abcdef.svg\""],"type":"string"}},"Content-Security-Policy":{"description":"SVG betikleri ve dış kaynakları tarayıcıda engellenir.","schema":{"examples":["default-src 'none'; style-src 'unsafe-inline'; sandbox"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Content-Type-Options":{"description":"Tarayıcı içerik türünü tahmin etmez.","schema":{"examples":["nosniff"],"type":"string"}},"X-Label-Pages":{"description":"Gönderinin toplam etiket sayfası sayısı; her koli ayrı SVG. Diğer sayfalar için page kullanın.","schema":{"examples":[2],"minimum":1,"type":"integer"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"shipment_label_not_ready":{"summary":"Etiket hazır değil veya gönderi iptal edilmiş.","value":{"code":"shipment_label_not_ready","detail":"Etiket hazır değil veya gönderi iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:shipment_label_not_ready"}},"shipping_not_connected":{"summary":"BasitKargo hesabı bağlı değil.","value":{"code":"shipping_not_connected","detail":"BasitKargo hesabı bağlı değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:shipping_not_connected"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"shipping_not_connected: BasitKargo hesabı bağlı değil. İşletme ayarları > Kargo’dan hesabı bağlayın. shipment_label_not_ready: Etiket hazır değil veya gönderi iptal edilmiş. Gönderinin açılışının tamamlanmasını bekleyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}},"shipping_rate_limited":{"summary":"Kargo sağlayıcısının istek sınırına ulaşıldı.","value":{"code":"shipping_rate_limited","detail":"Kargo sağlayıcısının istek sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:shipping_rate_limited"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın. shipping_rate_limited: Kargo sağlayıcısının istek sınırına ulaşıldı. Retry-After saniye bekleyin; gönderi açılışında aynı anahtarı koruyun.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"502":{"content":{"application/problem+json":{"examples":{"shipping_provider_error":{"summary":"Kargo etiketi alınamadı veya yanıtta SVG etiketi bulunamadı.","value":{"code":"shipping_provider_error","detail":"Kargo etiketi alınamadı veya yanıtta SVG etiketi bulunamadı.","errors":[],"request_id":"req_ornek_20261016","status":502,"title":"Bad Gateway","type":"urn:siparis:problem:shipping_provider_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"shipping_provider_error: Kargo etiketi alınamadı veya yanıtta SVG etiketi bulunamadı. Bir süre sonra aynı gönderinin etiketini yeniden indirin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["shipments:read","personal_data:read"]}],"summary":"Kargo etiketini indir","tags":["Kargo"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","shipping_not_connected","shipment_label_not_ready","shipping_rate_limited","shipping_provider_error","invalid_id"],"x-include-cost":false,"x-notes":"Panelle aynı image/svg+xml etiketi döner; her koli ayrı SVG’dir. page varsayılan 1, X-Label-Pages toplam etiket sayısıdır; diğer koliler için page artırılır. Olmayan sayfa 404 döner. shipments:read ve personal_data:read birlikte zorunludur. Her indirmede güncel marka, kapsam ve gönderi durumu yeniden denetlenir; Cache-Control: no-store. Etiket dosya eki olarak, nosniff ve betik/dış kaynakları engelleyen CSP sandbox başlıklarıyla sunulur. Etiket hazır değilse veya gönderi iptalse 409 gelir. İndirme 10 hız sınırı puanı tüketir.","x-optional-scopes":[],"x-personal-data":true,"x-purpose":"Koliye yapıştırılacak kargo etiketini SVG olarak indirin.","x-read-cost":10,"x-required-scopes":["shipments:read","personal_data:read"]}},"/store-prices":{"get":{"description":"Markaya özel kaydedilmiş ürün ve seçenek fiyatlarını alın. Anahtar store, product, variant üçlüsüdür; kampanya fiyatı hesaplamaz. Gerekli kapsamlar: products:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"store_prices_store_prices_get","parameters":[{"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","example":"sto_1234567890abcdef1234567890abcdef","in":"query","name":"store","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store"}},{"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","example":"prd_1234567890abcdef1234567890abcdef","in":"query","name":"product","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product"}},{"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","example":"var_1234567890abcdef1234567890abcdef","in":"query","name":"variant","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"archived":false,"compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","variant":"var_1234567890abcdef1234567890abcdef"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_StorePrice_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Marka fiyatlarını listele","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Anahtar store, product, variant üçlüsüdür; kampanya fiyatı hesaplamaz.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Markaya özel kaydedilmiş ürün ve seçenek fiyatlarını alın.","x-read-cost":2,"x-required-scopes":["products:read"]}},"/store-prices/{store}/{product}":{"get":{"description":"Belirli marka ve ürünün kaydedilmiş fiyatını okuyun. Seçenek fiyatı için variant gönderin; göndermezseniz ürün fiyatı okunur. Gerekli kapsamlar: products:read.","operationId":"store_price_store_prices__store___product__get","parameters":[{"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","example":"sto_1234567890abcdef1234567890abcdef","in":"path","name":"store","required":true,"schema":{"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store","type":"string"}},{"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","example":"prd_1234567890abcdef1234567890abcdef","in":"path","name":"product","required":true,"schema":{"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product","type":"string"}},{"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","example":"var_1234567890abcdef1234567890abcdef","in":"query","name":"variant","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Seçenek dış kimliği (var_ ve 32 küçük onaltılık karakter).","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Variant"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","store":"sto_1234567890abcdef1234567890abcdef","updated_at":"2026-10-16T09:00:00Z","variant":"var_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/StorePrice"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Marka fiyatını getir","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-notes":"Seçenek fiyatı için variant gönderin; göndermezseniz ürün fiyatı okunur.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Belirli marka ve ürünün kaydedilmiş fiyatını okuyun.","x-read-cost":1,"x-required-scopes":["products:read"]},"put":{"description":"Ürünün veya seçeneğin bir markadaki satış fiyatını ayarlayın ya da kaldırın. Marka fiyatı okumasındaki price ve compare_price alanlarını birlikte gönderin. Gövdenin variant alanı varsa yalnız o seçeneğin marka fiyatını yazar. İki alan null ise marka fiyat satırını kaldırır; katalog fiyatı geçer. Diğer markalar korunur. Yanıt güncel Product nesnesi ve store_prices listesidir; böylece kaldırma da güncel kayıttan tekrar okunur. If-Match ürünün içerik ETag’idir. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"store_price_store_prices__store___product__put","parameters":[{"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","example":"sto_1234567890abcdef1234567890abcdef","in":"path","name":"store","required":true,"schema":{"description":"Marka dış kimliği (sto_ ve 32 küçük onaltılık karakter).","examples":["sto_1234567890abcdef1234567890abcdef"],"title":"Store","type":"string"}},{"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","example":"prd_1234567890abcdef1234567890abcdef","in":"path","name":"product","required":true,"schema":{"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"0123456789abcdef\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"0123456789abcdef\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"compare_price":"140.00","price":"110.00"},"schema":{"$ref":"#/components/schemas/StorePriceInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"brand":"brd_1234567890abcdef1234567890abcdef","code":"KUPA-001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","description":"Seramik kupa, 300 ml.","id":"prd_1234567890abcdef1234567890abcdef","images":["https://example.com/kupa.jpg"],"kind":"standard","made_to_order":false,"maximum_quantity":"100.000","minimum_quantity":"1.000","name":"Seramik Kupa","pool_unit":"adet","preparation":"3 iş günü","price":"120.00","quantity_step":"1.000","short_description":"Seramik kupa","slug":"ornek-kupa","status":"active","tax_rate":"20.00","tax_status":"standard","unit":"adet","updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Product"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"code_taken":{"summary":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","value":{"code":"code_taken","detail":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:code_taken"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. code_taken: Stok kodu veya barkod başka bir kayıtta kullanılıyor. Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Marka fiyatını yaz","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","code_taken","invalid_if_match","revision_mismatch","store_required","store_forbidden","reference_namespace_forbidden","external_reference_conflict"],"x-include-cost":false,"x-notes":"Marka fiyatı okumasındaki price ve compare_price alanlarını birlikte gönderin. Gövdenin variant alanı varsa yalnız o seçeneğin marka fiyatını yazar. İki alan null ise marka fiyat satırını kaldırır; katalog fiyatı geçer. Diğer markalar korunur. Yanıt güncel Product nesnesi ve store_prices listesidir; böylece kaldırma da güncel kayıttan tekrar okunur. If-Match ürünün içerik ETag’idir.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Ürünün veya seçeneğin bir markadaki satış fiyatını ayarlayın ya da kaldırın.","x-read-cost":1,"x-required-scopes":["products:write"]}},"/stores":{"get":{"description":"Anahtarın erişebildiği satış markalarını alın; çok markalı işletmede store kimliğini seçerken kullanın. Marka sınırlı anahtarın yetkisi genişlemez. Geçerli Bearer anahtarı yeterlidir; ek kapsam gerekmez. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"stores_stores_get","parameters":[{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"active":true,"created_at":"2026-10-16T09:00:00Z","id":"sto_1234567890abcdef1234567890abcdef","name":"Örnek Marka","slug":"ornek-kupa","updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Store_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":[]}],"summary":"Markaları listele","tags":["Hesap"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor"],"x-include-cost":false,"x-notes":"Marka sınırlı anahtarın yetkisi genişlemez.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Anahtarın erişebildiği satış markalarını alın; çok markalı işletmede store kimliğini seçerken kullanın.","x-read-cost":2,"x-required-scopes":[]}},"/variants":{"get":{"description":"Ürün seçeneklerini stok kodu (SKU) veya barkodla bulun; ERP stok kartını var_ kimliğiyle eşleştirin. SKU ve barkod tam eşitlikle aranır. İkisini birlikte gönderirseniz her ikisi de eşleşmelidir. Gerekli kapsamlar: products:read. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"variants_variants_get","parameters":[{"description":"Normalize edilmiş stok koduyla tam eşitlik; barcode da verilirse ikisi eşleşir.","example":"KUPA-MAVI","in":"query","name":"sku","required":false,"schema":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"description":"Normalize edilmiş stok koduyla tam eşitlik; barcode da verilirse ikisi eşleşir.","examples":["KUPA-MAVI"],"title":"Sku"}},{"description":"Normalize edilmiş barkodla tam eşitlik; sku da verilirse ikisi eşleşir.","example":"8690000000001","in":"query","name":"barcode","required":false,"schema":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"description":"Normalize edilmiş barkodla tam eşitlik; sku da verilirse ikisi eşleşir.","examples":["8690000000001"],"title":"Barcode"}},{"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","example":"prd_1234567890abcdef1234567890abcdef","in":"query","name":"product","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ürün dış kimliği (prd_ ve 32 küçük onaltılık karakter).","examples":["prd_1234567890abcdef1234567890abcdef"],"title":"Product"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"archived":false,"barcode":"8690000000001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","expired":false,"id":"var_1234567890abcdef1234567890abcdef","is_default":true,"made_to_order":false,"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"pool_quantity":"1.000","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","sku":"KUPA-MAVI","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Variant_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Seçenekleri listele","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"SKU ve barkod tam eşitlikle aranır. İkisini birlikte gönderirseniz her ikisi de eşleşmelidir.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Ürün seçeneklerini stok kodu (SKU) veya barkodla bulun; ERP stok kartını var_ kimliğiyle eşleştirin.","x-read-cost":2,"x-required-scopes":["products:read"]}},"/variants/{id}":{"get":{"description":"Bir seçeneğin güncel fiyatını ve stok türünü okuyun. Seçeneğin depo miktarını inventory/levels ucundan okuyun. Gerekli kapsamlar: products:read.","operationId":"variant_variants__id__get","parameters":[{"description":"Okunacak kaynağın var_ önekli dış kimliği.","example":"var_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın var_ önekli dış kimliği.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","example":false,"in":"query","name":"archived","required":false,"schema":{"default":false,"description":"true arşivdeki ve kapalı kayıtları da içerir; varsayılan false.","examples":[false],"title":"Archived","type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"barcode":"8690000000001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","expired":false,"id":"var_1234567890abcdef1234567890abcdef","is_default":true,"made_to_order":false,"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"pool_quantity":"1.000","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","sku":"KUPA-MAVI","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Variant"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:read"]}],"summary":"Seçeneği getir","tags":["Ürünler"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-notes":"Seçeneğin depo miktarını inventory/levels ucundan okuyun.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Bir seçeneğin güncel fiyatını ve stok türünü okuyun.","x-read-cost":1,"x-required-scopes":["products:read"]},"patch":{"description":"Seçeneğin stok kodunu, barkodunu, fiyatını, maliyetini, ağırlığını veya görsellerini değiştirin. Stok kodu, barkod, seçenek değerleri, satış fiyatı veya TL/yüzde fiyat farkı, maliyet, ağırlık ve görseller panelin aynı servisiyle yazılır. price_rule=null ürünle aynı fiyatı seçer. is_default=true olan varsayılan satır ürün PATCH ucundan düzenlenir. If-Match bağlı ürünün içerik ETag’idir. Gerekli kapsamlar: products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"patch_variant_variants__id__patch","parameters":[{"description":"Okunacak kaynağın var_ önekli dış kimliği.","example":"var_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın var_ önekli dış kimliği.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"0123456789abcdef\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"0123456789abcdef\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{"price_rule":{"kind":"percent","value":"10.00"}},"schema":{"$ref":"#/components/schemas/PatchVariant"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"barcode":"8690000000001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","expired":false,"id":"var_1234567890abcdef1234567890abcdef","is_default":true,"made_to_order":false,"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"pool_quantity":"1.000","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","sku":"KUPA-MAVI","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Variant"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"code_taken":{"summary":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","value":{"code":"code_taken","detail":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:code_taken"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. code_taken: Stok kodu veya barkod başka bir kayıtta kullanılıyor. Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["products:write"]}],"summary":"Seçeneği güncelle","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","code_taken","invalid_if_match","revision_mismatch","store_required","store_forbidden","reference_namespace_forbidden","external_reference_conflict"],"x-include-cost":false,"x-notes":"Stok kodu, barkod, seçenek değerleri, satış fiyatı veya TL/yüzde fiyat farkı, maliyet, ağırlık ve görseller panelin aynı servisiyle yazılır. price_rule=null ürünle aynı fiyatı seçer. is_default=true olan varsayılan satır ürün PATCH ucundan düzenlenir. If-Match bağlı ürünün içerik ETag’idir.","x-optional-scopes":["costs:read","costs:write"],"x-personal-data":false,"x-purpose":"Seçeneğin stok kodunu, barkodunu, fiyatını, maliyetini, ağırlığını veya görsellerini değiştirin.","x-read-cost":1,"x-required-scopes":["products:write"],"x-scope-conditions":{"costs:write":"İstekte `cost` gönderirseniz gerekir."}}},"/variants/{id}/archive":{"post":{"description":"Satılmayan bir seçeneği üründen kaldırın; kaydı silinmez. Panelin kaldırma yoludur; archive:write gerekir. Açık siparişteki seçenek arşivlenemez; kayıt korunur. Bağımsız seçenek geri getirme panelde olmadığı için API’de de yoktur. Gerekli kapsamlar: archive:write, products:write. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"variant_archive_variants__id__archive_post","parameters":[{"description":"Okunacak kaynağın var_ önekli dış kimliği.","example":"var_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın var_ önekli dış kimliği.","examples":["var_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}},{"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","example":"\"0123456789abcdef\"","in":"header","name":"if-match","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"İsteğe bağlı önkoşul: son ETag değerini çift tırnaklarıyla gönderin. Komutun kilidi altında farklıysa 412 revision_mismatch.","examples":["\"0123456789abcdef\""],"title":"If-Match"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/CatalogAction"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"archived":false,"barcode":"8690000000001","compare_price":"150.00","created_at":"2026-10-16T09:00:00Z","currency":"TRY","expired":false,"id":"var_1234567890abcdef1234567890abcdef","is_default":true,"made_to_order":false,"name":"Mavi","options":[{"name":"Renk","value":"Mavi"}],"pool_quantity":"1.000","price":"120.00","product":"prd_1234567890abcdef1234567890abcdef","sku":"KUPA-MAVI","stock_uncounted":false,"updated_at":"2026-10-16T09:00:00Z"},"schema":{"$ref":"#/components/schemas/Variant"}}},"description":"İstek başarıyla tamamlandı.","headers":{"ETag":{"description":"Ürünün API görünümünün SHA-256 içerik özetinin ilk 16 onaltılık karakteri; stok durumu ve updated_at hariç. If-Match için tırnaklarıyla saklayın.","schema":{"examples":["\"0123456789abcdef\""],"type":"string"}},"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_if_match":{"summary":"If-Match geçerli bir güçlü ETag değil.","value":{"code":"invalid_if_match","detail":"If-Match geçerli bir güçlü ETag değil.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_if_match"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın. invalid_if_match: If-Match geçerli bir güçlü ETag değil. GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"forbidden":{"summary":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","value":{"code":"forbidden","detail":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:forbidden"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}},"reference_namespace_forbidden":{"summary":"Dış numaranın ad alanı başka bağlantıya ait.","value":{"code":"reference_namespace_forbidden","detail":"Dış numaranın ad alanı başka bağlantıya ait.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:reference_namespace_forbidden"}},"store_forbidden":{"summary":"Anahtar başka markaya yazamaz.","value":{"code":"store_forbidden","detail":"Anahtar başka markaya yazamaz.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:store_forbidden"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. forbidden: Mevcut ticari kural bu işlemi yapmanıza izin vermiyor. Gerekli kapsamları ve siparişin durumunu kontrol edin. store_forbidden: Anahtar başka markaya yazamaz. Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez. reference_namespace_forbidden: Dış numaranın ad alanı başka bağlantıya ait. namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"code_taken":{"summary":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","value":{"code":"code_taken","detail":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:code_taken"}},"conflict":{"summary":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","value":{"code":"conflict","detail":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:conflict"}},"external_reference_conflict":{"summary":"Bu dış numarayla stok belgesi zaten açılmış.","value":{"code":"external_reference_conflict","detail":"Bu dış numarayla stok belgesi zaten açılmış.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:external_reference_conflict"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. conflict: Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil. Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin. code_taken: Stok kodu veya barkod başka bir kayıtta kullanılıyor. Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin. external_reference_conflict: Bu dış numarayla stok belgesi zaten açılmış. Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"412":{"content":{"application/problem+json":{"examples":{"revision_mismatch":{"summary":"Kayıt siz okuduktan sonra değişmiş.","value":{"code":"revision_mismatch","detail":"Kayıt siz okuduktan sonra değişmiş.","errors":[],"request_id":"req_ornek_20261016","status":412,"title":"Precondition Failed","type":"urn:siparis:problem:revision_mismatch"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"revision_mismatch: Kayıt siz okuduktan sonra değişmiş. Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"store_required":{"summary":"Çok markalı işletmede kaydın markası eksik.","value":{"code":"store_required","detail":"Çok markalı işletmede kaydın markası eksik.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:store_required"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. store_required: Çok markalı işletmede kaydın markası eksik. /me yanıtındaki sto_ kimliğini store alanına yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["archive:write","products:write"]}],"summary":"Seçeneği arşivle","tags":["Ürünler"],"x-data-class":"products","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","forbidden","conflict","invalid_id","code_taken","invalid_if_match","revision_mismatch","store_required","store_forbidden","reference_namespace_forbidden","external_reference_conflict"],"x-include-cost":false,"x-notes":"Panelin kaldırma yoludur; archive:write gerekir. Açık siparişteki seçenek arşivlenemez; kayıt korunur. Bağımsız seçenek geri getirme panelde olmadığı için API’de de yoktur.","x-optional-scopes":["costs:read"],"x-personal-data":false,"x-purpose":"Satılmayan bir seçeneği üründen kaldırın; kaydı silinmez.","x-read-cost":1,"x-required-scopes":["archive:write","products:write"]}},"/webhook_endpoints":{"get":{"description":"Bu bağlantının webhook adreslerini ve sağlık durumlarını alın. Başka bağlantının adresleri görünmez; imza sırları listelenmez. Gerekli kapsamlar: webhooks:manage. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"endpoints_webhook_endpoints_get","parameters":[{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"created_at":"2026-10-16T09:00:00Z","event_types":["order.created"],"grant":"grt_1234567890abcdef1234567890abcdef","id":"whe_1234567890abcdef1234567890abcdef","last_attempt_at":null,"last_error":null,"last_success_at":null,"previous_secret_until":null,"schema_version":1,"status":"pending_test","store":"sto_1234567890abcdef1234567890abcdef","store_name":"Örnek Marka","url":"https://example.com/webhooks/siparis"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Endpoint_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Webhook adreslerini listele","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor"],"x-include-cost":false,"x-notes":"Başka bağlantının adresleri görünmez; imza sırları listelenmez.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bu bağlantının webhook adreslerini ve sağlık durumlarını alın.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]},"post":{"description":"Değişikliklerin sizin HTTPS adresinize imzalı olarak gönderilmesi için adres ekleyin. İmzalı deneme kuyruğa alınır. Alıcı 2xx vermeden adres etkinleşmez. Olay türlerinin okuma kapsamları da gerekir. İmza sırrı yalnız bu yanıtta gösterilir; güvenli saklayın. Belirsiz ağ hatasında yeniden oluşturmadan önce adres listesini kontrol edin. Gerekli kapsamlar: webhooks:manage. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"create_webhook_endpoints_post","parameters":[{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"event_types":["order.created"],"url":"https://example.com/webhooks/siparis"},"schema":{"$ref":"#/components/schemas/EndpointInput"}}},"required":true},"responses":{"201":{"content":{"application/json":{"example":{"endpoint":{"created_at":"2026-10-16T09:00:00Z","event_types":["order.created"],"grant":"grt_1234567890abcdef1234567890abcdef","id":"whe_1234567890abcdef1234567890abcdef","last_attempt_at":null,"last_error":null,"last_success_at":null,"previous_secret_until":null,"schema_version":1,"status":"pending_test","store":"sto_1234567890abcdef1234567890abcdef","store_name":"Örnek Marka","url":"https://example.com/webhooks/siparis"},"secret":"whsec_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="},"schema":{"$ref":"#/components/schemas/EndpointResult"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"grant_mismatch":{"summary":"Başka API bağlantısının webhook adresi istenmiş.","value":{"code":"grant_mismatch","detail":"Başka API bağlantısının webhook adresi istenmiş.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:grant_mismatch"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. grant_mismatch: Başka API bağlantısının webhook adresi istenmiş. Yalnız kullandığınız Bearer anahtarının bağlantısını yönetin; grant alanını atlayabilirsiniz.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_event_types":{"summary":"Olay türü geçersiz veya izinli tür yok.","value":{"code":"invalid_event_types","detail":"Olay türü geçersiz veya izinli tür yok.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_event_types"}},"invalid_grant":{"summary":"Webhook yönetimi açık bağlantı bulunamadı.","value":{"code":"invalid_grant","detail":"Webhook yönetimi açık bağlantı bulunamadı.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_grant"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_store":{"summary":"Marka bağlantının yetkisinde değil veya kapalı.","value":{"code":"invalid_store","detail":"Marka bağlantının yetkisinde değil veya kapalı.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_store"}},"invalid_webhook_url":{"summary":"Webhook adresi kabul edilmiyor.","value":{"code":"invalid_webhook_url","detail":"Webhook adresi kabul edilmiyor.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_webhook_url"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_grant: Webhook yönetimi açık bağlantı bulunamadı. Açık, webhooks:manage kapsamlı bağlantı kullanın. invalid_webhook_url: Webhook adresi kabul edilmiyor. Genel internete çözülen, kullanıcı bilgisi içermeyen HTTPS/443 adresi kullanın. invalid_store: Marka bağlantının yetkisinde değil veya kapalı. /me stores listesindeki bir markayı seçin. invalid_event_types: Olay türü geçersiz veya izinli tür yok. Olay kataloğundan tür seçin ve kaynak kapsamını açın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Webhook adresi oluştur","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","grant_mismatch","invalid_grant","invalid_webhook_url","invalid_store","invalid_event_types","invalid_id"],"x-include-cost":false,"x-notes":"İmzalı deneme kuyruğa alınır. Alıcı 2xx vermeden adres etkinleşmez. Olay türlerinin okuma kapsamları da gerekir. İmza sırrı yalnız bu yanıtta gösterilir; güvenli saklayın. Belirsiz ağ hatasında yeniden oluşturmadan önce adres listesini kontrol edin.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Değişikliklerin sizin HTTPS adresinize imzalı olarak gönderilmesi için adres ekleyin.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]}},"/webhook_endpoints/{id}":{"get":{"description":"Bir webhook adresinin durumunu ve son teslim sonucunu okuyun; teslim sorunlarını teşhis ederken kullanın. Sır döndürülmez. Gerekli kapsamlar: webhooks:manage.","operationId":"endpoint_webhook_endpoints__id__get","parameters":[{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","example":"whe_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-10-16T09:00:00Z","event_types":["order.created"],"grant":"grt_1234567890abcdef1234567890abcdef","id":"whe_1234567890abcdef1234567890abcdef","last_attempt_at":null,"last_error":null,"last_success_at":null,"previous_secret_until":null,"schema_version":1,"status":"pending_test","store":"sto_1234567890abcdef1234567890abcdef","store_name":"Örnek Marka","url":"https://example.com/webhooks/siparis"},"schema":{"$ref":"#/components/schemas/Endpoint"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Webhook adresini getir","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_id"],"x-include-cost":false,"x-notes":"Sır döndürülmez.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bir webhook adresinin durumunu ve son teslim sonucunu okuyun; teslim sorunlarını teşhis ederken kullanın.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]},"patch":{"description":"Webhook adresini, olay türlerini veya markasını değiştirin. Gönderilen alanlar değişir; atlananlar aynı kalır. Adres veya marka değişimi yeni deneme gerektirir; imza sırrı değişmez. store=null işletme bağlantısında tüm izinli markaları seçer. Gerekli kapsamlar: webhooks:manage. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"patch_webhook_endpoints__id__patch","parameters":[{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","example":"whe_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"event_types":["order.created"]},"schema":{"$ref":"#/components/schemas/EndpointPatch"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"endpoint":{"created_at":"2026-10-16T09:00:00Z","event_types":["order.created"],"grant":"grt_1234567890abcdef1234567890abcdef","id":"whe_1234567890abcdef1234567890abcdef","last_attempt_at":null,"last_error":null,"last_success_at":null,"previous_secret_until":null,"schema_version":1,"status":"pending_test","store":"sto_1234567890abcdef1234567890abcdef","store_name":"Örnek Marka","url":"https://example.com/webhooks/siparis"}},"schema":{"$ref":"#/components/schemas/EndpointResult"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"grant_mismatch":{"summary":"Başka API bağlantısının webhook adresi istenmiş.","value":{"code":"grant_mismatch","detail":"Başka API bağlantısının webhook adresi istenmiş.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:grant_mismatch"}},"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin. grant_mismatch: Başka API bağlantısının webhook adresi istenmiş. Yalnız kullandığınız Bearer anahtarının bağlantısını yönetin; grant alanını atlayabilirsiniz.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"endpoint_closed":{"summary":"Webhook adresi kapalı.","value":{"code":"endpoint_closed","detail":"Webhook adresi kapalı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:endpoint_closed"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. endpoint_closed: Webhook adresi kapalı. Yeni adres kaydı oluşturun ve imzalı denemeyi tamamlayın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_event_types":{"summary":"Olay türü geçersiz veya izinli tür yok.","value":{"code":"invalid_event_types","detail":"Olay türü geçersiz veya izinli tür yok.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_event_types"}},"invalid_grant":{"summary":"Webhook yönetimi açık bağlantı bulunamadı.","value":{"code":"invalid_grant","detail":"Webhook yönetimi açık bağlantı bulunamadı.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_grant"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"invalid_patch":{"summary":"Düzeltilecek alan veya seçenek uygun değil.","value":{"code":"invalid_patch","detail":"Düzeltilecek alan veya seçenek uygun değil.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_patch"}},"invalid_store":{"summary":"Marka bağlantının yetkisinde değil veya kapalı.","value":{"code":"invalid_store","detail":"Marka bağlantının yetkisinde değil veya kapalı.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_store"}},"invalid_webhook_url":{"summary":"Webhook adresi kabul edilmiyor.","value":{"code":"invalid_webhook_url","detail":"Webhook adresi kabul edilmiyor.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_webhook_url"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin. invalid_grant: Webhook yönetimi açık bağlantı bulunamadı. Açık, webhooks:manage kapsamlı bağlantı kullanın. invalid_webhook_url: Webhook adresi kabul edilmiyor. Genel internete çözülen, kullanıcı bilgisi içermeyen HTTPS/443 adresi kullanın. invalid_store: Marka bağlantının yetkisinde değil veya kapalı. /me stores listesindeki bir markayı seçin. invalid_event_types: Olay türü geçersiz veya izinli tür yok. Olay kataloğundan tür seçin ve kaynak kapsamını açın. invalid_patch: Düzeltilecek alan veya seçenek uygun değil. Değişmeyecek alanı atlayın; seçeneğin sipariş satırındaki ürüne ait olduğunu ve alan kurallarını kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Webhook adresini güncelle","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","invalid_id","grant_mismatch","invalid_grant","invalid_webhook_url","invalid_store","invalid_event_types","invalid_patch","endpoint_closed"],"x-include-cost":false,"x-notes":"Gönderilen alanlar değişir; atlananlar aynı kalır. Adres veya marka değişimi yeni deneme gerektirir; imza sırrı değişmez. store=null işletme bağlantısında tüm izinli markaları seçer.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Webhook adresini, olay türlerini veya markasını değiştirin.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]}},"/webhook_endpoints/{id}/close":{"post":{"description":"Entegrasyonu durdururken adresi kapatın; teslim geçmişi kalır. Bekleyen teslimler iptal edilir. Yeniden bağlanmak için yeni adres kaydı açın. Gerekli kapsamlar: webhooks:manage. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"close_webhook_endpoints__id__close_post","parameters":[{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","example":"whe_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"example":{"endpoint":{"created_at":"2026-10-16T09:00:00Z","event_types":["order.created"],"grant":"grt_1234567890abcdef1234567890abcdef","id":"whe_1234567890abcdef1234567890abcdef","last_attempt_at":null,"last_error":null,"last_success_at":null,"previous_secret_until":null,"schema_version":1,"status":"pending_test","store":"sto_1234567890abcdef1234567890abcdef","store_name":"Örnek Marka","url":"https://example.com/webhooks/siparis"}},"schema":{"$ref":"#/components/schemas/EndpointResult"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Webhook adresini kapat","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","invalid_id"],"x-include-cost":false,"x-notes":"Bekleyen teslimler iptal edilir. Yeniden bağlanmak için yeni adres kaydı açın.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Entegrasyonu durdururken adresi kapatın; teslim geçmişi kalır.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]}},"/webhook_endpoints/{id}/deliveries":{"get":{"description":"Bir adrese yapılan teslimlerin başarısını, hatasını ve sonraki deneme zamanını izleyin. Kalıcı teslim özetleri en yeniden eskiye gelir. Gerekli kapsamlar: webhooks:manage. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"deliveries_webhook_endpoints__id__deliveries_get","parameters":[{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","example":"whe_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"attempt_count":0,"created_at":"2026-10-16T09:00:00Z","event":"evt_1234567890abcdef1234567890abcdef","id":"whd_1234567890abcdef1234567890abcdef","last_error":null,"last_status":null,"next_attempt_at":"2026-10-16T09:00:00Z","status":"pending","type":"order.created"}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Delivery_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Webhook teslimlerini listele","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"Kalıcı teslim özetleri en yeniden eskiye gelir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bir adrese yapılan teslimlerin başarısını, hatasını ve sonraki deneme zamanını izleyin.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]}},"/webhook_endpoints/{id}/deliveries/{delivery}/attempts":{"get":{"description":"Bir teslimin her denemesindeki HTTP durumunu ve süreyi görün. En yeniden eskiye gelir. Son 90 günlük deneme ayrıntıları tutulur; daha eski teslim özetleri kalır. Gerekli kapsamlar: webhooks:manage. Sayfalama: limit varsayılan 50, en çok 100; offset ve toplam sayım yoktur. next_cursor değerini aynı süzgeç ve yetkiyle cursor olarak gönderin; imleci çözmeyin. Kaynak listesinde has_more=false ve next_cursor=null olduğunda durun.","operationId":"attempts_webhook_endpoints__id__deliveries__delivery__attempts_get","parameters":[{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","example":"whe_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Webhook teslimi dış kimliği (whd_ ve 32 küçük onaltılık karakter).","example":"whd_1234567890abcdef1234567890abcdef","in":"path","name":"delivery","required":true,"schema":{"description":"Webhook teslimi dış kimliği (whd_ ve 32 küçük onaltılık karakter).","examples":["whd_1234567890abcdef1234567890abcdef"],"title":"Delivery","type":"string"}},{"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","example":"SUNUCUDAN_DONEN_IMLEC","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"maxLength":4096,"type":"string"},{"type":"null"}],"description":"Önceki yanıttaki next_cursor; aynı yetki ve süzgeçlerle değiştirmeden gönderin.","examples":["SUNUCUDAN_DONEN_IMLEC"],"title":"Cursor"}},{"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","example":50,"in":"query","name":"limit","required":false,"schema":{"default":50,"description":"Sayfa başına en fazla kayıt/olay adayı; varsayılan 50, aralık 1–100.","examples":[50],"maximum":100,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"data":[{"attempted_at":"2026-10-16T09:00:00Z","duration_ms":120,"error":null,"id":"wha_1234567890abcdef1234567890abcdef","status_code":200}],"has_more":false,"next_cursor":null},"schema":{"$ref":"#/components/schemas/Page_Attempt_"}}},"description":"İstek başarıyla tamamlandı.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"invalid_cursor":{"summary":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","value":{"code":"invalid_cursor","detail":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_cursor"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. invalid_cursor: İmleç kaynak, yetki veya süzgeçle uyuşmuyor. Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Teslim denemelerini listele","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","invalid_cursor","invalid_id"],"x-include-cost":false,"x-notes":"En yeniden eskiye gelir. Son 90 günlük deneme ayrıntıları tutulur; daha eski teslim özetleri kalır.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Bir teslimin her denemesindeki HTTP durumunu ve süreyi görün.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]}},"/webhook_endpoints/{id}/resend":{"post":{"description":"Alıcınızdaki sorun düzeldikten sonra kaçırılan bir olayı yeniden gönderin. Bu adrese gönderilebilen kalıcı olay yeniden kuyruğa alınır; evt_ kimliğiyle tekilleştirme alıcıda sürmelidir. Gerekli kapsamlar: webhooks:manage. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"resend_webhook_endpoints__id__resend_post","parameters":[{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","example":"whe_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{"event":"evt_1234567890abcdef1234567890abcdef"},"schema":{"$ref":"#/components/schemas/Replay"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"attempt_count":0,"created_at":"2026-10-16T09:00:00Z","event":"evt_1234567890abcdef1234567890abcdef","id":"whd_1234567890abcdef1234567890abcdef","last_error":null,"last_status":null,"next_attempt_at":"2026-10-16T09:00:00Z","status":"pending","type":"order.created"},"schema":{"$ref":"#/components/schemas/Delivery"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"delivery_in_progress":{"summary":"Bu adrese teslim sürüyor.","value":{"code":"delivery_in_progress","detail":"Bu adrese teslim sürüyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:delivery_in_progress"}},"endpoint_inactive":{"summary":"Webhook adresi henüz etkin değil.","value":{"code":"endpoint_inactive","detail":"Webhook adresi henüz etkin değil.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:endpoint_inactive"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. endpoint_inactive: Webhook adresi henüz etkin değil. Önce imzalı deneme gönderip alıcıdan 2xx alın. delivery_in_progress: Bu adrese teslim sürüyor. Teslimin tamamlanmasını bekleyip yeniden gönderin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Olayı yeniden gönder","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","invalid_id","endpoint_inactive","delivery_in_progress"],"x-include-cost":false,"x-notes":"Bu adrese gönderilebilen kalıcı olay yeniden kuyruğa alınır; evt_ kimliğiyle tekilleştirme alıcıda sürmelidir.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Alıcınızdaki sorun düzeldikten sonra kaçırılan bir olayı yeniden gönderin.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]}},"/webhook_endpoints/{id}/rotate_secret":{"post":{"description":"İmza sırrını değiştirin; eski sır bir süre daha geçerli kalır. Yeni imza sırrı bir kez verilir. Önceki sır overlap_hours boyunca geçerli kalır; alıcı iki sırrı da kabul etmelidir. Önceki geçiş sürüyorsa bitmesini bekleyin. Belirsiz sonucu otomatik yeniden denemeyin. Gerekli kapsamlar: webhooks:manage. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"rotate_webhook_endpoints__id__rotate_secret_post","parameters":[{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","example":"whe_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"requestBody":{"content":{"application/json":{"example":{},"schema":{"$ref":"#/components/schemas/Rotation"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"endpoint":{"created_at":"2026-10-16T09:00:00Z","event_types":["order.created"],"grant":"grt_1234567890abcdef1234567890abcdef","id":"whe_1234567890abcdef1234567890abcdef","last_attempt_at":null,"last_error":null,"last_success_at":null,"previous_secret_until":null,"schema_version":1,"status":"pending_test","store":"sto_1234567890abcdef1234567890abcdef","store_name":"Örnek Marka","url":"https://example.com/webhooks/siparis"},"secret":"whsec_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="},"schema":{"$ref":"#/components/schemas/EndpointResult"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}},"rotation_unavailable":{"summary":"Adres kapalı veya önceki sır geçişi sürüyor.","value":{"code":"rotation_unavailable","detail":"Adres kapalı veya önceki sır geçişi sürüyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:rotation_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. rotation_unavailable: Adres kapalı veya önceki sır geçişi sürüyor. Önceki geçişin bitmesini bekleyin; kapalı adres için yeni kayıt açın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Webhook sırrını yenile","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","invalid_id","rotation_unavailable"],"x-include-cost":false,"x-notes":"Yeni imza sırrı bir kez verilir. Önceki sır overlap_hours boyunca geçerli kalır; alıcı iki sırrı da kabul etmelidir. Önceki geçiş sürüyorsa bitmesini bekleyin. Belirsiz sonucu otomatik yeniden denemeyin.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"İmza sırrını değiştirin; eski sır bir süre daha geçerli kalır.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]}},"/webhook_endpoints/{id}/test":{"post":{"description":"Kurulumda veya adresi yeniden açarken adresinize imzalı bir deneme bildirimi gönderin. webhook.test teslimini kuyruğa alır. HTTP yanıtı teslimin alıcıya ulaştığı anlamına gelmez, teslim durumunu izleyin. Gerekli kapsamlar: webhooks:manage. Idempotency-Key zorunludur ve bağlantı (grant) ad alanındadır; anahtar döndürmek bunu değiştirmez. Aynı yöntem/yol/gövde/If-Match ile tekrar işlemi yeniden yürütmez; ilk HTTP durumunu ve Location başlığını korur, Idempotent-Replayed: true ekler. Başarılı yanıt güncel kayıttan güncel kapsam ve maskelemeyle üretilir; ETag güncel sürüm etiketidir. Anonimleştirilmiş kişisel bilgiler geri dönmez; webhook sırrı tekrarda gösterilmez. Farklı içerik 422, ilk işlem sürerken 409 döner. Makbuzlar en az 30 gün korunur; temizlik 90 gün için ayrı iştir. Kaydedilen 4xx yanıtından sonra isteği düzeltirken yeni tekrar anahtarı kullanın.","operationId":"test_webhook_endpoints__id__test_post","parameters":[{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","example":"whe_1234567890abcdef1234567890abcdef","in":"path","name":"id","required":true,"schema":{"description":"Okunacak kaynağın whe_ önekli dış kimliği.","examples":["whe_1234567890abcdef1234567890abcdef"],"title":"Id","type":"string"}},{"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","example":"ilk-esitleme-20261016-001","in":"header","name":"idempotency-key","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Zorunlu tekrar anahtarı; en çok 200 karakter. Yeni işte yeni değer; ağ tekrarında aynı gövde ve aynı değer.","examples":["ilk-esitleme-20261016-001"],"title":"Idempotency-Key"}}],"responses":{"200":{"content":{"application/json":{"example":{"attempt_count":0,"created_at":"2026-10-16T09:00:00Z","event":"evt_1234567890abcdef1234567890abcdef","id":"whd_1234567890abcdef1234567890abcdef","last_error":null,"last_status":null,"next_attempt_at":"2026-10-16T09:00:00Z","status":"pending","type":"order.created"},"schema":{"$ref":"#/components/schemas/Delivery"}}},"description":"İstek başarıyla tamamlandı.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"400":{"content":{"application/problem+json":{"examples":{"idempotency_key_required":{"summary":"Tekrar anahtarı eksik.","value":{"code":"idempotency_key_required","detail":"Tekrar anahtarı eksik.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:idempotency_key_required"}},"invalid_request":{"summary":"İstek biçimi geçersiz.","value":{"code":"invalid_request","detail":"İstek biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:invalid_request"}},"key_in_query":{"summary":"Anahtar URL sorgusuna yazılmış.","value":{"code":"key_in_query","detail":"Anahtar URL sorgusuna yazılmış.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:key_in_query"}},"unsupported_api_version":{"summary":"İstenen sürüm desteklenmiyor.","value":{"code":"unsupported_api_version","detail":"İstenen sürüm desteklenmiyor.","errors":[],"request_id":"req_ornek_20261016","status":400,"title":"Bad Request","type":"urn:siparis:problem:unsupported_api_version"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_request: İstek biçimi geçersiz. Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir. key_in_query: Anahtar URL sorgusuna yazılmış. Anahtarı yalnız Authorization: Bearer başlığında gönderin. unsupported_api_version: İstenen sürüm desteklenmiyor. Siparis-Version başlığını v1 yapın veya kaldırın. idempotency_key_required: Tekrar anahtarı eksik. Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"401":{"content":{"application/problem+json":{"examples":{"invalid_api_key":{"summary":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","value":{"code":"invalid_api_key","detail":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:invalid_api_key"}},"live_key_in_sandbox":{"summary":"Canlı anahtar deneme ortamında kullanılamaz.","value":{"code":"live_key_in_sandbox","detail":"Canlı anahtar deneme ortamında kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:live_key_in_sandbox"}},"test_key_in_live":{"summary":"Deneme anahtarı canlı ortamda kullanılamaz.","value":{"code":"test_key_in_live","detail":"Deneme anahtarı canlı ortamda kullanılamaz.","errors":[],"request_id":"req_ornek_20261016","status":401,"title":"Unauthorized","type":"urn:siparis:problem:test_key_in_live"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"invalid_api_key: Anahtar geçersiz, süresi dolmuş veya iptal edilmiş. Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin. test_key_in_live: Deneme anahtarı canlı ortamda kullanılamaz. spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın. live_key_in_sandbox: Canlı anahtar deneme ortamında kullanılamaz. Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"403":{"content":{"application/problem+json":{"examples":{"insufficient_scope":{"summary":"Gerekli kapsam eksik.","value":{"code":"insufficient_scope","detail":"Gerekli kapsam eksik.","errors":[],"request_id":"req_ornek_20261016","status":403,"title":"Forbidden","type":"urn:siparis:problem:insufficient_scope"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"insufficient_scope: Gerekli kapsam eksik. İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"404":{"content":{"application/problem+json":{"examples":{"not_found":{"summary":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","value":{"code":"not_found","detail":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","errors":[],"request_id":"req_ornek_20261016","status":404,"title":"Not Found","type":"urn:siparis:problem:not_found"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"not_found: Kayıt/uç yok veya anahtarın marka sınırında görünmüyor. Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"405":{"content":{"application/problem+json":{"examples":{"method_not_allowed":{"summary":"Uç HTTP yöntemini desteklemiyor.","value":{"code":"method_not_allowed","detail":"Uç HTTP yöntemini desteklemiyor.","errors":[],"request_id":"req_ornek_20261016","status":405,"title":"Method Not Allowed","type":"urn:siparis:problem:method_not_allowed"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"method_not_allowed: Uç HTTP yöntemini desteklemiyor. Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"409":{"content":{"application/problem+json":{"examples":{"endpoint_closed":{"summary":"Webhook adresi kapalı.","value":{"code":"endpoint_closed","detail":"Webhook adresi kapalı.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:endpoint_closed"}},"idempotency_in_progress":{"summary":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","value":{"code":"idempotency_in_progress","detail":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","errors":[],"request_id":"req_ornek_20261016","status":409,"title":"Conflict","type":"urn:siparis:problem:idempotency_in_progress"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"idempotency_in_progress: Aynı tekrar anahtarıyla istek hâlâ işleniyor. Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin. endpoint_closed: Webhook adresi kapalı. Yeni adres kaydı oluşturun ve imzalı denemeyi tamamlayın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"422":{"content":{"application/problem+json":{"examples":{"idempotency_key_reused":{"summary":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","value":{"code":"idempotency_key_reused","detail":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:idempotency_key_reused"}},"invalid_id":{"summary":"Kaynak kimliğinin öneki veya biçimi geçersiz.","value":{"code":"invalid_id","detail":"Kaynak kimliğinin öneki veya biçimi geçersiz.","errors":[],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:invalid_id"}},"validation_error":{"summary":"İstek alanı veya değeri geçersiz.","value":{"code":"validation_error","detail":"İstek alanı veya değeri geçersiz.","errors":[{"code":"less_than_equal","detail":"Bu alanı kontrol edin.","field":"query.limit"}],"request_id":"req_ornek_20261016","status":422,"title":"Unprocessable Entity","type":"urn:siparis:problem:validation_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"validation_error: İstek alanı veya değeri geçersiz. errors içindeki field ve code değerlerine göre isteği düzeltin. idempotency_key_reused: Aynı tekrar anahtarı farklı gövdeyle kullanılmış. Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın. invalid_id: Kaynak kimliğinin öneki veya biçimi geçersiz. Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"429":{"content":{"application/problem+json":{"examples":{"rate_limit_exceeded":{"summary":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","value":{"code":"rate_limit_exceeded","detail":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","errors":[],"request_id":"req_ornek_20261016","status":429,"title":"Too Many Requests","type":"urn:siparis:problem:rate_limit_exceeded"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"rate_limit_exceeded: Okuma veya hatalı anahtar hız sınırına ulaşıldı. Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"RateLimit":{"description":"Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";r=598;t=60"],"type":"string"}},"RateLimit-Policy":{"description":"Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz.","schema":{"examples":["\"read\";q=600;w=60"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["60"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"500":{"content":{"application/problem+json":{"examples":{"internal_error":{"summary":"Sunucu isteği tamamlayamadı.","value":{"code":"internal_error","detail":"Sunucu isteği tamamlayamadı.","errors":[],"request_id":"req_ornek_20261016","status":500,"title":"Internal Server Error","type":"urn:siparis:problem:internal_error"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"internal_error: Sunucu isteği tamamlayamadı. Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}},"503":{"content":{"application/problem+json":{"examples":{"service_unavailable":{"summary":"Servis geçici olarak yoğun veya erişilemiyor.","value":{"code":"service_unavailable","detail":"Servis geçici olarak yoğun veya erişilemiyor.","errors":[],"request_id":"req_ornek_20261016","status":503,"title":"Service Unavailable","type":"urn:siparis:problem:service_unavailable"}}},"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"service_unavailable: Servis geçici olarak yoğun veya erişilemiyor. Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","headers":{"Idempotent-Replayed":{"description":"Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur.","schema":{"examples":["true"],"type":"string"}},"Retry-After":{"description":"Yeniden denemeden önce beklenecek saniye sayısı.","schema":{"examples":["5"],"type":"string"}},"Siparis-Version":{"description":"Yanıtın API ana sürümü.","schema":{"const":"v1","examples":["v1"],"type":"string"}},"X-Request-ID":{"description":"Destek için istek takip kimliği.","schema":{"examples":["req_ornek_20261016"],"type":"string"}}}}},"security":[{"HTTPBearer":[]},{"oauth2":["webhooks:manage"]}],"summary":"Webhook denemesi gönder","tags":["Olaylar ve Webhook"],"x-data-class":"metadata","x-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","invalid_id","endpoint_closed"],"x-include-cost":false,"x-notes":"webhook.test teslimini kuyruğa alır. HTTP yanıtı teslimin alıcıya ulaştığı anlamına gelmez, teslim durumunu izleyin.","x-optional-scopes":[],"x-personal-data":false,"x-purpose":"Kurulumda veya adresi yeniden açarken adresinize imzalı bir deneme bildirimi gönderin.","x-read-cost":1,"x-required-scopes":["webhooks:manage"]}}},"servers":[{"description":"Canlı ortam","url":"https://api.siparis.app/v1"},{"description":"Deneme ortamı","url":"https://api.sandbox.siparis.app/v1"}],"tags":[{"description":"Sipariş açın, listeleyin, onaylayın, teslim edin, düzeltin ve iptal edin.","name":"Siparişler","x-operations":["POST /orders","GET /orders","GET /orders/{id}","POST /orders/{id}/confirm","POST /orders/{id}/processing","POST /orders/{id}/ready","POST /orders/{id}/deliver","POST /orders/{id}/payment-received","POST /orders/{id}/cancel","PATCH /orders/{id}","POST /orders/{id}/correct-status","GET /orders/{id}/lines","GET /orders/{id}/payments","GET /orders/{id}/history"]},{"description":"Müşteri kartını bulun, ekleyin, güncelleyin, arşivleyin veya KVKK için anonimleştirin.","name":"Müşteriler","x-operations":["POST /customers","GET /customers","GET /customers/{id}","PATCH /customers/{id}","POST /customers/{id}/archive","POST /customers/{id}/restore","POST /customers/{id}/anonymize"]},{"description":"Ürün, seçenek, kategori, ürün markası ve markaya özel fiyat.","name":"Ürünler","x-operations":["POST /products","GET /products","GET /products/{id}","PATCH /products/{id}","POST /products/{id}/archive","POST /products/{id}/restore","POST /products/{id}/variants","GET /variants","GET /variants/{id}","PATCH /variants/{id}","POST /variants/{id}/archive","PUT /store-prices/{store}/{product}","GET /store-prices","GET /store-prices/{store}/{product}","POST /categories","GET /categories","GET /categories/{id}","PATCH /categories/{id}","POST /categories/{id}/archive","POST /categories/{id}/restore","POST /brands","GET /brands","GET /brands/{id}","PATCH /brands/{id}","POST /brands/{id}/archive","POST /brands/{id}/restore"]},{"description":"Depodaki miktarlar, stok girişi, sayım, fire, depolar arası taşıma ve stok geçmişi.","name":"Stok","x-operations":["GET /inventory/levels","POST /inventory/receipts","POST /inventory/counts","POST /inventory/write_offs","POST /inventory/transfers","GET /inventory/movements","GET /inventory/documents/{id}","POST /inventory/documents/{id}/reverse","GET /locations"]},{"description":"Kargo fiyatı sorun, BasitKargo gönderisi açın, etiket indirin ve iptal edin.","name":"Kargo","x-operations":["POST /orders/{id}/shipments/quote","POST /orders/{id}/shipments","GET /shipments/{id}","GET /shipments/{id}/label","POST /shipments/{id}/cancel","GET /orders/{id}/shipments"]},{"description":"İade talebini karara bağlayın, ürünü geri alın ve parayı iade edin.","name":"İade","x-operations":["POST /orders/{id}/refunds/preview","POST /orders/{id}/refunds","GET /refunds/{id}","POST /refunds/{id}/money-returned","GET /orders/{id}/returns","GET /returns/{id}","POST /returns/{id}/approve","POST /returns/{id}/reject"]},{"description":"Fatura kesin, belgesini indirin ve iptal edin.","name":"Fatura","x-operations":["POST /orders/{id}/invoices/preview","POST /orders/{id}/invoices","GET /invoices/{id}","GET /invoices/{id}/document","POST /invoices/{id}/cancel/preview","POST /invoices/{id}/cancel","GET /orders/{id}/invoices"]},{"description":"Ödemesi başka kanalda alınmış satışı stoğa ve sipariş listesine işleyin.","name":"Başka kanaldaki satış","x-operations":["POST /external_orders"]},{"description":"Binlerce satırlık fiyat ve stok güncellemesini tek işte yapın.","name":"Toplu işler","x-operations":["POST /bulk/prices","POST /bulk/inventory","GET /jobs/{id}","GET /jobs/{id}/errors"]},{"description":"İndirim kuponlarını ekleyin, güncelleyin ve arşivleyin.","name":"Kuponlar","x-operations":["POST /coupons","GET /coupons","GET /coupons/{id}","PATCH /coupons/{id}","POST /coupons/{id}/archive","POST /coupons/{id}/restore"]},{"description":"Değişiklikleri olay akışından okuyun ya da adresinize imzalı bildirim alın.","name":"Olaylar ve Webhook","x-operations":["GET /events","GET /events/{id}","POST /webhook_endpoints","GET /webhook_endpoints","GET /webhook_endpoints/{id}","PATCH /webhook_endpoints/{id}","POST /webhook_endpoints/{id}/test","POST /webhook_endpoints/{id}/rotate_secret","POST /webhook_endpoints/{id}/resend","GET /webhook_endpoints/{id}/deliveries","GET /webhook_endpoints/{id}/deliveries/{delivery}/attempts","POST /webhook_endpoints/{id}/close"]},{"description":"İlk eşitleme için tutarlı JSONL/CSV dosyası hazırlayın ve indirin.","name":"Dışa aktarma","x-operations":["POST /exports","GET /exports/{id}","GET /files/{id}"]},{"description":"Başka satıcılar için uygulama yapmak (OAuth: /oauth/authorize, /oauth/token) ve AI asistanını /mcp adresine bağlamak. Uygulamalar ve MCP aynı REST uçlarını ve kapsamları kullanır.","externalDocs":{"url":"https://developer.siparis.app/uygulama-yapmak"},"name":"Uygulamalar (OAuth) ve MCP","x-operations":[]},{"description":"Bağlantıyı doğrulayın; işletmeyi ve markaları okuyun.","name":"Hesap","x-operations":["GET /me","GET /business","GET /stores"]},{"description":"Makinenin okuyacağı OpenAPI sözleşmesi.","name":"Referans","x-operations":["GET /openapi.json"]}],"x-code-tables":[{"field":"Order.status","id":"siparis-durumlari","intro":"Olağan akış: Yeni → Onaylandı → Hazırlanıyor → Kargoda → Teslim edildi. Açık sipariş iptal edilebilir; teslimden sonra iade gelir. Yanlış seçilen durum Sipariş durumunu düzelt ile gerekçe yazılarak düzeltilir.","request":{"endpoint":"POST /orders/{id}/correct-status","field":"CorrectOrderStatus.status"},"rows":[{"accepted":true,"code":"pending","name":"Yeni","when":"Sipariş geldi veya açıldı, henüz onaylanmadı. Vitrinden gelen havale veya kartlı siparişte ödeme gelince onaylanır; ödeme payment_state alanındadır. Sonraki adım: Siparişi onayla ya da Siparişi iptal et."},{"accepted":true,"code":"payment_pending","name":"Ödeme bekliyor","when":"Eski değer: 19 Ekim 2026'ya kadar havale veya kart ödemesi beklenen sipariş. Artık hiçbir sipariş bu durumda olmaz; yalnız eski olaylarda (previous_status, webhook changes) görülür. Süzgeçte kabul edilir, boş sonuç verir; durum düzeltmede 409 döner. Ödeme payment_state alanındadır."},{"accepted":true,"code":"confirmed","name":"Onaylandı","when":"Onaylandı; hazırlanmayı veya kargoya verilmeyi bekliyor. Sonraki adım: Siparişi hazırlamaya başla, Gönderi oluştur ya da Siparişi teslim et."},{"accepted":true,"code":"processing","name":"Hazırlanıyor","when":"Hazırlanıyor; markadan teslimde \"teslim almaya hazır\" bilgisi de bu durumdadır. Sonraki adım: Gönderi oluştur ya da Siparişi teslim et."},{"accepted":true,"code":"shipped","name":"Kargoda","when":"Kargoya verildi; teslim bilgisi kargo firmasından gelir."},{"accepted":true,"code":"delivered","name":"Teslim edildi","when":"Müşteriye teslim edildi. Sonrasında yalnız iade ile İade edildi olabilir."},{"accepted":true,"code":"cancelled","name":"İptal","when":"İptal edildi; stok geri geldi. Son durumdur."},{"accepted":false,"code":"refunded","name":"İade edildi","when":"Teslimden sonra ürünler iade edildi. Son durumdur."}],"title":"Sipariş durumları"},{"field":"Order.payment_method","id":"odeme-yontemleri","intro":"Okunan siparişte gelen ödeme yöntemi.","request":{"endpoint":"POST /orders","field":"CreateOrder.payment_method"},"rows":[{"accepted":true,"code":"cod","name":"Kapıda ödeme","when":"Kapıda ödeme: kurye tahsil eder (cod_type: cash nakit, card kart). Markadan veya elden teslimde \"Teslimatta ödeme\" görünür."},{"accepted":true,"code":"bank_transfer","name":"Havale/EFT","when":"Havale veya EFT."},{"accepted":true,"code":"credit_card","name":"Kart","when":"Kartla ödeme: vitrinde çevrimiçi kart ya da POS cihazıyla alınmış ödeme; POS ile alınan siparişi de bu kodla açın. API karttan para çekmez. Tahsilat yazarken (Alınan ödemeyi kaydet) POS’un yöntem kodu pos’tur."},{"accepted":true,"code":"split","name":"Parçalı ödeme","when":"Birden çok yöntemle alınan ödeme."},{"accepted":true,"code":"cash","name":"Nakit","when":"Nakit."},{"accepted":false,"code":"marketplace","name":"Pazaryeri","when":"Ödemeyi pazaryeri veya başka satış kanalı aldı. Siparişte gönderilmez; ödemesi başka kanalda alınmış satışı Başka kanaldaki satışı bildir (POST /v1/external_orders) ile kaydedin."}],"title":"Ödeme yöntemleri"},{"field":"Order.payment_state","id":"odeme-durumlari","intro":"Sipariş durumundan ayrıdır; alınan ve iade edilen paradan hesaplanır, siz yazmazsınız.","rows":[{"code":"none","name":"Ödeme yok","when":"Beklenen ödeme yok; ör. kuponla 0 TL olan sipariş."},{"code":"awaiting","name":"Ödeme bekleniyor","when":"Hiç ödeme alınmadı; tutarın tamamı bekleniyor. Havalede \"Havale bekleniyor\" görünür."},{"code":"partial","name":"Kısmen ödendi","when":"Bir kısmı alındı (ör. kapora); kalan bekleniyor."},{"code":"paid","name":"Ödendi","when":"Tutarın tamamı alındı."},{"code":"refund_due","name":"İade edilecek","when":"Alınan para sipariş tutarını aşıyor; fark müşteriye iade edilecek. Açık siparişte \"Fazla ödendi\" görünür."},{"code":"refunded","name":"İade edildi","when":"Alınan para müşteriye iade edildi."},{"code":"test","name":"Test ödemesi","when":"Ödeme sağlayıcısının deneme kipinde alınmış ödeme; gerçek para değildir."}],"title":"Ödeme durumları"},{"field":"Order.delivery_method","id":"teslim-yontemleri","intro":"Pazaryeri siparişlerinde boş (null) olabilir.","request":{"endpoint":"POST /orders","field":"CreateOrder.delivery_method"},"rows":[{"accepted":true,"code":"shipping","name":"Kargo","when":"Kargoyla gönderilir; müşteri ve teslimat adresi gerekir."},{"accepted":true,"code":"hand","name":"Elden teslim","when":"Siz veya kuryeniz elden teslim edersiniz; kargo gönderisi açılmaz."},{"accepted":true,"code":"pickup","name":"Markadan teslim","when":"Müşteri siparişi markanızın adresinden teslim alır."},{"accepted":true,"code":"digital","name":"Dijital teslim","when":"Kargo gerekmez; dijital ürün e-postayla teslim edilir."}],"title":"Teslim yöntemleri"},{"field":"Shipment.state","id":"gonderi-ortak-durumlari","intro":"Kargo firmasından bağımsız durum; entegrasyonunuzu buna bağlayın. Olaylarda da aynı değerler gelir.","rows":[{"code":"draft","name":"Taslak","when":"Gönderi kargo firmasında taslakta; kargo kodu yok ya da kod iptal edildi."},{"code":"ready","name":"Gönderime hazır","when":"Kargo kodu alındı, kurye paketi henüz almadı; iptal edilebilir."},{"code":"in_transit","name":"Yolda","when":"Kurye paketi aldı; dağıtımda, gecikmede veya kargo firması sorun bildirdiğinde de bu durumdadır."},{"code":"delivered","name":"Teslim edildi","when":"Paket alıcıya teslim edildi."},{"code":"returning","name":"Geri dönüyor","when":"Paket göndericiye geri dönüyor."},{"code":"returned","name":"Geri döndü","when":"Paket göndericiye geri döndü."},{"code":"lost","name":"Kayıp","when":"Kargo firması paketi kayıp bildirdi."},{"code":"cancelled","name":"İptal","when":"Gönderi iptal edildi veya kargo firmasında silindi."}],"title":"Gönderi ortak durumları"},{"field":"Shipment.status","id":"gonderi-durumlari","intro":"Kargo firmasının bildirdiği kod aynen gelir; büyük harfli kodlar BasitKargo’nundur. Firmadan bağımsız okumak için state.","rows":[{"code":"pending","name":"Açılıyor","when":"Gönderi açma isteği kuyrukta; sonucu Gönderiyi getir ile izleyin."},{"code":"failed","name":"Açılamadı","when":"Gönderi açılamadı; error_code nedenini söyler."},{"code":"created","name":"Oluşturuldu","when":"Kargo kodu alındı, kurye paketi henüz almadı."},{"code":"NEW","name":"Yeni","when":"Kargo firmasında taslak olarak açıldı."},{"code":"READY_TO_SHIP","name":"Gönderime hazır","when":"Paket kuryeye verilmeyi bekliyor."},{"code":"SHIPPED","name":"Yolda","when":"Kurye paketi aldı."},{"code":"OUT_FOR_DELIVERY","name":"Dağıtımda","when":"Paket alıcıya dağıtıma çıktı."},{"code":"DELIVERED","name":"Teslim edildi","when":"Paket alıcıya teslim edildi."},{"code":"COMPLETED","name":"Teslim edildi","when":"Eski kayıtlarda teslim edildi."},{"code":"NEEDS_SUPPORT","name":"Sorunlu","when":"Kargo firması destek istiyor; BasitKargo panelinden bakın."},{"code":"DELAYED","name":"Gecikmeli","when":"Teslim gecikti."},{"code":"RETURNING","name":"Geri dönüyor","when":"Paket göndericiye geri dönüyor."},{"code":"RETURNED","name":"Geri döndü","when":"Paket göndericiye geri döndü."},{"code":"LOST","name":"Kayıp","when":"Kargo firması paketi kayıp bildirdi."},{"code":"DELETED","name":"İptal","when":"Gönderi kargo firmasında silindi."},{"code":"cancelled","name":"İptal","when":"Gönderi iptal edildi."}],"title":"Gönderi durumları"},{"field":"Shipment.cod_state","id":"kapida-odeme-durumlari","intro":"Kurye tahsilatının kargo firmasından bağımsız durumu; para BasitKargo üzerinden size geçer. Gönderinin cod_status alanı da aynı değerleri taşır.","rows":[{"code":"pending","name":"Tahsil edilecek","when":"Kurye teslimde parayı alacak veya tahsilat bilgisi kargo firmasından bekleniyor."},{"code":"collected","name":"Tahsil edildi","when":"Kurye parayı aldı; BasitKargo’nun size aktarması bekleniyor."},{"code":"settled","name":"Aktarıldı","when":"BasitKargo parayı size aktardı."},{"code":"settled_direct","name":"Kargo firması öder","when":"Kurye parayı aldı; kargo firması kendi anlaşmanızla doğrudan size öder."},{"code":"not_collected","name":"Tahsil edilmedi","when":"Para tahsil edilmedi (ör. alıcı paketi almadı)."}],"title":"Kapıda ödeme durumları"},{"field":"Return.status","id":"iade-durumlari","intro":"Müşteri talebinden paranın iadesine kadar.","rows":[{"code":"requested","name":"Talep geldi","when":"Müşteri talep açtı; kararınız bekleniyor."},{"code":"approved","name":"Onaylandı","when":"Talep onaylandı; ürünün gelmesi bekleniyor."},{"code":"declined","name":"Reddedildi","when":"Talep reddedildi. Son durumdur."},{"code":"code_sent","name":"Kargo kodu verildi","when":"Müşteriye geri gönderim kargo kodu verildi."},{"code":"arrived","name":"Ürün geldi","when":"Ürün size ulaştı; kontrol ve para iadesi bekliyor."},{"code":"refund_pending","name":"Müşteriye iade edilecek","when":"Para müşteriye iade edilecek."},{"code":"refunded","name":"Para iade edildi","when":"Para müşteriye iade edildi. Son durumdur."},{"code":"exchanged","name":"Tamamlandı","when":"Değişim tamamlandı. Son durumdur."},{"code":"closed","name":"Kapandı","when":"Kayıt kapandı."},{"code":"exchange_cancelled","name":"Değişim iptal edildi","when":"Değişim siparişi iptal edildi; paranın iadesi veya değişimin geri alınması kararınızı bekliyor."}],"title":"İade durumları"},{"field":"Return.kind","id":"iade-turleri","intro":"","rows":[{"code":"return","name":"İade","when":"Ürün geri gelir, para iade edilir."},{"code":"exchange","name":"Değişim","when":"Ürün başka bir ürünle veya seçenekle değiştirilir."},{"code":"money","name":"Yalnız para iadesi","when":"Ürün dönmez; fiyat farkı veya tazminat ödenir."}],"title":"İade türleri"},{"field":"RefundResult.card_status","id":"kart-iadesi-durumlari","intro":"Kart iadesinde sorun yoksa alan null gelir.","rows":[{"code":"pending","name":"Sürüyor","when":"Kart iadesi sağlayıcıya iletildi, sonucu bekleniyor."},{"code":"blocked","name":"Durdu","when":"Kart iadesi başlatılamadı; paneldeki açıklamaya göre ilerleyin."},{"code":"unknown","name":"Sonuç belirsiz","when":"Sağlayıcı yanıt vermedi; yeniden başlatmayın, sağlayıcı panelinde doğrulayın."},{"code":"failed","name":"Başarısız","when":"Kart iadesi yapılamadı."}],"title":"Kart iadesi durumları"},{"field":"Invoice.status","id":"fatura-durumlari","intro":"","rows":[{"code":"pending","name":"Hazırlanıyor","when":"Fatura sağlayıcıya gönderildi; numara bekleniyor."},{"code":"issued","name":"Kesildi","when":"Fatura kesildi; belge indirilebilir."},{"code":"failed","name":"Kesilemedi","when":"Sağlayıcı faturayı kesemedi; error_code nedenini söyler."},{"code":"cancelled","name":"İptal edildi","when":"Fatura iptal edildi."}],"title":"Fatura durumları"},{"field":"Invoice.cancellation_status","id":"fatura-iptal-durumlari","intro":"İptal istenmediyse alan yoktur.","rows":[{"code":"pending","name":"İptal sürüyor","when":"İptal sağlayıcıya iletildi; fatura bu sırada issued kalır."},{"code":"unknown","name":"Sonuç belirsiz","when":"Sağlayıcı yanıt vermedi; portalda doğrulayıp portal_done=true gönderin."},{"code":"failed","name":"İptal edilemedi","when":"Sağlayıcı iptali reddetti."},{"code":"succeeded","name":"İptal edildi","when":"İptal tamamlandı."}],"title":"Fatura iptal durumları"},{"field":"Event.type","id":"olay-turleri","intro":"Kalıcı olayları okumak için events:read ve kaynak kapsamı gerekir. webhook.test yalnız ilgili uca gönderilen denemedir; events akışına girmez.","rows":[{"code":"job.completed","name":"İş bitti","when":"Dışa aktarma veya toplu fiyat/stok işi tamamlandı ya da başarısız oldu. Kapsam: exports:write, products:write, inventory:write."},{"code":"order.created","name":"Sipariş oluşturuldu","when":"Vitrin, panel, AI, API veya pazaryerinden yeni sipariş geldi. Kapsam: orders:read."},{"code":"order.updated","name":"Sipariş değişti","when":"Siparişin tutarı, kalemleri, adresi, notları veya alt kayıtları değişti. Kapsam: orders:read."},{"code":"order.status_changed","name":"Sipariş durumu değişti","when":"Sipariş başka bir duruma geçti (ör. Onaylandı → Kargoda). Kapsam: orders:read."},{"code":"collection.recorded","name":"Ödeme alındı","when":"Siparişe tahsilat yazıldı. Kapsam: payments:read."},{"code":"collection.reversed","name":"Ödeme geri alındı","when":"Yanlış kaydedilen tahsilat ters kayıtla geri alındı. Kapsam: payments:read."},{"code":"refund.succeeded","name":"Para iade edildi","when":"Müşteriye para iadesi tamamlandı. Kapsam: payments:read."},{"code":"payment.failed","name":"Kart ödemesi başarısız","when":"PayTR veya iyzico kart denemesi kesin olarak reddedildi; aynı deneme yalnız bir kez bildirilir. Kapsam: payments:read."},{"code":"return.requested","name":"İade/değişim açıldı","when":"Müşteri veya satıcı iade/değişim sürecini açtı. Kapsam: returns:read."},{"code":"return.approved","name":"İade/değişim onaylandı","when":"Talep approved veya code_sent durumuna geçti; bu iki durum arasındaki kod değişikliği yeniden onay değildir. Kapsam: returns:read."},{"code":"return.rejected","name":"İade/değişim reddedildi","when":"Talep declined durumuna geçti. Kapsam: returns:read."},{"code":"return.received","name":"İade ürünü geldi","when":"Ürün ulaştı veya kontrol sonucu kaydedildi; ilk teslim alınma olgusu. Kapsam: returns:read."},{"code":"return.closed","name":"İade/değişim kapandı","when":"Kayıt closed, refunded veya exchanged durumuna geçti. Para ödemesi ayrı refund.succeeded olayıdır. Kapsam: returns:read."},{"code":"invoice.issued","name":"Fatura kesildi","when":"e-Arşiv/e-Fatura kaydı issued oldu. Kapsam: invoices:read."},{"code":"invoice.failed","name":"Fatura kesilemedi","when":"Kesin hata veya sağlayıcı reddiyle failed oldu; belirsiz bekleyiş hata sayılmaz, sağlayıcı metni gönderilmez. Kapsam: invoices:read."},{"code":"invoice.cancelled","name":"Fatura iptal edildi","when":"Fatura cancelled oldu; iptal isteğinin açılması tek başına yeterli değildir. Kapsam: invoices:read."},{"code":"shipment.created","name":"Gönderi açıldı","when":"Siparişe kargo gönderisi açıldı. Kapsam: shipments:read."},{"code":"shipment.status_changed","name":"Gönderi durumu değişti","when":"Kargo firmasından yeni durum geldi veya gönderi iptal edildi. Kapsam: shipments:read."},{"code":"shipment.cod_changed","name":"Kapıda ödeme değişti","when":"Kapıda ödeme tutarı veya tahsilat durumu değişti. Kapsam: shipments:read."},{"code":"inventory.level_changed","name":"Stok miktarı değişti","when":"Bir seçeneğin bir depodaki miktarı değişti. Kapsam: inventory:read."},{"code":"inventory.low","name":"Stok azaldı","when":"Güncel stok, eşik ve marka bağı birlikte değerlendirilir. Yayın öncesi düşük stoklar başlangıç sayılır; yeni seçenek × depoda ilk düşük stok, sonraki düşüş veya etkin eşik değişip stok düşük kaldığında bildirilir. Kapsam: inventory:read."},{"code":"inventory.document_created","name":"Stok belgesi yazıldı","when":"Stok girişi, sayım, fire veya taşıma belgesi oluştu. Kapsam: inventory:read."},{"code":"inventory.document_reversed","name":"Stok belgesi geri alındı","when":"Stok belgesi ters kayıtla düzeltildi. Kapsam: inventory:read."},{"code":"product.created","name":"Ürün oluşturuldu","when":"Yeni ürün açıldı. Kapsam: products:read."},{"code":"product.updated","name":"Ürün değişti","when":"Ürünün bilgileri, fiyatı, satış durumu veya seçenekleri değişti. Kapsam: products:read."},{"code":"product.archived","name":"Ürün arşivlendi","when":"Ürün listeden ve vitrinden kalktı. Kapsam: products:read."},{"code":"product.restored","name":"Ürün geri getirildi","when":"Arşivdeki ürün geri geldi. Kapsam: products:read."},{"code":"variant.created","name":"Seçenek oluşturuldu","when":"Ürüne yeni seçenek eklendi. Kapsam: products:read."},{"code":"variant.updated","name":"Seçenek değişti","when":"Seçeneğin fiyatı veya bilgileri değişti. Kapsam: products:read."},{"code":"variant.archived","name":"Seçenek arşivlendi","when":"Seçenek üründen kaldırıldı. Kapsam: products:read."},{"code":"variant.restored","name":"Seçenek geri getirildi","when":"Arşivdeki seçenek ürünle birlikte geri geldi. Kapsam: products:read."},{"code":"store_product.linked","name":"Ürün markaya eklendi","when":"Ürün bir satış markasında satışa açıldı. Kapsam: products:read."},{"code":"store_product.unlinked","name":"Ürün markadan çıkarıldı","when":"Ürün bir satış markasından kaldırıldı. Kapsam: products:read."},{"code":"store_price.updated","name":"Marka fiyatı değişti","when":"Ürünün veya seçeneğin bir markadaki fiyatı değişti ya da kaldırıldı. Kapsam: products:read."},{"code":"customer.created","name":"Müşteri oluşturuldu","when":"Yeni müşteri kartı açıldı. Kapsam: customers:read."},{"code":"customer.updated","name":"Müşteri değişti","when":"Müşteri kartının bilgileri değişti. Kapsam: customers:read."},{"code":"customer.archived","name":"Müşteri arşivlendi","when":"Müşteri kartı etkin listeden kalktı. Kapsam: customers:read."},{"code":"customer.restored","name":"Müşteri geri getirildi","when":"Arşivdeki müşteri kartı geri geldi. Kapsam: customers:read."},{"code":"customer.anonymized","name":"Müşteri anonimleştirildi","when":"KVKK isteğiyle kişisel bilgiler temizlendi. Kapsam: customers:read."},{"code":"subscription.created","name":"Abonelik başladı","when":"Düzenli teslimatlı sipariş onaylanınca abonelik açıldı; ilk sipariş ve ürün satırlarıyla. Kapsam: subscriptions:read."},{"code":"subscription.renewed","name":"Abonelik siparişi açıldı","when":"Vadesi gelen teslimatın yenileme siparişi açıldı; sipariş kimliği ve teslimat günüyle. Kapsam: subscriptions:read."},{"code":"subscription.payment_issue","name":"Abonelikte ödeme sorunu","when":"Abonelik ödeme sorunu durumuna geçti; yeni teslimat açılmaz. Kart reddi ayrıca payment.failed olayıdır. Kapsam: subscriptions:read."},{"code":"subscription.paused","name":"Abonelik durdu","when":"Abonelik durdu (ürün satıştan kalktı, işletme kapandı veya iptal geri alınıp durmuş haline döndü). Kapsam: subscriptions:read."},{"code":"subscription.resumed","name":"Abonelik sürdü","when":"Durmuş, ödeme sorunlu veya iptal edilmiş abonelik yeniden etkin oldu. Kapsam: subscriptions:read."},{"code":"subscription.cancelled","name":"Abonelik iptal edildi","when":"Müşteri, satıcı veya ilk siparişin iptali aboneliği kapattı; açılmış siparişler değişmez. Kapsam: subscriptions:read."},{"code":"coupon.created","name":"Kupon oluşturuldu","when":"Yeni kupon açıldı. Kapsam: coupons:read."},{"code":"coupon.updated","name":"Kupon değişti","when":"Kuponun kodu, indirimi, geçerliliği, sınırları, kapsamı veya açık/kapalı durumu değişti. Kapsam: coupons:read."},{"code":"coupon.archived","name":"Kupon arşivlendi","when":"Kupon silindi: listeden kalktı, sepette uygulanmaz; siparişlerdeki kupon kalır. Kapsam: coupons:read."},{"code":"coupon.restored","name":"Kupon geri getirildi","when":"Arşivdeki kupon geri geldi. Kapsam: coupons:read."},{"code":"channel.order_imported","name":"Kanal siparişi alındı","when":"Bağlı satış kanalındaki (pazaryeri veya site) yeni sipariş içe alındı; sipariş başına bir kez. Kapsam: channels:read."},{"code":"channel.problem","name":"Kanal bağlantısında sorun","when":"Kanal bağlantısı çalışmıyor (anahtar veya yetki geçersiz, uygulama kaldırıldı): stok gitmez, sipariş gelmez. Sorun sürerken tekrarlanmaz. Kapsam: channels:read."},{"code":"channel.recovered","name":"Kanal bağlantısı düzeldi","when":"Sorunlu kanal bağlantısı yeniden çalışıyor. Kapsam: channels:read."},{"code":"webhook.test","name":"Deneme bildirimi","when":"Uç kurulurken veya deneme istendiğinde imzalı gönderilir; abonelikte seçilmesi gerekmez ve olay akışında bulunmaz. Kapsam: webhooks:manage."}],"title":"Olay türleri"},{"field":"scopes","id":"kapsamlar","intro":"İşletme sahibi anahtar veya uygulama onayı verirken seçer; yazma kapsamı okuma izni vermez.","rows":[{"code":"orders:read","name":"Siparişler · Gör","when":"Siparişleri, satırlarını ve durum geçmişini okumak."},{"code":"orders:write","name":"Siparişler · Değiştir","when":"Sipariş açmak, onaylamak, teslim etmek, düzeltmek, iptal etmek; başka kanaldaki satışı bildirmek."},{"code":"products:read","name":"Ürünler · Gör","when":"Ürün, seçenek, kategori, ürün markası ve marka fiyatlarını okumak."},{"code":"products:write","name":"Ürünler · Değiştir","when":"Ürün, seçenek, kategori, ürün markası ve marka fiyatı yazmak; toplu fiyat güncellemek."},{"code":"inventory:read","name":"Stok · Gör","when":"Depoları, stok miktarlarını, stok hareketlerini ve belgelerini okumak."},{"code":"inventory:write","name":"Stok · Değiştir","when":"Stok girişi, sayım, fire ve depolar arası taşıma; ürün açarken ilk stok; toplu stok sayımı."},{"code":"customers:read","name":"Müşteriler · Gör","when":"Müşteri kartlarını okumak; ad, telefon, e-posta ve adres için ayrıca personal_data:read gerekir."},{"code":"customers:write","name":"Müşteriler · Değiştir","when":"Müşteri eklemek, güncellemek, arşivlemek ve geri getirmek."},{"code":"shipments:read","name":"Gönderiler · Gör","when":"Gönderileri okumak ve kargo etiketini indirmek."},{"code":"shipments:write","name":"Gönderiler · Değiştir","when":"Kargo fiyatı sormak, gönderi açmak ve iptal etmek; iadede ücretli geri gönderim kodu açmak."},{"code":"returns:read","name":"İadeler · Gör","when":"Siparişin iade ve değişim kayıtlarını okumak."},{"code":"returns:write","name":"İadeler · Değiştir","when":"İade talebini onaylamak veya reddetmek, iadeyi önizlemek ve başlatmak."},{"code":"invoices:read","name":"Faturalar · Gör","when":"Faturaları okumak ve fatura belgesini indirmek."},{"code":"invoices:write","name":"Faturalar · Değiştir","when":"Fatura kesmek ve iptal etmek."},{"code":"coupons:read","name":"Kuponlar · Gör","when":"Kuponları okumak."},{"code":"coupons:write","name":"Kuponlar · Değiştir","when":"Kupon eklemek ve güncellemek."},{"code":"campaigns:read","name":"Kampanyalar · Gör","when":"Kampanyaları okumak."},{"code":"campaigns:write","name":"Kampanyalar · Değiştir","when":"Kampanyaları değiştirmek."},{"code":"subscriptions:read","name":"Abonelikler · Gör","when":"Abonelikleri okumak."},{"code":"subscriptions:write","name":"Abonelikler · Değiştir","when":"Abonelikleri değiştirmek."},{"code":"payments:read","name":"Ödemeleri gör","when":"Siparişin tahsilat ve geri ödemelerini, para özetini okumak."},{"code":"channels:read","name":"Kanalları gör","when":"Satış kanallarını okumak."},{"code":"events:read","name":"Olayları gör","when":"Olay akışını okumak; olayın kaynağının okuma kapsamı da gerekir (ör. sipariş olayı için orders:read)."},{"code":"webhooks:manage","name":"Webhook yönet","when":"Bu bağlantının webhook adreslerini eklemek, değiştirmek ve kapatmak."},{"code":"exports:write","name":"Dışa aktar","when":"Dışa aktarma dosyası hazırlamak ve indirmek; kaynağın okuma kapsamı da gerekir."},{"code":"personal_data:read","name":"Kişisel verileri gör","when":"Müşteri adı, telefonu, e-postası ve adresini görmek; e-posta veya telefonla aramak. İşletme sahibi KVKK uyarısını okuyarak seçer."},{"code":"personal_data:write","name":"Kişisel verileri değiştir","when":"Müşteri adı, telefonu, e-postası ve adresini yazmak."},{"code":"costs:read","name":"Maliyet ve tedarikçiyi gör","when":"Alış fiyatını, maliyeti ve tedarikçiyi görmek."},{"code":"costs:write","name":"Alış fiyatı ve tedarikçiyi yaz","when":"Alış fiyatı, maliyet, KDV seçimi ve tedarikçi yazmak."},{"code":"money_out:write","name":"Para çıkışı","when":"Müşteriye para iadesi doğuran iade, iptal ve düzeltmeler. Hazır şablonlarda kapalıdır."},{"code":"internal_notes:read","name":"İç notları gör","when":"Sipariş, müşteri ve stoktaki iç notları görmek."},{"code":"internal_notes:write","name":"İç notları değiştir","when":"İç not yazmak."},{"code":"archive:write","name":"Arşivle ve geri getir","when":"Kayıtları arşivlemek ve arşivden geri getirmek."},{"code":"customers:erase","name":"KVKK anonimleştirmesi","when":"Müşteriyi KVKK kapsamında geri alınamaz biçimde anonimleştirmek. Yalnız Özel şablonda seçilir."}],"title":"Kapsamlar"}],"x-common-error-codes":["invalid_request","key_in_query","unsupported_api_version","invalid_api_key","test_key_in_live","live_key_in_sandbox","insufficient_scope","not_found","method_not_allowed","validation_error","rate_limit_exceeded","internal_error","service_unavailable","idempotency_key_required","idempotency_in_progress","idempotency_key_reused","invalid_cursor","invalid_id"],"x-error-catalog":{"amount_changed":{"description":"İade tutarı değişti; yeniden önizleyip onaylayın.","resolution":"current_amount güncel TRY tutarıdır; önizlemeyi okuyup yeni anahtar ve expected_amount ile gönderin.","status":409},"bulk_access_changed":{"description":"İşin erişim kapsamı değişti.","resolution":"İşin açıldığı bağlantı ve kaynak kapsamlarını kontrol edin.","status":403},"bulk_in_progress":{"description":"Bu işletmede bir toplu iş sürüyor.","resolution":"Önce açık işin bitmesini bekleyin; sonra yeni tekrar anahtarı kullanın.","status":409},"business_scope_required":{"description":"Bu kayıt işletme genelindedir.","resolution":"Bütün markalara yetkili bağlantı kullanın.","status":403},"category_cycle":{"description":"Kategori kendisinin veya alt kategorisinin altına taşınamaz.","resolution":"Başka üst kategori seçin; yeni tekrar anahtarı kullanın.","status":422},"code_taken":{"description":"Stok kodu veya barkod başka bir kayıtta kullanılıyor.","resolution":"Görünür existing_variant / existing_product kimliğini okuyun veya farklı kod seçin.","status":409},"conflict":{"description":"Sipariş veya ödeme bilgisi değişmiş ya da işlem mevcut duruma uygun değil.","resolution":"Güncel siparişi okuyun, iş kuralını kontrol edip yeni tekrar anahtarıyla deneyin.","status":409},"coupon_code_taken":{"description":"Kupon kodu bu markada başka kuponda kullanılıyor.","resolution":"Başka kod seçin veya mevcut kuponu güncelleyin; yeni tekrar anahtarı kullanın.","status":409},"coupon_restore_conflict":{"description":"Kupon arşivde değil.","resolution":"Güncel kaydı okuyun.","status":409},"customer_anonymization_blocked":{"description":"Müşteri mevcut durumda anonimleştirilemiyor. Açık siparişlerini tamamlayın veya iptal edin.","resolution":"Paneldeki anonimleştirme önkoşulunu giderip yeni tekrar anahtarıyla gönderin.","status":409},"customer_exists":{"description":"Bu iletişim bilgileriyle müşteri zaten var.","resolution":"existing_customer kimliğini kullanın; değiştirmek için PATCH gönderin.","status":409},"customer_restore_conflict":{"description":"Müşteri geri getirilemedi.","resolution":"Kartın arşiv durumunu ve üyelik bağını panelden kontrol edin; anonimleşmiş kart geri getirilemez.","status":409},"delivery_in_progress":{"description":"Bu adrese teslim sürüyor.","resolution":"Teslimin tamamlanmasını bekleyip yeniden gönderin.","status":409},"document_already_reversed":{"description":"Bu stok belgesi zaten tersine çevrilmiş.","resolution":"Güncel belgedeki reversed_by kaydını okuyun.","status":409},"document_forbidden":{"description":"Belgenin tüm satırları marka kapsamında değil.","resolution":"İşletmenin tümüne yetkili stok bağlantısı kullanın.","status":403},"duplicate_external_reference":{"description":"Bu dış numarayla sipariş zaten açılmış.","resolution":"existing_order içindeki ord_ kimliğini kullanın; ikinci sipariş açılmadı.","status":409},"duplicate_line":{"description":"Aynı sipariş satırı birden çok kez gönderilmiş.","resolution":"Her lin_ kimliğini yalnız bir kez yazın.","status":422},"endpoint_closed":{"description":"Webhook adresi kapalı.","resolution":"Yeni adres kaydı oluşturun ve imzalı denemeyi tamamlayın.","status":409},"endpoint_inactive":{"description":"Webhook adresi henüz etkin değil.","resolution":"Önce imzalı deneme gönderip alıcıdan 2xx alın.","status":409},"export_access_changed":{"description":"Dosya oluşturulduktan sonra erişim kapsamı değişmiş.","resolution":"Güncel izinlerle yeni dışa aktarma başlatın.","status":403},"export_in_progress":{"description":"Bu işletmede başka bir dosya hazırlanıyor.","resolution":"Retry-After kadar bekleyin; mevcut hazırlama bitince yeni Idempotency-Key ile isteyin.","status":409},"export_not_ready":{"description":"Dosya henüz hazır değil.","resolution":"Dışa aktarma durumunu okuyup completed olmasını bekleyin.","status":409},"external_reference_conflict":{"description":"Bu dış numarayla stok belgesi zaten açılmış.","resolution":"Ağ tekrarında özgün Idempotency-Key değerini ve gövdeyi kullanın.","status":409},"file_expired":{"description":"Dosyanın 7 günlük erişim süresi dolmuş.","resolution":"Yeni dışa aktarma başlatın; mevcut olay devam imleci kullanılabilir.","status":410},"file_unavailable":{"description":"Hazır dosyaya şu an erişilemiyor.","resolution":"Retry-After kadar bekleyip indirmeyi yeniden deneyin.","status":503},"forbidden":{"description":"Mevcut ticari kural bu işlemi yapmanıza izin vermiyor.","resolution":"Gerekli kapsamları ve siparişin durumunu kontrol edin.","status":403},"grant_mismatch":{"description":"Başka API bağlantısının webhook adresi istenmiş.","resolution":"Yalnız kullandığınız Bearer anahtarının bağlantısını yönetin; grant alanını atlayabilirsiniz.","status":403},"idempotency_in_progress":{"description":"Aynı tekrar anahtarıyla istek hâlâ işleniyor.","resolution":"Kısa beklemeden sonra aynı anahtar ve aynı gövdeyle yeniden deneyin.","status":409},"idempotency_key_required":{"description":"Tekrar anahtarı eksik.","resolution":"Idempotency-Key başlığına yeni iş için benzersiz değer yazın.","status":400},"idempotency_key_reused":{"description":"Aynı tekrar anahtarı farklı gövdeyle kullanılmış.","resolution":"Eski işi tekrarlıyorsanız eski gövdeyi; yeni işse yeni anahtarı kullanın.","status":422},"insufficient_scope":{"description":"Gerekli kapsam eksik.","resolution":"İşletme sahibinden uç ve alt kaynakların okuma kapsamlarını isteyin.","status":403},"insufficient_stock":{"description":"Sipariş için yeterli stok yok.","resolution":"Miktarı azaltın veya paneldeki bekleyen stok kuralını açıkça allow_waiting=true ile seçin.","status":400},"internal_error":{"description":"Sunucu isteği tamamlayamadı.","resolution":"Güvenle tekrarlanabilen isteği artan beklemeyle deneyin; sürerse request_id ile destek alın.","status":500},"invalid_api_key":{"description":"Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.","resolution":"Panelde açık bağlantı oluşturun/döndürün; sunucu ortamındaki anahtarı güncelleyin.","status":401},"invalid_cursor":{"description":"İmleç kaynak, yetki veya süzgeçle uyuşmuyor.","resolution":"Aynı süzgeç/kapsamı koruyun; kaybettiyseniz listeyi veya tutarlı ilk eşitlemeyi yeniden başlatın.","status":400},"invalid_date_range":{"description":"Zaman aralığının başlangıcı bitişten sonra.","resolution":"Başlangıç ve bitiş sırasını düzeltin.","status":422},"invalid_datetime":{"description":"Zamanın saat dilimi eksik.","resolution":"RFC 3339 değere Z veya +03:00 gibi saat dilimi ekleyin.","status":422},"invalid_event_types":{"description":"Olay türü geçersiz veya izinli tür yok.","resolution":"Olay kataloğundan tür seçin ve kaynak kapsamını açın.","status":422},"invalid_grant":{"description":"Webhook yönetimi açık bağlantı bulunamadı.","resolution":"Açık, webhooks:manage kapsamlı bağlantı kullanın.","status":422},"invalid_id":{"description":"Kaynak kimliğinin öneki veya biçimi geçersiz.","resolution":"Liste yanıtındaki doğru türde dış kimliği kullanın; iç sayısal kimlik göndermeyin.","status":422},"invalid_if_match":{"description":"If-Match geçerli bir güçlü ETag değil.","resolution":"GET kaynak yanıtındaki ETag değerini çift tırnaklarıyla aynen kullanın.","status":400},"invalid_include":{"description":"Genişletme adı geçersiz veya yineleniyor.","resolution":"Yalnız ucun desteklediği include değerlerini birer kez gönderin.","status":422},"invalid_patch":{"description":"Düzeltilecek alan veya seçenek uygun değil.","resolution":"Değişmeyecek alanı atlayın; seçeneğin sipariş satırındaki ürüne ait olduğunu ve alan kurallarını kontrol edin.","status":422},"invalid_range":{"description":"Zaman aralığının başlangıcı bitişten önce değil.","resolution":"Başlangıç dahil, bitiş hariç olacak şekilde başlangıcı bitişten önce seçin.","status":422},"invalid_request":{"description":"İstek biçimi geçersiz.","resolution":"Gövdeyi ve başlıkları kontrol edin; Idempotency-Key en çok 200 karakterdir.","status":400},"invalid_stock_operation":{"description":"Stok işlemi ürünün veya deponun kurallarına uygun değil.","resolution":"Birimi, depo durumunu, sayılmayan stoğu ve belge türünü kontrol edin.","status":422},"invalid_store":{"description":"Marka bağlantının yetkisinde değil veya kapalı.","resolution":"/me stores listesindeki bir markayı seçin.","status":422},"invalid_webhook_url":{"description":"Webhook adresi kabul edilmiyor.","resolution":"Genel internete çözülen, kullanıcı bilgisi içermeyen HTTPS/443 adresi kullanın.","status":422},"invoice_already_cancelled":{"description":"Fatura zaten iptal edilmiş.","resolution":"Güncel faturayı okuyun.","status":409},"invoice_billing_invalid":{"description":"Siparişin fatura bilgileri uygun değil.","resolution":"Paneldeki açıklamaya göre fatura bilgilerini tamamlayın.","status":409},"invoice_cancel_running":{"description":"Fatura iptali sürüyor.","resolution":"Süren çağrının bitmesini bekleyin.","status":409},"invoice_cancel_uncertain":{"description":"Fatura iptalinin sonucu belirsiz.","resolution":"Yeni dış iptal gönderilmez; portalda doğrulayıp portal_done=true ile tamamlayın.","status":409},"invoice_connection_changed":{"description":"Fatura sağlayıcı bağlantısı değişti.","resolution":"Önceki sağlayıcı hesabında faturayı kontrol edin.","status":409},"invoice_empty_order":{"description":"Siparişte ürün yok; fatura kesilemez.","resolution":"Sipariş kalemlerini kontrol edin.","status":409},"invoice_exists":{"description":"Siparişin etkin faturası var.","resolution":"Mevcut faturayı okuyun; hazırlanan fatura için yeni istek açmayın.","status":409},"invoice_not_allowed":{"description":"Fatura işlemi şu an yapılamıyor.","resolution":"Açıklamadaki panel kuralını izleyin.","status":409},"invoice_not_connected":{"description":"Fatura sağlayıcısı bağlı değil.","resolution":"İşletme > Entegrasyonlar bölümünden sağlayıcınızı bağlayın.","status":409},"invoice_not_ready":{"description":"Fatura belgesi henüz hazır değil.","resolution":"Faturanın numarası kesinleşince yeniden deneyin.","status":409},"invoice_order_not_allowed":{"description":"Bu siparişe fatura kesilemez.","resolution":"Siparişin iptal/iade durumunu kontrol edin.","status":409},"invoice_payment_required":{"description":"Ödeme gelince fatura kesilebilir.","resolution":"Ödeme kaydını kontrol edin.","status":409},"invoice_portal_required":{"description":"Sağlayıcı portalından iptal gerekiyor.","resolution":"Portalda tamamladıktan sonra portal_done=true gönderin.","status":409},"invoice_provider_auth":{"description":"Fatura sağlayıcısı bağlantı bilgilerini kabul etmedi.","resolution":"İşletme > Entegrasyonlar bölümünden bağlantıyı düzeltin; aynı faturayı izleyin.","status":409},"invoice_provider_error":{"description":"Fatura sağlayıcısı işlemi tamamlayamadı.","resolution":"Faturanın durumunu ve sağlayıcı portalını kontrol edin.","status":409},"invoice_seller_invalid":{"description":"İşletmenin vergi bilgileri eksik.","resolution":"İşletme bilgilerini tamamlayın.","status":400},"invoice_zero_total":{"description":"Sipariş tutarı 0 TL; fatura kesilmez.","resolution":"Sipariş tutarını kontrol edin.","status":409},"key_in_query":{"description":"Anahtar URL sorgusuna yazılmış.","resolution":"Anahtarı yalnız Authorization: Bearer başlığında gönderin.","status":400},"live_key_in_sandbox":{"description":"Canlı anahtar deneme ortamında kullanılamaz.","resolution":"Deneme panelinde ayrı bir spk_test_ anahtarı oluşturun.","status":401},"method_not_allowed":{"description":"Uç HTTP yöntemini desteklemiyor.","resolution":"Başvuruda yazılı GET/POST/PATCH yöntemini kullanın.","status":405},"not_found":{"description":"Kayıt/uç yok veya anahtarın marka sınırında görünmüyor.","resolution":"Kimlik önekini, markayı ve arşiv süzgecini kontrol edin.","status":404},"product_restore_conflict":{"description":"Ürün geri getirilemedi.","resolution":"Arşiv durumunu ve stok kodu/barkod çakışmasını panelden kontrol edin.","status":409},"quote_rate_limited":{"description":"İşletmenin kargo fiyatı sorgulama sınırına ulaşıldı.","resolution":"Retry-After saniye bekleyin; 60 saniyede 20 sorgu bütün bağlantı ve markalarda ortaktır. Gönderi açma bu sayaçtan etkilenmez.","status":429},"rate_limit_exceeded":{"description":"Okuma veya hatalı anahtar hız sınırına ulaşıldı.","resolution":"Retry-After saniyesini bekleyin; artan bekleme ve rastgele gecikme kullanın.","status":429},"reference_namespace_forbidden":{"description":"Dış numaranın ad alanı başka bağlantıya ait.","resolution":"namespace alanını atlayın veya /me içindeki grt_ kimliğini kullanın.","status":403},"refund_confirm":{"description":"Düzeltme müşteriye para döndürüyor; tutar teyidi gerekiyor.","resolution":"İade tutarını kontrol edip refund_amount alanıyla ve yeni tekrar anahtarıyla gönderin; money_out:write gerekir.","status":409},"refund_distribution_confirm":{"description":"Kart ve elle ödeme dağılımı değişti.","resolution":"Yeniden önizleyip refund_distribution alanını aynen ve yeni tekrar anahtarıyla gönderin.","status":409},"reserved_note":{"description":"Bu açıklama sistem işlemlerine ayrılmıştır.","resolution":"İşlemi kendi sözcüklerinizle açıklayın; yeni tekrar anahtarı kullanın.","status":422},"return_not_requested":{"description":"Bu kayıt bir müşteri iade talebi değil.","resolution":"Siparişin returns listesinden müşteri talebini seçin.","status":409},"revision_mismatch":{"description":"Kayıt siz okuduktan sonra değişmiş.","resolution":"Güncel kaydı okuyun; düzeltmeyi yeniden değerlendirip yeni tekrar anahtarıyla gönderin.","status":412},"rotation_unavailable":{"description":"Adres kapalı veya önceki sır geçişi sürüyor.","resolution":"Önceki geçişin bitmesini bekleyin; kapalı adres için yeni kayıt açın.","status":409},"service_unavailable":{"description":"Servis geçici olarak yoğun veya erişilemiyor.","resolution":"Retry-After kadar bekleyip güvenle tekrarlanabilen isteği deneyin.","status":503},"shipment_label_not_ready":{"description":"Etiket hazır değil veya gönderi iptal edilmiş.","resolution":"Gönderinin açılışının tamamlanmasını bekleyin.","status":409},"shipment_not_allowed":{"description":"Gönderinin veya siparişin durumu bu işleme uygun değil.","resolution":"Güncel gönderiyi ve siparişi okuyun; bekleyen işlemin sonuçlanmasını izleyin.","status":409},"shipping_address_invalid":{"description":"Alıcı adresi eksik veya geçersiz.","resolution":"Siparişin il, ilçe, mahalle ve açık adresini düzeltin; yeni tekrar anahtarı kullanın.","status":400},"shipping_balance_insufficient":{"description":"Kargo bakiyesi yetersiz.","resolution":"BasitKargo bakiyesini yükleyin; yeni tekrar anahtarıyla deneyin.","status":400},"shipping_carrier_disabled":{"description":"Kargo firması kapalı veya seçilemez.","resolution":"Fiyat yanıtındaki açık firma kodunu seçin.","status":400},"shipping_cod_unavailable":{"description":"Kapıda ödeme bu hesapta veya firmada kullanılamıyor.","resolution":"BasitKargo kapıda ödeme ayarlarını ve siparişin ödeme yöntemini kontrol edin.","status":400},"shipping_not_connected":{"description":"BasitKargo hesabı bağlı değil.","resolution":"İşletme ayarları > Kargo’dan hesabı bağlayın.","status":409},"shipping_provider_error":{"description":"Kargo etiketi alınamadı veya yanıtta SVG etiketi bulunamadı.","resolution":"Bir süre sonra aynı gönderinin etiketini yeniden indirin.","status":502},"shipping_quote_unavailable":{"description":"Bu paket ve ödeme yöntemi için ücret bulunamadı.","resolution":"Koli ölçülerini ve firma seçimini kontrol edin.","status":400},"shipping_rate_limited":{"description":"Kargo sağlayıcısının istek sınırına ulaşıldı.","resolution":"Retry-After saniye bekleyin; gönderi açılışında aynı anahtarı koruyun.","status":429},"shipping_unavailable":{"description":"Kargo hizmetine şu an ulaşılamıyor.","resolution":"Retry-After saniye bekleyin; aynı anahtar/gövdeyle tekrar edin.","status":503},"snapshot_publisher_changed":{"description":"Olay yayıncısının sürümü ilk görüntüyle uyuşmuyor.","resolution":"Yeni tutarlı dışa aktarma ve onun resume_cursor değeriyle başlayın.","status":409},"status_mismatch":{"description":"Sipariş durumu expected_status ile uyuşmuyor.","resolution":"Güncel durumu okuyup yeni tekrar anahtarıyla deneyin.","status":409},"stock_changed":{"description":"Sayım sırasında stok değişmiş.","resolution":"Güncel depo miktarını okuyup expected alanını yenileyin; yeni tekrar anahtarı kullanın.","status":409},"store_forbidden":{"description":"Anahtar başka markaya yazamaz.","resolution":"Anahtarın kendi markasını seçin; marka sınırı gövdeyle genişletilmez.","status":403},"store_required":{"description":"Çok markalı işletmede kaydın markası eksik.","resolution":"/me yanıtındaki sto_ kimliğini store alanına yazın.","status":422},"taxonomy_name_conflict":{"description":"Aynı anda bu addan başka kayıt açıldı.","resolution":"Güncel listeyi okuyun; yeni tekrar anahtarıyla yeniden deneyin.","status":409},"taxonomy_restore_conflict":{"description":"Kayıt arşivden geri getirilemedi.","resolution":"Güncel arşiv durumunu kontrol edin.","status":409},"test_key_in_live":{"description":"Deneme anahtarı canlı ortamda kullanılamaz.","resolution":"spk_test_ anahtarını https://api.sandbox.siparis.app/v1 adresinde kullanın.","status":401},"unsupported_api_version":{"description":"İstenen sürüm desteklenmiyor.","resolution":"Siparis-Version başlığını v1 yapın veya kaldırın.","status":400},"validation_error":{"description":"İstek alanı veya değeri geçersiz.","resolution":"errors içindeki field ve code değerlerine göre isteği düzeltin.","status":422}},"x-event-examples":{"channel.order_imported":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{},"previous":{}},"object":{"channel":"trendyol","id":"chn_00000000000000000000000000000001","number":48273910,"order":"ord_00000000000000000000000000000004"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"channel.order_imported"},"channel.problem":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"problem":"authorization"},"previous":{"problem":null}},"object":{"channel":"trendyol","id":"chn_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"channel.problem"},"channel.recovered":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"problem":null},"previous":{"problem":"authorization"}},"object":{"channel":"trendyol","id":"chn_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"channel.recovered"},"collection.recorded":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","status":"succeeded"},"previous":{"amount":"100.00","status":"pending"}},"object":{"id":"col_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"collection.recorded"},"collection.reversed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00"},"previous":{"amount":"100.00"}},"object":{"id":"col_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"collection.reversed"},"coupon.archived":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"archived":true,"customer_count":0,"discount_type":"percentage","discount_value":"10.00","min_order":"100.00","status":"active","valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"previous":{"archived":false,"customer_count":0,"discount_type":"percentage","discount_value":"10.00","min_order":"100.00","status":"active","valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"}},"object":{"code":"MERHABA10","id":"cpn_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"coupon.archived"},"coupon.created":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"archived":false,"customer_count":0,"discount_type":"percentage","discount_value":"10.00","min_order":"100.00","status":"active","valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"previous":{"archived":null,"customer_count":null,"discount_type":null,"discount_value":null,"min_order":null,"status":null,"valid_from":null,"valid_until":null}},"object":{"code":"MERHABA10","id":"cpn_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"coupon.created"},"coupon.restored":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"archived":false,"customer_count":0,"discount_type":"percentage","discount_value":"10.00","min_order":"100.00","status":"active","valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"previous":{"archived":true,"customer_count":0,"discount_type":"percentage","discount_value":"10.00","min_order":"100.00","status":"active","valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"}},"object":{"code":"MERHABA10","id":"cpn_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"coupon.restored"},"coupon.updated":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"archived":false,"customer_count":0,"discount_type":"percentage","discount_value":"15.00","min_order":"100.00","status":"active","valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"},"previous":{"archived":false,"customer_count":0,"discount_type":"percentage","discount_value":"10.00","min_order":"100.00","status":"active","valid_from":"2026-10-16","valid_until":"2026-12-31T23:59"}},"object":{"code":"MERHABA10","id":"cpn_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"coupon.updated"},"customer.anonymized":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"anonymized":true,"archived":false},"previous":{"anonymized":false,"archived":false}},"object":{"id":"cus_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"customer.anonymized"},"customer.archived":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"anonymized":false,"archived":true},"previous":{"anonymized":false,"archived":false}},"object":{"id":"cus_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"customer.archived"},"customer.created":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"anonymized":false,"archived":false},"previous":{"anonymized":false,"archived":false}},"object":{"id":"cus_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"customer.created"},"customer.restored":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"anonymized":false,"archived":false},"previous":{"anonymized":false,"archived":true}},"object":{"id":"cus_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"customer.restored"},"customer.updated":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"anonymized":false,"archived":false},"previous":{"anonymized":false,"archived":false}},"object":{"id":"cus_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"customer.updated"},"inventory.document_created":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{},"previous":{}},"object":{"id":"doc_00000000000000000000000000000001","kind":"receipt"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"inventory.document_created"},"inventory.document_reversed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{},"previous":{}},"object":{"id":"doc_00000000000000000000000000000001","kind":"receipt","reverses":"doc_00000000000000000000000000000004"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"inventory.document_reversed"},"inventory.level_changed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"quantity":"12.000"},"previous":{"quantity":"13.000"}},"object":{"id":"lvl_00000000000000000000000000000001","location":"loc_00000000000000000000000000000003","variant":"var_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"inventory.level_changed"},"inventory.low":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"quantity":"2.000","threshold":"3.000"},"previous":{"quantity":"3.000","threshold":"3.000"}},"object":{"id":"lvl_00000000000000000000000000000001","location":"loc_00000000000000000000000000000003","variant":"var_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"inventory.low"},"invoice.cancelled":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"status":"cancelled","total":"120.00"},"previous":{"status":"issued","total":"100.00"}},"object":{"id":"inv_00000000000000000000000000000001","kind":"e_arsiv","order":"ord_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"invoice.cancelled"},"invoice.failed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"status":"failed","total":"120.00"},"previous":{"status":"pending","total":"100.00"}},"object":{"id":"inv_00000000000000000000000000000001","kind":"e_arsiv","order":"ord_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"invoice.failed"},"invoice.issued":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"status":"issued","total":"120.00"},"previous":{"status":"pending","total":"100.00"}},"object":{"id":"inv_00000000000000000000000000000001","kind":"e_arsiv","order":"ord_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"invoice.issued"},"job.completed":{"actor":{"type":"worker"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"status":"completed"},"previous":{"status":"running"}},"object":{"id":"exp_1234567890abcdef1234567890abcdef"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"job.completed"},"order.created":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","status":"confirmed"},"previous":{"amount":"100.00","status":"pending"}},"object":{"id":"ord_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"order.created"},"order.status_changed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"status":"confirmed"},"previous":{"status":"pending"}},"object":{"id":"ord_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"order.status_changed"},"order.updated":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","status":"confirmed"},"previous":{"amount":"100.00","status":"pending"}},"object":{"id":"ord_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"order.updated"},"payment.failed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","currency":"TRY","method":"card","provider":"iyzico","provider_code":"declined","status":"failed"},"previous":{}},"object":{"id":"pat_00000000000000000000000000000001","order":"ord_00000000000000000000000000000004"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"payment.failed"},"product.archived":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","archived":true,"status":"active"},"previous":{"amount":"100.00","archived":false,"status":"active"}},"object":{"id":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"product.archived"},"product.created":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","archived":false,"status":"active"},"previous":{"amount":"100.00","archived":false,"status":"active"}},"object":{"id":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"product.created"},"product.restored":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","archived":false,"status":"active"},"previous":{"amount":"100.00","archived":true,"status":"active"}},"object":{"id":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"product.restored"},"product.updated":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","archived":false,"status":"active"},"previous":{"amount":"100.00","archived":false,"status":"active"}},"object":{"id":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"product.updated"},"refund.succeeded":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00"},"previous":{"amount":"100.00"}},"object":{"id":"rfd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"refund.succeeded"},"return.approved":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"item_count":2,"refund_amount":"120.00","status":"approved"},"previous":{"item_count":2,"refund_amount":"100.00","status":"requested"}},"object":{"id":"ret_00000000000000000000000000000001","kind":"return","order":"ord_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"return.approved"},"return.closed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"item_count":2,"refund_amount":"120.00","status":"closed"},"previous":{"item_count":2,"refund_amount":"100.00","status":"approved"}},"object":{"id":"ret_00000000000000000000000000000001","kind":"return","order":"ord_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"return.closed"},"return.received":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"item_count":2,"refund_amount":"120.00","status":"arrived"},"previous":{"item_count":2,"refund_amount":"100.00","status":"approved"}},"object":{"id":"ret_00000000000000000000000000000001","kind":"return","order":"ord_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"return.received"},"return.rejected":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"item_count":2,"refund_amount":"120.00","status":"declined"},"previous":{"item_count":2,"refund_amount":"100.00","status":"requested"}},"object":{"id":"ret_00000000000000000000000000000001","kind":"return","order":"ord_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"return.rejected"},"return.requested":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"item_count":2,"refund_amount":"120.00","status":"requested"},"previous":{"item_count":null,"refund_amount":"100.00","status":null}},"object":{"id":"ret_00000000000000000000000000000001","kind":"return","order":"ord_00000000000000000000000000000002"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"return.requested"},"shipment.cod_changed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"cod_amount":"120.00","cod_collected":"120.00","cod_release":null,"cod_state":"collected","cod_status":"COLLECTED"},"previous":{"cod_amount":null,"cod_collected":null,"cod_release":null,"cod_state":"pending","cod_status":"TO_BE_COLLECTED"}},"object":{"id":"shp_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"shipment.cod_changed"},"shipment.created":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"cod_amount":"120.00","cod_collected":"120.00","cod_release":null,"cod_state":"collected","cod_status":"COLLECTED","state":"delivered","status":"DELIVERED"},"previous":{"cod_amount":null,"cod_collected":null,"cod_release":null,"cod_state":"pending","cod_status":"TO_BE_COLLECTED","state":"ready","status":"CREATED"}},"object":{"id":"shp_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"shipment.created"},"shipment.status_changed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"state":"delivered","status":"DELIVERED"},"previous":{"state":"ready","status":"CREATED"}},"object":{"id":"shp_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"shipment.status_changed"},"store_price.updated":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"compare_price":null,"price":"120.00"},"previous":{"compare_price":null,"price":"100.00"}},"object":{"id":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"store_price.updated"},"store_product.linked":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"linked":true},"previous":{"linked":false}},"object":{"id":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"store_product.linked"},"store_product.unlinked":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"linked":false},"previous":{"linked":true}},"object":{"id":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"store_product.unlinked"},"subscription.cancelled":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"interval_weeks":2,"next_date":"2026-10-23","status":"cancelled"},"previous":{"interval_weeks":2,"next_date":"2026-10-23","status":"active"}},"object":{"customer":"cus_00000000000000000000000000000003","id":"sub_00000000000000000000000000000001","items":[{"product":"prd_00000000000000000000000000000005","variant":"var_00000000000000000000000000000006"}]}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"subscription.cancelled"},"subscription.created":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"interval_weeks":2,"next_date":"2026-10-23","status":"active"},"previous":{"interval_weeks":null,"next_date":null,"status":null}},"object":{"customer":"cus_00000000000000000000000000000003","id":"sub_00000000000000000000000000000001","items":[{"product":"prd_00000000000000000000000000000005","variant":"var_00000000000000000000000000000006"}],"order":"ord_00000000000000000000000000000004"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"subscription.created"},"subscription.paused":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"interval_weeks":2,"next_date":"2026-10-23","status":"paused"},"previous":{"interval_weeks":2,"next_date":"2026-10-23","status":"active"}},"object":{"customer":"cus_00000000000000000000000000000003","id":"sub_00000000000000000000000000000001","items":[{"product":"prd_00000000000000000000000000000005","variant":"var_00000000000000000000000000000006"}]}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"subscription.paused"},"subscription.payment_issue":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"interval_weeks":2,"next_date":"2026-10-23","status":"payment_issue"},"previous":{"interval_weeks":2,"next_date":"2026-10-23","status":"active"}},"object":{"customer":"cus_00000000000000000000000000000003","id":"sub_00000000000000000000000000000001","items":[{"product":"prd_00000000000000000000000000000005","variant":"var_00000000000000000000000000000006"}]}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"subscription.payment_issue"},"subscription.renewed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"interval_weeks":2,"next_date":"2026-11-06","period":"2026-10-23","status":"active"},"previous":{"interval_weeks":2,"next_date":"2026-10-23","status":"active"}},"object":{"customer":"cus_00000000000000000000000000000003","id":"sub_00000000000000000000000000000001","items":[{"product":"prd_00000000000000000000000000000005","variant":"var_00000000000000000000000000000006"}],"order":"ord_00000000000000000000000000000004"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"subscription.renewed"},"subscription.resumed":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"interval_weeks":2,"next_date":"2026-10-23","status":"active"},"previous":{"interval_weeks":2,"next_date":"2026-10-23","status":"paused"}},"object":{"customer":"cus_00000000000000000000000000000003","id":"sub_00000000000000000000000000000001","items":[{"product":"prd_00000000000000000000000000000005","variant":"var_00000000000000000000000000000006"}]}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"subscription.resumed"},"variant.archived":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","archived":true},"previous":{"amount":"100.00","archived":false}},"object":{"id":"var_00000000000000000000000000000002","product":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"variant.archived"},"variant.created":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","archived":false},"previous":{"amount":"100.00","archived":false}},"object":{"id":"var_00000000000000000000000000000002","product":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"variant.created"},"variant.restored":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","archived":false},"previous":{"amount":"100.00","archived":true}},"object":{"id":"var_00000000000000000000000000000002","product":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"variant.restored"},"variant.updated":{"actor":{"type":"user"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{"amount":"120.00","archived":false},"previous":{"amount":"100.00","archived":false}},"object":{"id":"var_00000000000000000000000000000002","product":"prd_00000000000000000000000000000001"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"variant.updated"},"webhook.test":{"actor":{"type":"system"},"created_at":"2026-10-16T09:00:00Z","data":{"changes":{"current":{},"previous":{}},"object":{"id":"whe_1234567890abcdef1234567890abcdef"}},"id":"evt_1234567890abcdef1234567890abcdef","livemode":true,"schema_version":1,"store":"sto_1234567890abcdef1234567890abcdef","type":"webhook.test"}},"x-webhook-only-scopes":{"webhook.test":"webhooks:manage"}}