T-SOFT/Storefront API/Yorumlar

Yorumlar

Ürün yorumları, ürün kaynağına ?include=comments parametresiyle eklenir — ayrı bir istek gerekmez. Onaylı yorumları okumak için bağımsız ve sayfalı bir uç noktası yoktur. Yorum göndermek için Yorum Yazma sayfasına bak.

Yetki:storefront:read — herkese açık, token isteğe bağlı.

Listeleme

GET /products/{id}?include=comments
curl -s 'https://<domain>/api/v3/storefront/2026-01/products/42?include=comments' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer <TOKEN>'

Yanıt

{
  "data": {
    "type": "products",
    "id": "42",
    "attributes": { "…": "…" }
  },
  "included": [
    {
      "type": "product-comments",
      "id": "7",
      "attributes": {
        "productId": 42,
        "rating": 4,
        "title": "Harika ürün",
        "comment": "Çok memnun kaldım.",
        "isNameDisplayed": true,
        "authorName": "Ali Veli",
        "createdAt": 1751536800
      }
    }
  ]
}

Kurallar

  • Sadece onaylı yorumlar yanıtta yer alır. Moderasyon sunucuda zorlanır; istemcinin filtre uygulaması gerekmez.
  • authorName, yorum sahibi adını gizli tutmayı seçtiyse maskelenmiş döner: her kelimenin ilk harfi kalır, kalanı yıldızla gösterilir (örn. "A** V***"). Maskeli ad doğrudan gösterilebilir.
  • Yorumlar en yeniden eskiye sıralanır; aynı tarihli iki yorumda sonradan eklenen üstte gelir.
  • Yıldız kırılımı ve puan ortalaması için Yorum puan dağılımı kaynağına bakın.
  • createdAt unix zaman damgasıdır — saniye cinsinden (milisaniye değil). Tarih objesine çevirirken bu ayrımı unutma.
  • Kimlik alanları (üye id, e-posta, IP) yanıtta asla yer almaz.
include=commentssayfalanmaz — ürünün tüm onaylı yorumları tek yanıtta döner. Yüksek yorumlu ürünlerde UI tarafında sanallaştırma (virtual scroll) veya kesme uygula.