Uygulamalar

Uygulama İncelemeleri

Belirli bir Steam uygulaması için kullanıcı incelemelerinin sayfalanmış listesini alın.

Endpoint

Bu endpoint, belirli bir Steam uygulaması için kullanıcı incelemelerinin sayfalanmış bir listesini döndürür. Her giriş; inceleme metnini, yazarın Steam ID'sini ve inceleme anındaki oyun süresini, oy sayılarını ve zaman damgalarını içerir.

GET   /v2/steam/apps/{appId}/reviews

Gerekli parametreler

appId
number
Steam uygulama kimliği.

Sorgu parametreleri

cursor
string
Sayfalama imleci. Sonraki sayfayı almak için önceki yanıttan gelen cursor değerini geçirin.

Kimlik Doğrulama

API anahtarınızı x-api-key istek başlığı olarak ekleyin.

x-api-key: YourSecretAPIKey

Yanıt alanları

AlanTürAçıklama
resultsarrayİnceleme nesneleri dizisi.
cursorstringSonraki sayfa için imleç.
hasMorebooleanDaha fazla sonuç olup olmadığı. false olduğunda son sayfaya ulaştınız.

İnceleme nesnesi

AlanTürAçıklama
_idstringBelge kimliği.
recommendationIdstringSteam'in inceleme tanımlayıcısı.
appIdnumberİncelemenin ait olduğu Steam uygulama kimliği.
authorobjectYazar bilgisi. Aşağıdaki alanlara bakın.
commentCountnumberİnceleme üzerindeki yorum sayısı.
languagestringİnceleme dili (ör. english, french, german).
receivedForFreebooleanYazarın ürünü ücretsiz alıp almadığı.
reviewstringİnceleme metni.
steamPurchasebooleanYazarın ürünü Steam üzerinden satın alıp almadığı.
timestampCreatednumberİncelemenin ilk yayınlandığı Unix zaman damgası (saniye).
timestampUpdatednumberİncelemenin son düzenlendiği Unix zaman damgası (saniye).
votedUpbooleanOlumlu (önerilen) inceleme için true, olumsuz için false.
votesFunnynumberİncelemenin aldığı "komik" oy sayısı.
votesUpnumberİncelemenin aldığı "yararlı" oy sayısı.
weightedVoteScorestringSteam'in ağırlıklı yararlılık puanı (string olarak ondalık, 0–1).
writtenDuringEarlyAccessbooleanİncelemenin Early Access döneminde yazılıp yazılmadığı.

Yazar nesnesi

AlanTürAçıklama
steamIdstringİncelemecinin 64-bit Steam ID'si.
playtimeAtReviewnumberYazarın inceleme yazdığı sırada oynadığı dakika sayısı.

Yanıt örneği

response.json
{
  "success": true,
  "results": [
    {
      "_id": "69e800477ab054081ee245cd",
      "recommendationId": "223802362",
      "appId": 2393730,
      "author": {
        "steamId": "76561198808328024",
        "playtimeAtReview": 163
      },
      "commentCount": 0,
      "language": "english",
      "receivedForFree": false,
      "review": "Great game! Had a lot of fun. It's obviously not a full flight sim, but more of a take off and land sim with management element.",
      "steamPurchase": true,
      "timestampCreated": 1776804577,
      "timestampUpdated": 1776804734,
      "votedUp": true,
      "votesFunny": 0,
      "votesUp": 1,
      "weightedVoteScore": "0.529703021049499512",
      "writtenDuringEarlyAccess": false
    }
  ],
  "cursor": "eyJ2IjoxNzc2NzY4NDg3LCJpZCI6IjY5ZTgwMDQ3N2FiMDU0MDgxZWUyNDVmYSJ9",
  "hasMore": true
}
Tüm inceleme geçmişini almak için imleç tabanlı sayfalama kullanın. hasMorefalse olduğunda son sayfaya ulaşmış olursunuz.