Dokumentacja Steamworks
GetContextContents/v0001
Zwraca wszystkie zasoby i walutę w określonym kontekście dla użytkownika.

Wywoływana przez: interfejs użytkownika dla wymiany, interfejs użytkownika dla ekwipunku

Metoda HTTP: GET

Parametry:

NazwaTypWymagane?Opis
keystringJest to klucz serwera zasobów, który podano w ustawieniach Ekonomii Steam twojej aplikacji na stronie partnerskiej.
appiduint3232-bitowe ID aplikacji powiązanej z zasobami.
steamiduint6464-bitowe ID Steam użytkownika, dla którego zwracane są zasoby.
contextiduint6464-bitowe ID kontekstu, dla którego zwracane są zasoby.

Wartości zwrotne

Wynik tej metody powinien być zakodowany w formacie JSON.

Odpowiedź:
  • result
    • success – wartość „true”, jeśli metoda zakończy się powodzeniem. Jeśli serwer zasobów zwraca wartość „false”, to powinien ustawić error jako string z wyjaśnieniem dlaczego.
    • error – string wyjaśniający, dlaczego to wywołanie nie powiodło się. Ta wiadomość zostanie zapisana w dzienniku błędów, który jest dostępny w zakładce „Ekonomia” na stronie Steamworks.
    • assets – tablica zasobów, które są elementami podrzędnymi określonego kontekstu.
      • id – 64-bitowe ID zasobu.
      • class – tablica identyfikatorów klas zasobów zdefiniowanych przez grę. To na grze ciąży odpowiedzialność zdefiniowania
        tych identyfikatorów. Muszą one tylko dostarczać wystarczającą ilość informacji do odtworzenia informacji na temat zasobu
        (opisać, jaki to rodzaj przedmiotu), gdy te identyfikatory klas są przekazywane z powrotem do GetAssetClassInfo/v0001. Każdy identyfikator powinien zawierać następujące pola:
        • name – nazwa tej części identyfikatora klasy.
        • value – wartość tej części identyfikatora klasy jako string.
        • instance – jeśli wartość to „true”, to identyfikator klasy jest uznawany za „dane instancji”, co oznacza,
          że zwykle nie jest przekazywany z przedmiotu podczas wymiany, więc nie jest brany pod uwagę przy ustalaniu wartości przedmiotu
          (domyślnie: false).
          UWAGA: właściwość klasy zasobu, która ostatecznie ma wpływ na market_hash_name przedmiotu w odpowiedzi GetAssetClassInfo/v0001, nigdy nie powinna być uznawana za dane instancji. Rynek Społeczności opiera się na fakcie, iż właściwości danych instancji nie mają żadnego wpływu na market_hash_name.
        Aby zmaksymalizować ilość informacji o opisach, które Steam może przechowywać, identyfikatory klas muszą być jak najbardziej ogólne i zdolne do ponownego użytku jak to możliwe. Przykładowo unikaj klasy, w której masz tylko jedną właściwość z nazwą taką jak „itemid” oraz wartość w postaci 64-bitowego ID zasobu. Zamiast tego opisz rodzaj tego przedmiotu w sposób, który daje ci wystarczającą ilość informacji do stworzenia opisu. Na przykład klasa zasobu z parametrami „type” = „sword” i „rarity” = „common” dostarcza wystarczającą ilość informacji, aby opisać przedmiot, ale bez dokładnej wiedzy na temat tego, która dokładnie to instancja przedmiotu.
      • amount (opcjonalnie) – rozmiar stosu dla tego zasobu. Użytkownik będzie w stanie wymienić maksymalnie taką liczbę jednostek z tego stosu (domyślnie: 1).
    • currency (opcjonalnie) – tablica typów walut, jakie zawiera ten kontekst. Jeśli użytkownik nie posiada żadnego konkretnego rodzaju waluty, to powinna być tutaj zawarta tylko, gdyby była widoczna na interfejsie użytkownika w grze. Wyświetlanie waluty jest bardzo podobne do wyświetlania zasobu, więc powyższe pola zasobów również dotyczą walut z wyjątkiem pól class i id. Poza innymi polami zasobów, dla walut używa się również poniższych dwóch pól:
      • id – 32-bitowe ID bez znaku przypisane do tego rodzaju waluty. To ID musi być unikalne globalnie w obrębie gry.
      • amount – 64-bitowa liczba całkowita reprezentująca ilość tego rodzaju waluty, jaką posiada użytkownik.

Przykładowe wyjście

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