Steam
Inventar
Rufe das Steam-Inventar eines Benutzers für eine bestimmte App und einen bestimmten Kontext ab. Die Antwort enthält Assets zusammen mit den Beschreibungen, die die visuellen und marktbezogenen Metadaten jedes Assets auflösen.
Endpunkt
Dieser Endpunkt gibt das Steam-Inventar eines Benutzers für eine bestimmte App und einen bestimmten Kontext zurück. Die Antwort spiegelt die Struktur von Steam selbst wider: ein assets-Array, das die besessenen Gegenstände auflistet, und ein descriptions-Array, das die visuellen und marktbezogenen Metadaten jedes Assets über classid + instanceid auflöst.
GET /v2/steam/users/{steamid}/inventory/{appId}/{contextId}
Erforderliche Parameter
steamid
string
Die Steam ID des Benutzers, dessen Inventar du abrufen möchtest. Akzeptiert verschiedene Steam ID Formate.
appId
number
Die Steam Application-ID des Spiels, dessen Inventar du abrufen möchtest (z. B.
730 für Counter-Strike 2).contextId
number
Die Kontext-ID innerhalb des App-Inventars. Für die meisten Spiele ist die Kontext-ID
2.Authentifizierung
Übergib deinen API-Schlüssel als x-api-key Request-Header.
x-api-key: YourSecretAPIKey
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
assets | array | Die Gegenstände, die der Benutzer besitzt. Jedes Asset verweist über classid + instanceid auf eine Beschreibung. |
descriptions | array | Metadaten, die jede eindeutige Gegenstandsklasse/-instanz beschreiben, auf die in assets verwiesen wird. Mehrere Assets teilen sich typischerweise eine einzige Beschreibung. |
Asset-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
appid | number | Application-ID, zu der das Asset gehört. |
contextid | string | Kontext-ID, in der sich das Asset befindet. |
assetid | string | Eindeutige ID dieses spezifischen Assets im Inventar des Benutzers. |
classid | string | Class-ID, die zum Nachschlagen der Beschreibung des Assets verwendet wird. |
instanceid | string | Instance-ID, die (zusammen mit classid) zum Nachschlagen der Beschreibung des Assets verwendet wird. |
amount | string | Menge dieses Assets. Fast immer "1", außer bei stapelbaren Gegenständen. |
Beschreibungs-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
appid | number | Application-ID. |
classid | string | Class-ID — entspricht assets[].classid. |
instanceid | string | Instance-ID — entspricht assets[].instanceid. |
currency | number | 1, wenn der Gegenstand eine Ingame-Währung ist, andernfalls 0. |
background_color | string | Hex-Farbe, die hinter dem Icon des Gegenstands in der Steam-Benutzeroberfläche verwendet wird. |
icon_url | string | Relativer Pfad zum Gegenstands-Icon auf dem Steam-CDN. |
icon_url_large | string | Relativer Pfad zum großen Gegenstands-Icon auf dem Steam-CDN (nicht immer vorhanden). |
descriptions | array | Rich-Text-Beschreibungszeilen (Waffenbeschreibung, Inhalt von Kisten, Attribute usw.). |
tradable | number | 1, wenn der Gegenstand getauscht werden kann, andernfalls 0. |
marketable | number | 1, wenn der Gegenstand auf dem Steam Community Market verkauft werden kann, andernfalls 0. |
commodity | number | 1, wenn der Gegenstand eine Commodity ist (austauschbar), andernfalls 0. |
market_tradable_restriction | number | Verbleibende Tage, bis der Gegenstand handelbar wird. |
market_marketable_restriction | number | Verbleibende Tage, bis der Gegenstand marktfähig wird. |
name | string | Anzeigename des Gegenstands. |
name_color | string | Hex-Farbe, die für den Namen des Gegenstands in der Steam-Benutzeroberfläche verwendet wird (spiegelt die Seltenheit wider). |
type | string | Typklassifizierung des Gegenstands (z. B. "Base Grade Container", "Mil-Spec Grade SMG"). |
market_name | string | Anzeigename auf dem Markt. |
market_hash_name | string | URL-sicherer Marktname, der zum Abfragen von Markt-Endpunkten verwendet wird. |
actions | array | Ingame-Aktionen wie Inspektionslinks. Nicht immer vorhanden. |
market_actions | array | Marktbezogene Aktionen wie Inspektionslinks von der Marktseite. Nicht immer vorhanden. |
tags | array | Klassifizierungs-Tags (Typ, Waffe, Seltenheit, Abnutzung, Kollektion usw.). |
sealed | number | 1, wenn der Container versiegelt ist, andernfalls 0. |
sealed_type | number | Interner Typ des versiegelten Containers. |
market_bucket_group_name | string | Gruppierungsname des Markt-Buckets (wird von Steam verwendet, um Varianten zu gruppieren). |
market_bucket_group_id | string | Gruppierungs-ID des Markt-Buckets. |
Die Icon-URLs sind relativ. Um sie darzustellen, stelle die Steam-CDN-Basis voran:
https://community.cloudflare.steamstatic.com/economy/image/{icon_url}
Antwortbeispiel
Der Kürze halber sind die assets- und descriptions-Arrays gekürzt — eine reale Antwort enthält ein Asset pro Gegenstand im Inventar und eine Beschreibung pro eindeutigem classid + instanceid Paar.
response.json
{
"success": true,
"result": {
"assets": [
{
"appid": 730,
"contextid": "2",
"assetid": "50813022021",
"classid": "5710094579",
"instanceid": "8336926543",
"amount": "1"
}
],
"descriptions": [
{
"appid": 730,
"classid": "5710094579",
"instanceid": "8336926543",
"currency": 0,
"background_color": "393b3e",
"icon_url": "i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGJKz2lu_XsnXwtmkJjSU91dh8bj35VTqVBP4io_frnEVvqf_a6VoIfGSXz7Hlbwg57QwSS_mxhl15jiGyN37c3_GZw91W8BwRflK7EfKsa2sfw",
"tradable": 1,
"name": "Kilowatt Case",
"name_color": "b0c3d9",
"type": "Base Grade Container",
"market_name": "Kilowatt Case",
"market_hash_name": "Kilowatt Case",
"commodity": 1,
"market_tradable_restriction": 7,
"market_marketable_restriction": 7,
"marketable": 1,
"tags": [
{ "category": "Type", "internal_name": "CSGO_Type_WeaponCase", "localized_category_name": "Type", "localized_tag_name": "Container" },
{ "category": "Rarity", "internal_name": "Rarity_Common", "localized_category_name": "Quality", "localized_tag_name": "Base Grade", "color": "b0c3d9" }
],
"sealed": 0,
"sealed_type": 0,
"market_bucket_group_name": "Kilowatt Case",
"market_bucket_group_id": "G18A8263004"
}
]
}
}