{"openapi":"3.0.3","info":{"title":"SmarterMoment API","version":"1.0.0","description":"\u00dcr\u00fcn katalo\u011fu, davran\u0131\u015f takibi, arama, \u00f6neri ve g\u00f6sterim alan\u0131 servisleri."},"servers":[{"url":"https:\/\/api.smartermoment.com\/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"},"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"ProductInput":{"type":"object","required":["external_id","name"],"properties":{"external_id":{"type":"string","example":"SKU-1001"},"sku":{"type":"string","nullable":true,"example":"SKU-1001"},"name":{"type":"string","example":"Pamuklu G\u00f6mlek"},"slug":{"type":"string","nullable":true,"example":"pamuklu-gomlek"},"url":{"type":"string","nullable":true,"example":"https:\/\/example.com\/products\/pamuklu-gomlek"},"image_url":{"type":"string","nullable":true,"example":"https:\/\/example.com\/pamuklu-gomlek.jpg"},"images":{"type":"array","nullable":true,"items":{"type":"string"},"example":["https:\/\/example.com\/pamuklu-gomlek.jpg","https:\/\/example.com\/pamuklu-gomlek-2.jpg"]},"category":{"type":"string","nullable":true,"example":"G\u00f6mlek"},"brand":{"type":"string","nullable":true,"example":"SmarterMoment"},"barcode":{"type":"string","nullable":true,"example":"8680000000001"},"vendor_code":{"type":"string","nullable":true,"example":"TED-1001"},"manufacturer_code":{"type":"string","nullable":true,"example":"MPN-1001"},"price":{"type":"number","format":"float","nullable":true,"example":1299.9},"compare_at_price":{"type":"number","format":"float","nullable":true,"example":1499.9},"currency":{"type":"string","default":"TRY","example":"TRY"},"attributes":{"type":"object","nullable":true,"additionalProperties":true},"is_active":{"type":"boolean","default":true}}},"Product":{"type":"object","properties":{"external_id":{"type":"string"},"product_id":{"type":"integer","nullable":true},"sku":{"type":"string","nullable":true},"name":{"type":"string"},"url":{"type":"string","nullable":true},"image_url":{"type":"string","nullable":true},"image_urls":{"type":"array","items":{"type":"string"}},"category":{"type":"string","nullable":true},"category_ids":{"type":"array","items":{"type":"string"}},"brand":{"type":"string","nullable":true},"barcode":{"type":"string","nullable":true},"vendor_code":{"type":"string","nullable":true},"manufacturer_code":{"type":"string","nullable":true},"price":{"type":"string","nullable":true},"compare_at_price":{"type":"string","nullable":true},"currency":{"type":"string"},"stock_quantity":{"type":"integer","nullable":true},"available":{"type":"boolean"},"widgetable":{"type":"boolean"},"marketing_excluded":{"type":"boolean"},"badges":{"type":"array","items":{"type":"string"}},"prediction_score":{"type":"number","nullable":true},"prediction_reasons":{"type":"array","items":{"type":"string"}}}},"CustomerInput":{"type":"object","properties":{"external_id":{"type":"string","nullable":true,"example":"customer-42"},"email":{"type":"string","format":"email","nullable":true,"example":"customer@example.com"},"phone":{"type":"string","nullable":true},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"attributes":{"type":"object","additionalProperties":true},"rfm_score":{"type":"integer","nullable":true,"example":555},"first_seen_at":{"type":"string","format":"date-time","nullable":true},"last_seen_at":{"type":"string","format":"date-time","nullable":true},"email_marketing_consent":{"type":"boolean","nullable":true,"description":"E-posta pazarlama izninin g\u00fcncel durumu"},"email_marketing_consent_at":{"type":"string","format":"date-time","nullable":true},"email_marketing_consent_source":{"type":"string","nullable":true,"example":"iys"},"email_marketing_consent_reference":{"type":"string","nullable":true,"description":"\u0130zin kayna\u011f\u0131ndaki do\u011frulanabilir referans"}}},"OrderLineInput":{"type":"object","properties":{"product_external_id":{"type":"string","nullable":true,"example":"SKU-1001"},"external_id":{"type":"string","nullable":true,"example":"SKU-1001"},"sku":{"type":"string","nullable":true,"example":"SKU-1001"},"name":{"type":"string","nullable":true,"example":"Pamuklu G\u00f6mlek"},"quantity":{"type":"number","format":"float","default":1},"price":{"type":"number","format":"float","nullable":true,"example":1299.9},"amount":{"type":"number","format":"float","nullable":true,"example":1299.9},"category":{"type":"string","nullable":true,"example":"G\u00f6mlek"},"brand":{"type":"string","nullable":true,"example":"SmarterMoment"}}},"OrderInput":{"type":"object","required":["order_id"],"properties":{"order_id":{"type":"string","example":"ORD-10001"},"order_number":{"type":"string","nullable":true,"example":"10001"},"status":{"type":"string","nullable":true,"example":"completed"},"source":{"type":"string","nullable":true,"example":"online"},"currency":{"type":"string","default":"TRY","example":"TRY"},"amount":{"type":"number","format":"float","nullable":true,"example":2499.8},"discount_total":{"type":"number","format":"float","nullable":true,"example":100},"shipping_total":{"type":"number","format":"float","nullable":true,"example":39.9},"visitor_id":{"type":"string","nullable":true,"example":"visitor-abc"},"session_id":{"type":"string","nullable":true,"example":"session-abc"},"occurred_at":{"type":"string","format":"date-time","nullable":true},"customer":{"$ref":"#\/components\/schemas\/CustomerInput"},"items":{"type":"array","items":{"$ref":"#\/components\/schemas\/OrderLineInput"}},"payload":{"type":"object","nullable":true,"additionalProperties":true}}},"Order":{"type":"object","properties":{"order_id":{"type":"string","nullable":true},"order_number":{"type":"string","nullable":true},"status":{"type":"string","nullable":true},"source":{"type":"string","nullable":true},"currency":{"type":"string"},"amount":{"type":"number","nullable":true},"discount_total":{"type":"number","nullable":true},"shipping_total":{"type":"number","nullable":true},"occurred_at":{"type":"string","format":"date-time","nullable":true},"visitor_id":{"type":"string","nullable":true},"session_id":{"type":"string","nullable":true},"customer":{"type":"object","nullable":true,"additionalProperties":true},"primary_product":{"type":"object","nullable":true,"additionalProperties":true},"items":{"type":"array","items":{"$ref":"#\/components\/schemas\/OrderLineInput"}}}},"EventInput":{"type":"object","required":["event_type"],"properties":{"event_type":{"type":"string","description":"Yayg\u0131n de\u011ferler: product_view, add_to_cart, remove_from_cart, cart_clear, wishlist, search, search_click, recommendation_impression, recommendation_click, widget_impression, widget_click, purchase.","example":"product_view"},"visitor_id":{"type":"string","nullable":true,"example":"visitor-abc"},"session_id":{"type":"string","nullable":true,"example":"session-abc"},"customer":{"$ref":"#\/components\/schemas\/CustomerInput"},"product_external_id":{"type":"string","nullable":true,"example":"SKU-1001"},"payload":{"type":"object","nullable":true,"additionalProperties":true},"occurred_at":{"type":"string","format":"date-time","nullable":true}}},"GosterimAlani":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"placement":{"type":"string","nullable":true},"traffic_percentage":{"type":"integer"},"config":{"type":"object","nullable":true,"additionalProperties":true}}},"Error":{"type":"object","properties":{"message":{"type":"string"}}}}},"security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"paths":{"\/health":{"get":{"summary":"Servis durumunu kontrol et","security":[],"responses":{"200":{"description":"Servis durumu","content":{"application\/json":{"example":{"ok":true,"service":"clicktofior"}}}}}}},"\/provider-callbacks\/{provider}":{"get":{"summary":"Sa\u011flay\u0131c\u0131 geri bildirim do\u011frulamas\u0131","description":"Sa\u011flay\u0131c\u0131 do\u011frulamas\u0131 i\u00e7in herkese a\u00e7\u0131k servis. Meta bi\u00e7imindeki hub_challenge ve hub_verify_token desteklenir.","security":[],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","example":"meta"}},{"name":"hub_verify_token","in":"query","schema":{"type":"string"}},{"name":"hub_challenge","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Do\u011frulama yan\u0131t\u0131"},"403":{"description":"Ge\u00e7ersiz do\u011frulama anahtar\u0131"}}},"post":{"summary":"Sa\u011flay\u0131c\u0131 teslimat durumunu al","description":"Sa\u011flay\u0131c\u0131 teslimat bildirimleri i\u00e7in herkese a\u00e7\u0131k servis. Kanal entegrasyonunda settings.callback_secret tan\u0131ml\u0131ysa X-Callback-Secret ba\u015fl\u0131\u011f\u0131 veya secret sorgu parametresi ile g\u00f6nderin.","security":[],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","enum":["onesignal","meta","whatsapp","netgsm","telegram","webhook"]}},{"name":"X-Callback-Secret","in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application\/json":{"example":{"provider_message_id":"msg_123","status":"delivered"}}}},"responses":{"200":{"description":"Geri bildirim al\u0131nd\u0131","content":{"application\/json":{"example":{"accepted":true,"received":1,"updated":1,"not_found":0,"unauthorized":0}}}},"403":{"description":"Geri bildirim gizli anahtar\u0131 e\u015fle\u015fmedi"}}}},"\/events":{"post":{"summary":"M\u00fc\u015fteri veya ziyaret\u00e7i davran\u0131\u015f\u0131 g\u00f6nder","description":"events:write yetkisi gerekir. purchase (sat\u0131n alma), order_completed (sipari\u015f tamamland\u0131) ve conversion (d\u00f6n\u00fc\u015f\u00fcm) davran\u0131\u015flar\u0131 gelir ili\u015fkilendirme kay\u0131tlar\u0131n\u0131 tekille\u015ftirerek olu\u015fturur.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EventInput"}}}},"responses":{"201":{"description":"Davran\u0131\u015f al\u0131nd\u0131","content":{"application\/json":{"example":{"id":123,"accepted":true,"journey_executions_queued":1,"campaign_messages_queued":1,"attribution_rows":2}}}},"401":{"description":"Ge\u00e7ersiz API anahtar\u0131","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"403":{"description":"Eksik yetki kapsam\u0131","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"422":{"description":"Do\u011frulama hatas\u0131"}}}},"\/cart":{"get":{"summary":"Ziyaret\u00e7i veya m\u00fc\u015fterinin g\u00fcncel sepetini getir","description":"events:write yetkisi gerekir. add_to_cart ve remove_from_cart olaylar\u0131ndan g\u00fcncel sepeti hesaplar; son cart_clear veya sat\u0131n alma sonras\u0131 kay\u0131tlar\u0131 dikkate al\u0131r.","parameters":[{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"email","in":"query","schema":{"type":"string"}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"session_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"G\u00fcncel sepet","content":{"application\/json":{"example":{"items":[{"product_external_id":"SKU-1001","name":"Pamuklu G\u00f6mlek","quantity":2,"price":"1299.90","subtotal":2599.8}],"summary":{"items_count":1,"quantity":2,"subtotal":2599.8}}}}},"422":{"description":"Kullan\u0131c\u0131 kimli\u011fi eksik"}}}},"\/cart\/sync":{"post":{"summary":"G\u00fcncel sepeti senkronize et","description":"events:write yetkisi gerekir. Web sitesi veya ma\u011faza sistemi sepetteki son durumu tek istekte g\u00f6nderir. Sistem \u00f6nce ilgili kullan\u0131c\u0131 sepetini s\u0131f\u0131rlar, sonra g\u00f6nderilen \u00fcr\u00fcnleri sepete ekleme olay\u0131 olarak i\u015fler.","requestBody":{"required":true,"content":{"application\/json":{"example":{"visitor_id":"VISITOR_ID","session_id":"SESSION_ID","customer_external_id":"CUS-77","items":[{"product_external_id":"SKU-1001","sku":"SKU-1001","quantity":2,"price":1299.9}]}}}},"responses":{"200":{"description":"Sepet senkronize edildi","content":{"application\/json":{"example":{"accepted":1,"missing":[],"errors":[],"summary":{"items_count":1,"quantity":2,"subtotal":2599.8}}}}},"207":{"description":"K\u0131smi kabul"},"422":{"description":"Do\u011frulama hatas\u0131 veya kullan\u0131c\u0131 kimli\u011fi eksik"}}}},"\/cart\/clear":{"post":{"summary":"Ziyaret\u00e7i veya m\u00fc\u015fterinin sepetini temizle","description":"events:write yetkisi gerekir. cart_clear olay\u0131 olu\u015fturarak sonraki sepet okumalar\u0131nda \u00f6nceki sepete ekleme olaylar\u0131n\u0131 kapat\u0131r.","requestBody":{"required":true,"content":{"application\/json":{"example":{"visitor_id":"VISITOR_ID","session_id":"SESSION_ID"}}}},"responses":{"200":{"description":"Sepet temizlendi","content":{"application\/json":{"example":{"cleared":true}}}},"422":{"description":"Kullan\u0131c\u0131 kimli\u011fi eksik"}}}},"\/customers\/upsert":{"post":{"summary":"Son kullan\u0131c\u0131lar\u0131 olu\u015ftur veya g\u00fcncelle","description":"events:write yetkisi gerekir. G\u00f6vde tek m\u00fc\u015fteri veya {customers: [...]} format\u0131nda olabilir. external_id yoksa email kimlik olarak kullan\u0131l\u0131r.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"oneOf":[{"$ref":"#\/components\/schemas\/CustomerInput"},{"type":"object","required":["customers"],"properties":{"customers":{"type":"array","items":{"$ref":"#\/components\/schemas\/CustomerInput"}}}}]},"example":{"customers":[{"external_id":"customer-42","email":"customer@example.com","phone":"+905551112233","first_name":"Ay\u015fe","last_name":"Y\u0131lmaz","tags":["vip","online"],"attributes":{"city":"\u0130stanbul"},"email_marketing_consent":true,"email_marketing_consent_at":"2026-07-22T12:00:00+03:00","email_marketing_consent_source":"iys","email_marketing_consent_reference":"IYS-123456"}]}}}},"responses":{"200":{"description":"Son kullan\u0131c\u0131lar al\u0131nd\u0131","content":{"application\/json":{"example":{"accepted":1,"created":1,"updated":0,"errors":[]}}}},"207":{"description":"K\u0131smi ba\u015far\u0131","content":{"application\/json":{"example":{"accepted":1,"created":1,"updated":0,"errors":{"1":{"identity":["external_id veya email alanlar\u0131ndan en az biri gereklidir."]}}}}}},"401":{"description":"Ge\u00e7ersiz API anahtar\u0131","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"403":{"description":"Eksik yetki kapsam\u0131","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"422":{"description":"Do\u011frulama hatas\u0131"}}}},"\/orders\/upsert":{"post":{"summary":"Sipari\u015fleri olu\u015ftur veya g\u00fcncelle","description":"events:write yetkisi gerekir. G\u00f6vde tek sipari\u015f veya {orders: [...]} format\u0131nda olabilir. Ayn\u0131 order_id tekrar g\u00f6nderilirse yeni kay\u0131t a\u00e7\u0131lmaz, mevcut sipari\u015f hareketi g\u00fcncellenir.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"oneOf":[{"$ref":"#\/components\/schemas\/OrderInput"},{"type":"object","required":["orders"],"properties":{"orders":{"type":"array","items":{"$ref":"#\/components\/schemas\/OrderInput"}}}}]},"example":{"orders":[{"order_id":"ORD-10001","source":"online","currency":"TRY","amount":2499.8,"customer":{"external_id":"customer-42","email":"customer@example.com"},"items":[{"product_external_id":"SKU-1001","sku":"SKU-1001","name":"Pamuklu G\u00f6mlek","quantity":2,"price":1249.9}]}]}}}},"responses":{"200":{"description":"Sipari\u015fler al\u0131nd\u0131","content":{"application\/json":{"example":{"accepted":1,"created":1,"updated":0,"errors":[],"journey_executions_queued":0,"campaign_messages_queued":1,"attribution_rows":1}}}},"207":{"description":"K\u0131smi ba\u015far\u0131","content":{"application\/json":{"example":{"accepted":1,"created":1,"updated":0,"errors":{"1":{"order_id":["Sipari\u015f kodu zorunludur."]}}}}}},"401":{"description":"Ge\u00e7ersiz API anahtar\u0131","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"403":{"description":"Eksik yetki kapsam\u0131","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}},"422":{"description":"Do\u011frulama hatas\u0131"}}}},"\/orders":{"get":{"summary":"Aktar\u0131lan sipari\u015fleri listele","description":"events:write yetkisi gerekir. Bu servis entegrasyon sonras\u0131 sipari\u015fin sisteme ula\u015f\u0131p ula\u015fmad\u0131\u011f\u0131n\u0131 kontrol etmek i\u00e7indir.","parameters":[{"name":"order_id","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"source","in":"query","schema":{"type":"string"}},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"email","in":"query","schema":{"type":"string","format":"email"}},{"name":"date_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"date_till","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Sipari\u015f listesi","content":{"application\/json":{"example":{"data":[{"order_id":"ORD-10001","amount":2499.8,"currency":"TRY","items":[{"product_external_id":"SKU-1001","quantity":2}]}],"pagination":{"current_page":1,"per_page":50,"total":1,"last_page":1}}}}}}}},"\/orders\/summary":{"get":{"summary":"Sipari\u015f \u00f6zetini getir","description":"events:write yetkisi gerekir. Toplam sipari\u015f, gelir, ortalama sepet, \u00fcr\u00fcn e\u015fle\u015fmesi, kaynak, durum ve g\u00fcn k\u0131r\u0131l\u0131mlar\u0131n\u0131 d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"order_id","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"source","in":"query","schema":{"type":"string"}},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"email","in":"query","schema":{"type":"string","format":"email"}},{"name":"date_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"date_till","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000,"default":10000}}],"responses":{"200":{"description":"Sipari\u015f \u00f6zeti","content":{"application\/json":{"example":{"summary":{"orders":120,"revenue":248900.5,"currency":"TRY","average_order_value":2074.17,"customers":98,"items_count":165,"items_quantity":190,"matched_orders":112,"unmatched_orders":8},"by_source":[{"label":"\u0130nternet sitesi","orders":90,"revenue":190000}],"by_status":[{"label":"Tamamland\u0131","orders":120,"revenue":248900.5}],"by_day":[{"label":"2026-07-15","orders":12,"revenue":24900}],"recent_orders":[]}}}}}}},"\/orders\/{orderId}":{"get":{"summary":"Sipari\u015f detay\u0131n\u0131 getir","description":"events:write yetkisi gerekir. order_id veya order_number de\u011feriyle arar.","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string"},"example":"ORD-10001"}],"responses":{"200":{"description":"Sipari\u015f detay\u0131","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#\/components\/schemas\/Order"}}}}}},"404":{"description":"Sipari\u015f bulunamad\u0131"}}}},"\/products\/upsert":{"post":{"summary":"Katalog \u00fcr\u00fcnlerini olu\u015ftur veya g\u00fcncelle","description":"catalog:write yetkisi gerekir. G\u00f6vde tek \u00fcr\u00fcn veya {products: [...]} format\u0131nda olabilir.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"oneOf":[{"$ref":"#\/components\/schemas\/ProductInput"},{"type":"object","required":["products"],"properties":{"products":{"type":"array","items":{"$ref":"#\/components\/schemas\/ProductInput"}}}}]}}}},"responses":{"200":{"description":"\u00dcr\u00fcnler al\u0131nd\u0131","content":{"application\/json":{"example":{"accepted":2,"errors":[]}}}},"207":{"description":"K\u0131smi ba\u015far\u0131","content":{"application\/json":{"example":{"accepted":1,"errors":{"1":{"name":["\u00dcr\u00fcn ad\u0131 zorunludur."]}}}}}},"422":{"description":"Do\u011frulama veya limit hatas\u0131","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Error"}}}}}}},"\/products\/archive":{"post":{"summary":"\u00dcr\u00fcnleri pasife al","description":"catalog:write yetkisi gerekir. \u00dcr\u00fcnleri fiziksel olarak silmez; is_active=false yapar. Eski sipari\u015f ve davran\u0131\u015f verileri korunur, \u00fcr\u00fcn arama ve \u00f6neri taraf\u0131nda yay\u0131ndan kalkar.","requestBody":{"required":true,"content":{"application\/json":{"example":{"external_ids":["SKU-1001","SKU-1002"]}}}},"responses":{"200":{"description":"Pasife alma sonucu","content":{"application\/json":{"example":{"accepted":2,"archived":2,"missing":[],"errors":[]}}}},"207":{"description":"K\u0131smi do\u011frulama hatas\u0131"},"403":{"description":"Eksik yetki kapsam\u0131"}}}},"\/products":{"get":{"summary":"Aktar\u0131lan \u00fcr\u00fcnleri listele","description":"search:read veya catalog:write yetkisi gerekir. \u00dcr\u00fcn aktar\u0131m\u0131 sonras\u0131 katalog kapsam\u0131n\u0131 kontrol etmek i\u00e7in kullan\u0131l\u0131r.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"example":"g\u00f6mlek"},{"name":"external_id","in":"query","schema":{"type":"string"}},{"name":"sku","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"available","in":"query","schema":{"type":"boolean"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"\u00dcr\u00fcn listesi","content":{"application\/json":{"example":{"data":[{"external_id":"SKU-1001","sku":"SKU-1001","name":"Pamuklu G\u00f6mlek","available":true,"widgetable":true}],"pagination":{"current_page":1,"per_page":50,"total":1,"last_page":1}}}}}}}},"\/products\/sales":{"get":{"summary":"\u00dcr\u00fcn bazl\u0131 sat\u0131\u015f raporunu getir","description":"events:write, search:read veya catalog:write yetkisi gerekir. Sipari\u015f olaylar\u0131ndaki \u00fcr\u00fcn sat\u0131rlar\u0131n\u0131 katalogla e\u015fle\u015ftirerek \u00fcr\u00fcn baz\u0131nda gelir, adet ve sipari\u015f \u00f6zeti d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"date_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"date_till","in":"query","schema":{"type":"string","format":"date"}},{"name":"source","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"product_external_id","in":"query","schema":{"type":"string"}},{"name":"sku","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"sort_by","in":"query","schema":{"type":"string","enum":["revenue","quantity","orders","last_order_at"],"default":"revenue"}},{"name":"sort_dir","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"\u00dcr\u00fcn sat\u0131\u015f raporu","content":{"application\/json":{"example":{"data":[{"product_external_id":"SKU-1001","sku":"SKU-1001","name":"Pamuklu G\u00f6mlek","revenue":2499.8,"quantity":2,"orders_count":1,"customers_count":1,"matched":true}],"summary":{"revenue":2499.8,"quantity":2,"orders":1,"products":1,"unmatched_lines":0}}}}}}}},"\/products\/not-widgetable":{"get":{"summary":"G\u00f6sterime uygun olmayan \u00fcr\u00fcnleri getir","description":"search:read veya catalog:write yetkisi gerekir. \u00d6neri ve arama g\u00f6sterimlerinde kullan\u0131lamayan \u00fcr\u00fcnleri nedenleriyle listeler.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"G\u00f6sterime uygun olmayan \u00fcr\u00fcnler","content":{"application\/json":{"example":{"data":[{"external_id":"SKU-1001","name":"Pamuklu G\u00f6mlek","available":false,"widgetable":false,"reasons":["Sat\u0131\u015fa uygun de\u011fil veya stok yok"]}]}}}}}}},"\/products\/{externalId}\/counters":{"get":{"summary":"\u00dcr\u00fcn davran\u0131\u015f saya\u00e7lar\u0131n\u0131 getir","description":"search:read veya catalog:write yetkisi gerekir. \u00dcr\u00fcn g\u00f6r\u00fcnt\u00fcleme, sepete ekleme, istek listesi, sat\u0131n alma ve \u00f6neri etkile\u015fim saya\u00e7lar\u0131n\u0131 d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"externalId","in":"path","required":true,"schema":{"type":"string"},"example":"SKU-1001"}],"responses":{"200":{"description":"\u00dcr\u00fcn saya\u00e7lar\u0131","content":{"application\/json":{"example":{"product":{"external_id":"SKU-1001","sku":"SKU-1001","name":"Pamuklu G\u00f6mlek"},"daily":{"product_view":12,"add_to_cart":3,"purchase":1},"total":{"product_view":400,"add_to_cart":80,"purchase":20}}}}},"404":{"description":"\u00dcr\u00fcn bulunamad\u0131"}}}},"\/products\/{externalId}":{"get":{"summary":"\u00dcr\u00fcn detay\u0131n\u0131 getir","description":"search:read veya catalog:write yetkisi gerekir. external_id veya sku ile arar.","parameters":[{"name":"externalId","in":"path","required":true,"schema":{"type":"string"},"example":"SKU-1001"}],"responses":{"200":{"description":"\u00dcr\u00fcn detay\u0131","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#\/components\/schemas\/Product"}}}}}},"404":{"description":"\u00dcr\u00fcn bulunamad\u0131"}}},"delete":{"summary":"\u00dcr\u00fcn\u00fc pasife al","description":"catalog:write yetkisi gerekir. Fiziksel silme yapmaz; \u00fcr\u00fcn\u00fc yay\u0131ndan kald\u0131rmak i\u00e7in is_active=false yapar.","parameters":[{"name":"externalId","in":"path","required":true,"schema":{"type":"string"},"example":"SKU-1001"}],"responses":{"200":{"description":"\u00dcr\u00fcn pasife al\u0131nd\u0131","content":{"application\/json":{"example":{"archived":1,"data":{"external_id":"SKU-1001","available":false,"widgetable":false}}}}},"403":{"description":"Eksik yetki kapsam\u0131"},"404":{"description":"\u00dcr\u00fcn bulunamad\u0131"}}}},"\/products\/categories":{"get":{"summary":"Kategori k\u0131r\u0131l\u0131mlar\u0131n\u0131 getir","description":"search:read veya catalog:write yetkisi gerekir.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"Kategori listesi","content":{"application\/json":{"example":{"data":[{"category":"G\u00f6mlek","products_count":42,"active_count":40}]}}}}}}},"\/products\/brands":{"get":{"summary":"Marka k\u0131r\u0131l\u0131mlar\u0131n\u0131 getir","description":"search:read veya catalog:write yetkisi gerekir.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"Marka listesi","content":{"application\/json":{"example":{"data":[{"brand":"SmarterMoment","products_count":12,"active_count":12}]}}}}}}},"\/search\/config":{"get":{"summary":"Arama kutusu ayarlar\u0131n\u0131 getir","description":"search:read yetkisi gerekir. Web sitesindeki arama kutusu, limitleri, y\u00f6nlendirme ayar\u0131n\u0131 ve sonu\u00e7 \u015fablonlar\u0131n\u0131 bu servisle okuyabilir. Site taraf\u0131nda SmarterMoment.searchConfig() metodu bu servisi \u00e7a\u011f\u0131r\u0131r.","responses":{"200":{"description":"Arama ayarlar\u0131","content":{"application\/json":{"example":{"account":{"name":"Ana Hesap","code":"ana-hesap","domain":"https:\/\/example.com"},"settings":{"landing_page":"https:\/\/example.com\/search?q=%query%","language":"turkish","search_type":"full","params_sort":"alphabetic","only_full_match":false,"fuzziness":"auto","enable_last_queries":true,"recent_searches":true,"enable_old_price":true,"enable_full_search":true,"redirect_to_single_product":false,"stock_quantity":0,"instant_limit":6,"category_limit":10,"brands_instant_limit":5,"brands_limit":0,"results_page":{"enabled":true,"limit":8}},"templates":{"full":"","instant":""},"endpoints":{"config":"https:\/\/api.example.com\/v1\/search\/config","search":"https:\/\/api.example.com\/v1\/products\/search","suggest":"https:\/\/api.example.com\/v1\/products\/suggest","click":"https:\/\/api.example.com\/v1\/search\/click"}}}}},"403":{"description":"Eksik yetki kapsam\u0131"}}}},"\/products\/suggest":{"get":{"summary":"Arama kutusu \u00f6nerilerini getir","description":"search:read yetkisi gerekir. Kullan\u0131c\u0131 arama kutusuna yazarken \u00fcr\u00fcn, kategori, marka ve \u00f6nceki arama \u00f6nerilerini d\u00f6nd\u00fcr\u00fcr. Bu servis arama olay\u0131n\u0131 kaydetmez. Site taraf\u0131nda SmarterMoment.instantSearch(q) metodu bu servisi \u00e7a\u011f\u0131r\u0131r.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"example":"bot"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":6}},{"name":"category_limit","in":"query","schema":{"type":"integer","minimum":0,"maximum":20,"default":10}},{"name":"brand_limit","in":"query","schema":{"type":"integer","minimum":0,"maximum":20,"default":5}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"session_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Arama kutusu \u00f6nerileri","content":{"application\/json":{"example":{"query":"bot","expanded_terms":["bot","\u00e7izme"],"redirect_url":null,"products":[{"external_id":"SKU-1001","name":"Siyah Bot","category":"Bot","brand":"SmarterMoment","price":"1299.90","currency":"TRY"}],"groups":{"categories":[{"value":"Bot","count":18}],"brands":[{"value":"SmarterMoment","count":6}],"popular_queries":[{"query":"bot","count":24}],"recent_queries":[{"query":"siyah bot"}]},"settings":{"instant_limit":6,"category_limit":10,"brand_limit":5,"recent_searches":true}}}}}}}},"\/products\/search":{"get":{"summary":"\u00dcr\u00fcn aramas\u0131 yap","description":"search:read yetkisi gerekir. E\u015f anlaml\u0131 kelime, sat\u0131\u015f kural\u0131, yaz\u0131m hatas\u0131 tolerans\u0131, filtre k\u0131r\u0131l\u0131m\u0131 ve ki\u015fiselle\u015ftirilmi\u015f s\u0131ralama desteklenir. M\u00fc\u015fteri bazl\u0131 Arama Sonu\u00e7 Sayfas\u0131 Deste\u011fi i\u00e7in surface=results_page g\u00f6nderilir; sonu\u00e7 limiti hesap ayar\u0131ndaki 4 veya 8 de\u011ferinden al\u0131n\u0131r.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"g\u00f6mlek"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":12}},{"name":"surface","in":"query","schema":{"type":"string","enum":["searchbox","results_page"],"default":"searchbox"}},{"name":"category","in":"query","schema":{"type":"string"},"example":"G\u00f6mlek"},{"name":"brand","in":"query","schema":{"type":"string"},"example":"SmarterMoment"},{"name":"price_min","in":"query","schema":{"type":"number","minimum":0}},{"name":"price_max","in":"query","schema":{"type":"number","minimum":0}},{"name":"hide_out_of_stock","in":"query","schema":{"type":"boolean"}},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"session_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Arama sonu\u00e7lar\u0131","content":{"application\/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"surface":{"type":"string","enum":["searchbox","results_page"]},"expanded_terms":{"type":"array","items":{"type":"string"}},"personalized":{"type":"boolean"},"redirect_url":{"type":"string","nullable":true},"filters":{"type":"object","additionalProperties":true},"search_backend":{"type":"object","additionalProperties":true},"facets":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object"}},"brands":{"type":"array","items":{"type":"object"}}}},"matched_rules":{"type":"array","items":{"type":"object"}},"results":{"type":"array","items":{"$ref":"#\/components\/schemas\/Product"}}}},"example":{"query":"gomlek","surface":"results_page","expanded_terms":["gomlek","g\u00f6mlek","shirt"],"personalized":true,"redirect_url":null,"filters":{"category":"G\u00f6mlek"},"search_backend":{"driver":"database"},"facets":{"categories":[{"value":"G\u00f6mlek","count":42}],"brands":[{"value":"SmarterMoment","count":12}]},"matched_rules":[{"id":7,"name":"G\u00f6mlek synonym","type":"synonym"}],"results":[{"external_id":"SKU-1001","name":"Pamuklu G\u00f6mlek","category":"G\u00f6mlek","brand":"SmarterMoment","price":"1299.90","currency":"TRY","badges":["\u00c7ok satan"]}]}}}},"403":{"description":"Eksik yetki kapsam\u0131 veya Arama Sonu\u00e7 Sayfas\u0131 Deste\u011fi kapal\u0131"}}}},"\/search\/click":{"post":{"summary":"Arama sonucu t\u0131klamas\u0131n\u0131 kaydet","description":"search:read yetkisi gerekir. Arama sonu\u00e7 sayfas\u0131nda veya anl\u0131k arama kutusunda kullan\u0131c\u0131 bir \u00fcr\u00fcne ya da y\u00f6nlendirme sonucuna t\u0131klad\u0131\u011f\u0131nda g\u00f6nderilir.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","example":"bot"},"product_external_id":{"type":"string","nullable":true,"example":"SKU-1001"},"sku":{"type":"string","nullable":true,"example":"SKU-1001"},"position":{"type":"integer","minimum":1,"maximum":1000,"nullable":true,"example":3},"redirect_url":{"type":"string","format":"uri","nullable":true,"example":"https:\/\/site.com\/urun\/sku-1001"},"customer_external_id":{"type":"string","nullable":true},"visitor_id":{"type":"string","nullable":true},"session_id":{"type":"string","nullable":true},"source":{"type":"string","nullable":true,"example":"search_results"},"payload":{"type":"object","nullable":true,"additionalProperties":true}}},"example":{"q":"bot","product_external_id":"SKU-1001","position":2,"visitor_id":"VISITOR_ID","session_id":"SESSION_ID","source":"search_results"}}}},"responses":{"201":{"description":"T\u0131klama kaydedildi","content":{"application\/json":{"example":{"accepted":true,"event_id":123,"matched_product":true}}}}}}},"\/search\/popular-queries":{"get":{"summary":"Pop\u00fcler arama sorgular\u0131n\u0131 getir","description":"search:read yetkisi gerekir. Son arama olaylar\u0131ndan en \u00e7ok aranan kelimeleri, sonu\u00e7suz arama say\u0131lar\u0131n\u0131, t\u0131klama say\u0131s\u0131n\u0131 ve CTR de\u011ferini d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"date_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"date_till","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Pop\u00fcler sorgular","content":{"application\/json":{"example":{"data":[{"query":"bot","count":24,"no_result_count":2,"click_count":9,"ctr":37.5,"clicked_products":[{"external_id":"SKU-1001","click_count":4}],"last_searched_at":"2026-07-15T10:20:00+03:00"}],"summary":{"total_searches":24,"unique_queries":1,"no_result_total":2,"click_total":9}}}}}}}},"\/search\/no-result-queries":{"get":{"summary":"Sonu\u00e7suz arama sorgular\u0131n\u0131 getir","description":"search:read yetkisi gerekir. Sonu\u00e7 d\u00f6nmeyen aramalar\u0131 listeler; e\u015f anlaml\u0131, y\u00f6nlendirme veya \u00fcr\u00fcn besleme aksiyonu i\u00e7in kullan\u0131l\u0131r.","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"date_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"date_till","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Sonu\u00e7suz sorgular","content":{"application\/json":{"example":{"data":[{"query":"kirmizi bot","count":5,"no_result_count":5,"click_count":0,"ctr":0,"clicked_products":[],"last_searched_at":"2026-07-15T10:20:00+03:00"}],"summary":{"unique_queries":1,"no_result_total":5,"click_total":0}}}}}}}},"\/recommendations":{"get":{"summary":"\u00dcr\u00fcn \u00f6nerilerini getir","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. Kampanyada minimum sipari\u015f tutar\u0131 varsa order_amount g\u00f6nderilmelidir.","parameters":[{"name":"scenario","in":"query","schema":{"type":"string","enum":["homepage","product_detail","category","cart","checkout","search","email","recently_viewed","trending","similar","frequently_bought_together"],"default":"homepage"}},{"name":"product_external_id","in":"query","schema":{"type":"string"}},{"name":"product_external_ids[]","in":"query","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":8}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"session_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"\u00d6neri sonu\u00e7lar\u0131","content":{"application\/json":{"schema":{"type":"object","properties":{"scenario":{"type":"string"},"strategy":{"type":"string"},"model":{"type":"string"},"results":{"type":"array","items":{"$ref":"#\/components\/schemas\/Product"}}}}}}}}}},"\/collections\/{code}":{"get":{"summary":"\u00dcr\u00fcn koleksiyonunu getir","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. Anasayfa, benzer \u00fcr\u00fcn, kategori, sepet tamamlay\u0131c\u0131lar\u0131 veya pop\u00fcler \u00fcr\u00fcnler gibi haz\u0131r \u00fcr\u00fcn listelerini d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"example":"trending"},{"name":"product_external_id","in":"query","schema":{"type":"string"}},{"name":"product_external_ids[]","in":"query","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":8}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"session_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Koleksiyon \u00fcr\u00fcnleri","content":{"application\/json":{"schema":{"type":"object","properties":{"collection":{"type":"string"},"scenario":{"type":"string"},"strategy":{"type":"string"},"model":{"type":"string"},"results":{"type":"array","items":{"$ref":"#\/components\/schemas\/Product"}}}},"example":{"collection":"trending","scenario":"trending","strategy":"trending","model":"behavioral_predictive_v1","results":[{"external_id":"SKU-1001","name":"Pamuklu G\u00f6mlek","price":"1299.90","currency":"TRY"}]}}}}}}},"\/onsite\/campaigns":{"get":{"summary":"Aktif site i\u00e7i kampanyalar\u0131 getir","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. Ziyaret\u00e7i ba\u011flam\u0131na g\u00f6re popup, banner, hikaye, oyunla\u015ft\u0131rma ve NPS kampanya verilerini d\u00f6ner.","parameters":[{"name":"placement","in":"query","schema":{"type":"string"},"example":"cart"},{"name":"event","in":"query","schema":{"type":"string"},"example":"add_to_cart"},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"session_id","in":"query","schema":{"type":"string"}},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"cart_value","in":"query","schema":{"type":"number"}},{"name":"exit_intent","in":"query","schema":{"type":"boolean"}},{"name":"device","in":"query","schema":{"type":"string","enum":["desktop","mobile"]}},{"name":"returning_visitor","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"E\u015fle\u015fen kampanyalar","content":{"application\/json":{"example":{"campaigns":[{"id":1,"type":"popup","placement":"cart","experiment":{"holdout":false,"holdout_percentage":10},"variant":{"name":"A - Discount"}}]}}}}}}},"\/product-alerts":{"get":{"summary":"\u00dcr\u00fcn uyar\u0131 aboneliklerini listele","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. Stokta haber ver ve fiyat d\u00fc\u015f\u00fcnce haber ver kay\u0131tlar\u0131n\u0131 filtreleyerek d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["back_in_stock","price_drop"]}},{"name":"product_external_id","in":"query","schema":{"type":"string"}},{"name":"email","in":"query","schema":{"type":"string"}},{"name":"phone","in":"query","schema":{"type":"string"}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["active","triggered","paused","canceled","all"],"default":"active"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Abonelik listesi","content":{"application\/json":{"example":{"data":[{"id":1,"type":"price_drop","product_external_id":"SKU-1001","email":"musteri@example.com","status":"active","target_price":"999.90"}],"pagination":{"current_page":1,"per_page":50,"total":1,"last_page":1}}}}}}}},"\/product-alerts\/subscribe":{"post":{"summary":"Stok veya fiyat uyar\u0131s\u0131na abone et","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir.","requestBody":{"required":true,"content":{"application\/json":{"example":{"type":"price_drop","product_external_id":"SKU-1001","email":"customer@example.com","target_price":999.9}}}},"responses":{"201":{"description":"Abonelik olu\u015fturuldu","content":{"application\/json":{"example":{"id":1,"subscribed":true,"notified":false,"status":"active"}}}},"422":{"description":"Do\u011frulama hatas\u0131"}}}},"\/product-alerts\/unsubscribe":{"post":{"summary":"\u00dcr\u00fcn uyar\u0131 aboneli\u011fini kapat","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. Ayn\u0131 \u00fcr\u00fcn, uyar\u0131 tipi ve kullan\u0131c\u0131 kimli\u011fi i\u00e7in aktif aboneli\u011fi iptal eder.","requestBody":{"required":true,"content":{"application\/json":{"example":{"type":"price_drop","product_external_id":"SKU-1001","email":"musteri@example.com"}}}},"responses":{"200":{"description":"Abonelik kapat\u0131ld\u0131","content":{"application\/json":{"example":{"subscribed":false,"status":"canceled","canceled_count":1}}}},"422":{"description":"Do\u011frulama hatas\u0131"}}}},"\/product-alerts\/status":{"get":{"summary":"Uyar\u0131 abonelik durumunu kontrol et","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. En az bir kullan\u0131c\u0131 kimli\u011fi g\u00f6nderilmelidir.","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["back_in_stock","price_drop"]}},{"name":"product_external_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"email","in":"query","schema":{"type":"string"}},{"name":"phone","in":"query","schema":{"type":"string"}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"customer_external_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Abonelik durumu","content":{"application\/json":{"example":{"subscribed":true}}}},"422":{"description":"Do\u011frulama hatas\u0131"}}}},"\/notifications":{"get":{"summary":"Bildirim merkezi mesajlar\u0131n\u0131 getir","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir.","parameters":[{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"channel","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Mesajlar","content":{"application\/json":{"example":{"messages":[{"id":1,"title":"Sipari\u015f kargoya verildi"}]}}}}}},"post":{"summary":"\u0130\u015flemsel veya tetiklenen mesaj olu\u015ftur","description":"messages:write yetkisi gerekir. \u0130leri tarihli g\u00f6nderim i\u00e7in scheduled_at alan\u0131n\u0131 ISO 8601 bi\u00e7iminde g\u00f6nderin.","requestBody":{"required":true,"content":{"application\/json":{"example":{"channel":"sms","type":"transactional","recipient_phone":"+905551112233","title":"Sipari\u015f","body":"Sipari\u015finiz yola \u00e7\u0131kt\u0131.","send_now":true}}}},"responses":{"201":{"description":"Mesaj al\u0131nd\u0131","content":{"application\/json":{"example":{"id":1,"status":"queued"}}}}}}},"\/notifications\/{notification}\/read":{"post":{"summary":"Bildirimi okundu i\u015faretle","parameters":[{"name":"notification","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Okunma durumu","content":{"application\/json":{"example":{"read":true}}}}}}},"\/wallet\/passes":{"post":{"summary":"C\u00fczdan kart\u0131 veya kupon olu\u015ftur","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir.","requestBody":{"required":true,"content":{"application\/json":{"example":{"campaign_id":1,"customer_external_id":"customer-42","email":"customer@example.com","order_amount":1500,"provider":"both"}}}},"responses":{"201":{"description":"Kart olu\u015fturuldu","content":{"application\/json":{"example":{"id":1,"pass_token":"wlt_xxx","coupon_code":"SUMMER-ABC123","wallet":{"apple":{"ready":true,"download_url":"https:\/\/api.example.com\/v1\/wallet\/passes\/wlt_xxx\/apple.pkpass"},"google":{"ready":true,"url":"https:\/\/pay.google.com\/gp\/v\/save\/eyJ..."}}}}}}}}},"\/wallet\/passes\/{token}\/apple.pkpass":{"get":{"summary":"\u0130mzal\u0131 Apple c\u00fczdan kart\u0131n\u0131 indir","description":"Herkese a\u00e7\u0131k token servisi. Kampanya, hesap veya ortam \u00fczerinde Apple c\u00fczdan sertifika ayarlar\u0131 gerekir.","security":[],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"},"example":"wlt_xxx"}],"responses":{"200":{"description":"PKPass paketi","content":{"application\/vnd.apple.pkpass":{"schema":{"type":"string","format":"binary"}}}},"422":{"description":"Apple c\u00fczdan kimlik bilgileri eksik"}}}},"\/widgets":{"get":{"summary":"Aktif g\u00f6sterim alanlar\u0131n\u0131 listele","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. Web sitesinde kullan\u0131labilecek yay\u0131ndaki g\u00f6sterim alanlar\u0131n\u0131 d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"type","in":"query","schema":{"type":"string"},"example":"recommendation"},{"name":"placement","in":"query","schema":{"type":"string"},"example":"home"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"G\u00f6sterim alanlar\u0131","content":{"application\/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#\/components\/schemas\/GosterimAlani"}}}},"example":{"data":[{"code":"home-recommendations","name":"Anasayfa \u00f6nerileri","type":"recommendation","placement":"home","traffic_percentage":100}]}}}}}}},"\/widgets\/{code}\/metrics":{"get":{"summary":"G\u00f6sterim alan\u0131 performans\u0131n\u0131 getir","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. Se\u00e7ilen alan\u0131n g\u00f6sterim, t\u0131klama, CTR ve varsa katk\u0131 gelirini d\u00f6nd\u00fcr\u00fcr.","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"example":"home-recommendations"},{"name":"date_from","in":"query","schema":{"type":"string","format":"date"}},{"name":"date_till","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":5000,"default":5000}}],"responses":{"200":{"description":"G\u00f6sterim alan\u0131 performans\u0131","content":{"application\/json":{"example":{"widget":{"code":"home-recommendations","name":"Anasayfa \u00f6nerileri","type":"recommendation","placement":"home","status":"active"},"summary":{"requests":10,"impressions":100,"clicks":8,"ctr":8,"events":118},"attribution":{"enabled":true,"conversions":3,"credited_revenue":450.5,"direct_revenue":300,"assisted_revenue":150.5}}}}},"404":{"description":"G\u00f6sterim alan\u0131 bulunamad\u0131"}}}},"\/widgets\/{code}\/content":{"get":{"summary":"G\u00f6sterim alan\u0131 i\u00e7eri\u011fini getir","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir. Alan tipine g\u00f6re \u00f6neri \u00fcr\u00fcn\u00fc, arama sonucu veya kampanya i\u00e7eri\u011fini tek cevapta d\u00f6nd\u00fcr\u00fcr. Bu servis okuma yapar; g\u00f6sterim ve t\u0131klama \u00f6l\u00e7\u00fcm\u00fc i\u00e7in ayr\u0131ca event g\u00f6nderilmelidir.","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"example":"home-recommendations"},{"name":"scenario","in":"query","schema":{"type":"string","enum":["homepage","product_detail","category","cart","checkout","search","email","recently_viewed","trending","similar","frequently_bought_together"]}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":8}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"product_external_id","in":"query","schema":{"type":"string"}},{"name":"customer_external_id","in":"query","schema":{"type":"string"}},{"name":"visitor_id","in":"query","schema":{"type":"string"}},{"name":"session_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"G\u00f6sterim alan\u0131 i\u00e7eri\u011fi","content":{"application\/json":{"example":{"widget":{"code":"home-recommendations","name":"Anasayfa \u00f6nerileri","type":"recommendation","placement":"home"},"eligible":true,"content":{"type":"product_recommendations","scenario":"homepage","model":"behavioral_predictive_v1","results":[{"external_id":"SKU-1001","name":"Pamuklu G\u00f6mlek","price":"1299.90","currency":"TRY"}]}}}}},"403":{"description":"Eksik yetki kapsam\u0131"},"404":{"description":"G\u00f6sterim alan\u0131 bulunamad\u0131"}}}},"\/widgets\/{code}":{"get":{"summary":"Aktif g\u00f6sterim alan\u0131 ayar\u0131n\u0131 getir","description":"G\u00f6sterim alan\u0131 okuma yetkisi (widgets:read) gerekir.","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string"},"example":"home-recommendations"}],"responses":{"200":{"description":"G\u00f6sterim alan\u0131 ayar\u0131","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/GosterimAlani"}}}},"404":{"description":"G\u00f6sterim alan\u0131 bulunamad\u0131"}}}}}}