Aplikacje

Szczegóły aplikacji

Pobierz szczegółowe informacje o konkretnej aplikacji Steam, w tym opisy, obrazy, ceny i metadane.

Endpoint

Ten endpoint zwraca szczegółowe informacje o konkretnej aplikacji Steam, w tym opisy, obrazy, ceny, wymagania systemowe i inne metadane.

GET   /v2/steam/apps/{appId}

Wymagane parametry

appId
number
Steam application ID.

Uwierzytelnianie

Dołącz swój klucz API jako header x-api-key.

x-api-key: YourSecretAPIKey

Pola odpowiedzi

PoleTypOpis
resultobject|nullObiekt szczegółów aplikacji lub null, jeśli nie znaleziono

Obiekt szczegółów aplikacji

PoleTypOpis
_idstringID dokumentu
appIdnumberSteam application ID
steamAppIdstring|nullReferencja do dokumentu SteamApp
namestring|nullNazwa aplikacji
typestring|nullTyp aplikacji (np. "game", "dlc")
requiredAgenumberMinimalny wymagany wiek (0, jeśli brak)
isFreebooleanCzy aplikacja jest darmowa
shortDescriptionstring|nullKrótki opis
detailedDescriptionstring|nullPełny opis HTML
aboutTheGamestring|nullZawartość HTML sekcji "O grze"
developersstringLista nazw deweloperów
publishersstringLista nazw wydawców
headerImagestring|nullURL obrazu nagłówkowego
capsuleImagestring|nullURL obrazu capsule
capsuleImageV5string|nullURL obrazu capsule v5
backgroundstring|nullURL obrazu tła
backgroundRawstring|nullURL surowego obrazu tła
screenshotsarrayTablica obiektów zrzutów ekranu
moviesarrayTablica obiektów filmów/zwiastunów
categoriesarrayTablica obiektów kategorii
genresarrayTablica obiektów gatunków
platformsobjectDostępność na platformach
metacriticobjectDane oceny Metacritic
recommendationsobjectLiczba rekomendacji
achievementsobjectDane osiągnięć
releaseDateobjectInformacje o dacie wydania
supportInfoobjectDane kontaktowe wsparcia
websitestring|nullURL oficjalnej strony
legalNoticestring|nullTekst noty prawnej
reviewsstring|nullCytaty z recenzji
pcRequirementsobjectWymagania systemowe PC
macRequirementsobjectWymagania systemowe Mac
linuxRequirementsobjectWymagania systemowe Linux
priceOverviewobjectAktualne informacje cenowe
packagesnumberDostępne ID pakietów
packageGroupsarraySzczegóły grup pakietów
dlcnumberPowiązane ID aplikacji DLC
contentDescriptorsobjectInformacje o deskryptorach treści
controllerSupportstring|nullPoziom obsługi kontrolera
supportedLanguagesstring|nullHTML string obsługiwanych języków
ratingsobject|nullRegionalne kategorie wiekowe

Obiekty zagnieżdżone

screenshots

PoleTypOpis
idnumberID zrzutu ekranu
pathThumbnailstringURL miniatury
pathFullstringURL pełnej rozdzielczości

movies

PoleTypOpis
idnumberID filmu
namestringNazwa filmu/zwiastuna
thumbnailstringURL miniatury
dashAv1stringURL streamu DASH AV1
dashH264stringURL streamu DASH H.264
hlsH264stringURL streamu HLS H.264
highlightbooleanCzy jest to wyróżniony zwiastun

categories / genres

PoleTypOpis
idnumber/stringID kategorii lub gatunku
descriptionstringNazwa kategorii lub gatunku

platforms

PoleTypOpis
windowsbooleanDostępne na Windows
macbooleanDostępne na Mac
linuxbooleanDostępne na Linux

metacritic

PoleTypOpis
scorenumber|nullOcena Metacritic
urlstring|nullURL strony Metacritic

releaseDate

PoleTypOpis
comingSoonbooleanCzy gra jeszcze nie została wydana
datestring|nullData wydania jako string

priceOverview

PoleTypOpis
currencystring|nullKod waluty (np. "USD")
initialnumber|nullCena początkowa w centach
finalnumber|nullCena końcowa w centach (po rabacie)
discountPercentnumberProcent rabatu (0, jeśli brak)
initialFormattedstring|nullSformatowana cena początkowa
finalFormattedstring|nullSformatowana cena końcowa

pcRequirements / macRequirements / linuxRequirements

PoleTypOpis
minimumstring|nullWymagania minimalne w HTML
recommendedstring|nullWymagania rekomendowane w HTML

Przykład odpowiedzi

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"
      }
    }
  }
}