Değerlendirmeler
Yayımlanmış müşteri değerlendirmeleri, puan özeti ve işletme yanıtı.
Bu sayfadaki uçlar
Her satır API referansındaki tam tanıma gider — alanlar, yanıt kodları ve deneme konsolu orada.
Değerlendirmeleri listeleme
curl "https://api.supergelsin.com/api/partner/v1/reviews?limit=20&minRating=4&replyStatus=none" \
-H "Authorization: Basic $(printf '%s:%s' "$API_KEY" "$API_SECRET" | base64)" \
-H "X-Integrator: Ornek POS" \
-H "X-Operator: kasiyer_01"{
"scores": { "average": 4.75, "count": 4, "distribution": { "5": 3, "4": 1, "3": 0, "2": 0, "1": 0 } },
"items": [
{
"id": "cm_ornek_yorum",
"rating": 5,
"title": null,
"comment": "Çok lezzetli",
"verified": true,
"deliveryRating": 4,
"aspectScores": { "taste": 5 },
"reasons": [],
"reply": null,
"createdAt": "2026-01-31T10:00:00.000Z"
}
],
"nextCursor": null
}Liste yeniden eskiye sıralıdır ve imleçle sayfalanır. Yorum metni platformun maskelediği sürümdür; müşteri kimliği ve ham metin bu yüzeyden çıkmaz. scores yayımlanmış bütün yorumlardan hesaplanır ve süzgeçlerden etkilenmez.
Sorgu parametreleri
| Alan | Tip | Açıklama |
|---|---|---|
limit | integer | Sayfa boyutu, 1–50; varsayılan 20. |
minRating | integer | Bu puan ve üzerindeki yorumlar (1–5). Verilmezse puan süzgeci yoktur. |
replyStatus | enum | İşletme yanıtının durumuna göre süzer: none, pending, approved, rejected. Geçersiz değer 400 bad_request döner. |
cursor | string | Önceki yanıttaki nextCursor değeri. |
Yorum alanları
| Alan | Tip | Açıklama |
|---|---|---|
verified | boolean | Gerçekten sipariş vermiş müşteri mi. |
deliveryRating | integer | null | Teslimat puanı. İşletme puan ortalamasına (scores.average) dahil edilmez; ortalama rating alanından hesaplanır. |
aspectScores | object | null | Boyut bazlı puanlar. |
reply | object | null | İşletmenin yanıtı (text) ve durumu (pending, approved, rejected); yanıt yoksa null. Yanıt moderasyondan geçer; müşteri yalnız onaylanmış yanıtı görür. |
Yoruma yanıt verme
curl -X POST "https://api.supergelsin.com/api/partner/v1/reviews/cm_ornek_yorum/reply" \
-H "Authorization: Basic $(printf '%s:%s' "$API_KEY" "$API_SECRET" | base64)" \
-H "X-Integrator: Ornek POS" \
-H "X-Operator: kasiyer_01" \
-H "Content-Type: application/json" \
-d '{ "text": "Geri bildiriminiz için teşekkür ederiz." }'{ "id": "cm_ornek_yorum", "replyStatus": "pending" }Yanıt moderasyondan geçer (replyStatus: pending). Boş text gönderilmesi mevcut yanıtı kaldırır; bu durumda replyStatus null döner. Yanıt en çok 1000 karakterdir (400 too_long) ve yalnız yayımlanmış yoruma verilebilir (409 not_published; current yorumun durumunu verir).
Yanıt, müşteriye tanımlanan kupondan söz edebilir. Kuponu değerlendirmenin karşılığı gibi sunan yanıt kaydedilmez ve
400 coupon_reward_wording döner: kuponu yorumun içeriğine ya da puanına bağlamayın, değerlendirmenin değiştirilmesi veya silinmesi koşuluna bağlamayın ve değerlendirme karşılığında kupon vaat etmeyin.