Documentation Steamworks
GetContextContents/v0001
Renvoie toutes les ressources et devises dans un contexte particulier pour un utilisateur.

Appelée par : interface d'échange, interface de l'inventaire

Méthode HTTP : GET

Paramètres :

NomTypeRequisDescription
keystringIl s'agit de la « clé du serveur de ressources » que vous avez indiquée dans les paramètres de l'économie Steam de votre application sur le site des partenaires.
appiduint32AppID 32 bits de l'application associée aux ressources.
steamiduint64SteamID 64 bits du compte utilisateur pour lequel les ressources doivent être renvoyées.
contextiduint64ID 64 bits du contexte pour lequel les ressources doivent être renvoyées.

Éléments renvoyés

Les données de sortie de cette méthode doivent être encodées au format JSON.

Réponse :
  • result
    • success : vaut true si la méthode a réussi. Si le serveur de ressources renvoie false, il doit affecter à error une chaine de caractères qui explique pourquoi.
    • error : chaine de caractères décrivant la raison de l'échec de cet appel. Ce message sera enregistré dans le journal d'erreurs, disponible sous le menu Économie de l'onglet Communauté sur le site de Steamworks.
    • assets : tableau des ressources filles du contexte spécifié.
      • id : ID 64 bits de la ressource.
      • class : tableau d'identifiants de classes de ressources définis par le jeu. C'est le jeu qui définit ce que
        sont ces identifiants. Ils doivent simplement fournir suffisamment d'informations pour reproduire les informations de la ressource
        (c'est-à-dire décrire de quel type d'item il s'agit) quand les identifiants de classe sont passés en retour à GetAssetClassInfo/v0001. Chaque identifiant doit contenir les champs suivants :
        • name : nom de cette partie de l'identifiant de la classe.
        • value : valeur de cette partie de l'identifiant de la classe sous forme de chaine de caractères.
        • instance : si la valeur est true, l'identifiant de classe est considéré comme une « instance données », ce qui signifie
          qu'il n'est généralement pas transféré avec l'item lors d'un échange, et qu'il n'a pas d'incidence sur la valeur d'échange de l'item
          (valeur par défaut : false).
          REMARQUE : une propriété de la classe de ressource qui a finalement un effet sur le paramètre market_hash_name d'un item dans la réponse de GetAssetClassInfo/v0001 ne devrait jamais être considérée comme « instance données ». Le marché de la communauté dépend de propriétés d'instance qui n'ont aucun effet sur le paramètre market_hash_name.
        Pour optimiser la quantité d'informations de description que Steam peut mettre en cache, les identifiants de classe doivent être aussi génériques et réutilisables que possible. Par exemple, évitez d'utiliser une classe où vous avez simplement une propriété avec un nom comme itemid et une valeur qui est l'ID 64 bits de la ressource. Décrivez plutôt le type d'item concerné de telle sorte que vous ayez assez d'informations pour générer la description. Par exemple, une classe de ressource où « type » = « épée » et « rareté » = « standard » vous donne suffisamment d'informations pour générer la description de l'item sans que vous ayez à savoir précisément de quelle instance de l'item il s'agit.
      • amount (facultatif) : nombre d'éléments de la pile pour cette ressource. L'utilisateur pourra échanger au maximum ce nombre d'unités pris dans cette pile (valeur par défaut : 1).
    • currency (facultatif) : tableau des types de devises que ce contexte contient. Si un utilisateur n'a aucune devise particulière, cette valeur doit être incluse ici uniquement si elle est visible dans l'interface en jeu. L'affichage d'une devise est très semblable à celui d'une ressource ; c'est pourquoi les champs indiqués ci-dessus pour les ressources s'appliquent également aux devises, sauf les champs class et id. En plus des autres champs des ressources, les deux champs suivants s'utilisent pour les devises :
      • id : ID 32 bits non signé assigné à ce type de devise. Cet ID doit être unique dans l'ensemble du jeu.
      • amount : entier sur 64 bits représentant le montant de ce type de devise que l'utilisateur possède.

Exemple de sortie

{ "result": { "assets": [ { "id": 131363189, "class": [ { "name": "def_index", "value": "128" }, { "name": "quality", "value": "3" } ] }, { "id": 131412933, "class": [ { "name": "def_index", "value": "155" }, { "name": "quality", "value": "3" } ] }, { "id": 556669733, "class": [ { "name": "def_index", "value": "583" }, { "name": "flags", "value": "1" }, { "name": "origin", "value": "1", "instance": true } ] }, ] , "success": true } }