Public Carousel Manager

Aktif bir carousel kaydını code üzerinden frontend tüketimi için getirir. Public response yalnızca:

• aktif carousel kayıtlarını,
• aktif item'ları,
• yayın aralığı içinde kalan item'ları

döndürür.

Base URL: /api/public/carousel-manager/carousels Yetkilendirme: X-Api-Key

bilgi

Controller AllowAnonymous olsa da tenant çözümleme için X-Api-Key header'ı gereklidir.

---

GET /{code}

Belirli bir carousel'i benzersiz code değeri ile getirir.

Headers:

X-Api-Key: customer-api-key

Query Parametreleri:

Parametre	Tip	Açıklama
lang	string	İstenen dil kodu

Örnek: GET /api/public/carousel-manager/carousels/home-hero?lang=tr

Response — 200 OK:

{
  "success": true,
  "data": {
    "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "code": "home-hero",
    "name": "Homepage Hero",
    "languageCode": "tr",
    "defaultLanguageCode": "tr",
    "items": [
      {
        "id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
        "desktopImageUrl": "https://cdn.example.com/hero-desktop.webp",
        "mobileImageUrl": "https://cdn.example.com/hero-mobile.webp",
        "sortOrder": 1,
        "openInNewTab": false,
        "title": "Yeni Sezon Koleksiyonu",
        "subtitle": "Kampanyayi kesfet",
        "ctaText": "Incele",
        "ctaLink": "/kampanyalar/yeni-sezon",
        "altText": "Yeni sezon banner gorseli"
      }
    ]
  }
}

Dil Fallback Davranışı

• lang verilmezse varsayılan tenant dili kullanılır.
• İstenen dil bir item için yoksa varsayılan dil çevirisine düşülür.
• Varsayılan dil de yoksa kalan ilk translation kaydı seçilir.

Yayın Filtreleme

Public response tarafında item aşağıdaki durumda döner:

• item.isActive = true
• publishStartDate boş veya geçmişte
• publishEndDate boş veya gelecekte

Olası Hatalar

Kod	Durum
403	carousel-manager modülü müşteriye atanmamış veya global olarak pasif
404	İstenen code ile aktif carousel bulunamadı