Yorum puan dağılımı

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

Bir ürünün onaylı yorumlarının yıldız kırılımını, toplam yorum sayısını ve puan ortalamasını döner. Ürün detayındaki "toplam değerlendirme" bölümünü tek istekle çizmek için kullanılır; yorumların kendisi için Yorumlar kaynağına bakın.

Listeleme

GET /comment-rating-breakdowns

Ürün kimliği zorunludur. Verilmezse istek 400 döner.

curl "https://<domain>/api/v3/storefront/2026-01/comment-rating-breakdowns?filter[productId]=771" \
  -H "Accept: application/vnd.api+json" \
  -H "Authorization: Bearer <access_token>"

{
  "jsonapi": { "version": "1.0" },
  "data": [
    {
      "type": "comment-rating-breakdowns",
      "id": "771",
      "attributes": {
        "productId": 771,
        "total": 0,
        "average": 0,
        "distribution": { "1": 0, "2": 0, "3": 0, "4": 0, "5": 0 }
      },
      "links": {
        "self": "https://<domain>/api/v3/storefront/2026-01/comment-rating-breakdowns/771"
      }
    }
  ]
}

Kayıt kimliği (id) ürün kimliğidir. Sayfalama yoktur; istenen her ürün için tam olarak bir kayıt döner.

Alanlar

distribution her zaman beş anahtarın tamamını içerir; karşılığı olmayan yıldız 0 gelir, anahtar hiç eksilmez. Yıldız çubuklarını çizerken eksik anahtar kontrolü yapmanıza gerek yoktur.

Yorumu olmayan üründe total ve average 0 döner. Boş durumu average üzerinden değil total === 0 üzerinden ayırt edin — ortalaması gerçekten düşük bir ürünle yorumu olmayan ürün aynı average değerini verebilir.

Filtreler

Birden çok ürünün dağılımı tek istekte alınabilir:

curl "https://<domain>/api/v3/storefront/2026-01/comment-rating-breakdowns?filter[productId]=771,772" \
  -H "Accept: application/vnd.api+json" \
  -H "Authorization: Bearer <access_token>"

Yalnızca onaylı yorumlar sayılır. Onay bekleyen veya reddedilmiş yorumlar hiçbir alana yansımaz — bu nedenle total değeri, ürün kaynağındaki commentCount ile aynıdır.