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.
createdAtunix 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.