Uygulamalar

Uygulama Detayları

Belirli bir Steam uygulamasıyla ilgili açıklamalar, görseller, fiyatlandırma ve metadata dahil ayrıntılı bilgi al.

Endpoint

Bu endpoint, belirli bir Steam uygulaması hakkında açıklamalar, görseller, fiyatlandırma, sistem gereksinimleri ve diğer metadata dahil ayrıntılı bilgi döndürür.

GET   /v2/steam/apps/{appId}

Gerekli parametreler

appId
number
Steam application ID.

Kimlik Doğrulama

API anahtarını x-api-key request header'ı olarak ekle.

x-api-key: YourSecretAPIKey

Yanıt alanları

AlanTipAçıklama
resultobject|nullUygulama detayları nesnesi, bulunamazsa null

Uygulama detayları nesnesi

AlanTipAçıklama
_idstringBelge ID'si
appIdnumberSteam application ID
steamAppIdstring|nullSteamApp belgesine referans
namestring|nullUygulama adı
typestring|nullUygulama türü (örn. "game", "dlc")
requiredAgenumberMinimum gerekli yaş (yoksa 0)
isFreebooleanUygulamanın ücretsiz olup olmadığı
shortDescriptionstring|nullKısa açıklama
detailedDescriptionstring|nullTam HTML açıklaması
aboutTheGamestring|null"Oyun hakkında" HTML içeriği
developersstringGeliştirici adları listesi
publishersstringYayıncı adları listesi
headerImagestring|nullHeader görseli URL'si
capsuleImagestring|nullCapsule görseli URL'si
capsuleImageV5string|nullCapsule görseli v5 URL'si
backgroundstring|nullArka plan görseli URL'si
backgroundRawstring|nullHam arka plan görseli URL'si
screenshotsarrayEkran görüntüsü nesneleri dizisi
moviesarrayVideo/fragman nesneleri dizisi
categoriesarrayKategori nesneleri dizisi
genresarrayTür nesneleri dizisi
platformsobjectPlatform uygunluğu
metacriticobjectMetacritic puan verileri
recommendationsobjectÖneri sayısı
achievementsobjectBaşarım verileri
releaseDateobjectÇıkış tarihi bilgileri
supportInfoobjectDestek iletişim bilgileri
websitestring|nullResmi web sitesi URL'si
legalNoticestring|nullYasal uyarı metni
reviewsstring|nullİnceleme alıntıları
pcRequirementsobjectPC sistem gereksinimleri
macRequirementsobjectMac sistem gereksinimleri
linuxRequirementsobjectLinux sistem gereksinimleri
priceOverviewobjectGüncel fiyatlandırma bilgileri
packagesnumberKullanılabilir paket ID'leri
packageGroupsarrayPaket grubu detayları
dlcnumberİlgili DLC uygulama ID'leri
contentDescriptorsobjectİçerik tanımlayıcı bilgileri
controllerSupportstring|nullController destek seviyesi
supportedLanguagesstring|nullDesteklenen diller HTML string'i
ratingsobject|nullBölgesel yaş sınırlamaları

İç içe nesneler

screenshots

AlanTipAçıklama
idnumberEkran görüntüsü ID'si
pathThumbnailstringKüçük resim URL'si
pathFullstringTam çözünürlük URL'si

movies

AlanTipAçıklama
idnumberVideo ID'si
namestringVideo/fragman adı
thumbnailstringKüçük resim URL'si
dashAv1stringDASH AV1 stream URL'si
dashH264stringDASH H.264 stream URL'si
hlsH264stringHLS H.264 stream URL'si
highlightbooleanBunun öne çıkarılmış bir fragman olup olmadığı

categories / genres

AlanTipAçıklama
idnumber/stringKategori veya tür ID'si
descriptionstringKategori veya tür adı

platforms

AlanTipAçıklama
windowsbooleanWindows'ta mevcut
macbooleanMac'te mevcut
linuxbooleanLinux'ta mevcut

metacritic

AlanTipAçıklama
scorenumber|nullMetacritic puanı
urlstring|nullMetacritic sayfa URL'si

releaseDate

AlanTipAçıklama
comingSoonbooleanOyunun henüz çıkıp çıkmadığı
datestring|nullÇıkış tarihi string'i

priceOverview

AlanTipAçıklama
currencystring|nullPara birimi kodu (örn. "USD")
initialnumber|nullSent cinsinden başlangıç fiyatı
finalnumber|nullSent cinsinden son fiyat (indirim sonrası)
discountPercentnumberİndirim yüzdesi (yoksa 0)
initialFormattedstring|nullFormatlanmış başlangıç fiyatı
finalFormattedstring|nullFormatlanmış son fiyat

pcRequirements / macRequirements / linuxRequirements

AlanTipAçıklama
minimumstring|nullMinimum gereksinimler HTML'i
recommendedstring|nullÖnerilen gereksinimler HTML'i

Yanıt örneği

response.json
{
  "success": true,
  "response": {
    "result": {
      "_id": "6789abcdef012345",
      "appId": 730,
      "name": "Counter-Strike 2",
      "type": "game",
      "requiredAge": 0,
      "isFree": true,
      "shortDescription": "Counter-Strike 2 expands upon the team-based action gameplay...",
      "developers": ["Valve"],
      "publishers": ["Valve"],
      "headerImage": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/730/header.jpg",
      "platforms": {
        "windows": true,
        "mac": false,
        "linux": true
      },
      "genres": [
        { "id": "1", "description": "Action" },
        { "id": "37", "description": "Free to Play" }
      ],
      "releaseDate": {
        "comingSoon": false,
        "date": "21 Aug, 2012"
      },
      "priceOverview": {
        "currency": "USD",
        "initial": 0,
        "final": 0,
        "discountPercent": 0,
        "initialFormatted": "",
        "finalFormatted": "Free to Play"
      }
    }
  }
}