Get a user's inventory

Główny

Podstawowe informacje Generowanie podpisu

Depozyty

Pierwsze kroki Tworzenie depozytu Tworzenie depozytu bez przekierowania (iframe) Powiadomienie o wpłacie (webhook) Sprawdzanie statusu depozytu Uzyskanie listy depozytów Depozyty bez 8-dniowego oczekiwania (Steam Trade Protection) Zatwierdzenie depozytu z 8-dniowym holdem Otrzymuj powiadomienia o nieudanych webhookach

Depozyty bez interfejsu użytkownika SkinsBack

Create a deposit without SkinsBack UI (API) Pobierz ekwipunek użytkownika

Wyjście skinów

Cennik (dostępność skinów) Wyszukaj skinów Kup skiny Kupuj skórki hurtowo Stan zakupu skina Historia zakupów skinów

Inny

Bilans projektu Historia wypłat z salda i depozytów Waluty i kursy Status serwera Zdarzenia w czasie rzeczywistym: websockets Zdarzenia w czasie rzeczywistym: webhooki

Get a user's inventory

This method allows you to obtain the user's Steam inventory for further creation of a deposit via the API.

Niebieski podświetla wymagane parametry.

Wyślij żądanie POST do API Endpoint z następującymi parametrami:

method

string

user_inventory

game

string

'cs2', 'dota2', 'rust'

steam_id

string

User Steam ID

trade_token

string

'token' value from the user's Trade URL

currency

string

Currency (optional)

custom_multiplier

double

Mnożnik ceny niestandardowej (zastępuje wartość z ustawień projektu). Wartość minimalna: 0.5, maks.: 2

custom_currency

string

Waluta niestandardowa (wymagana z custom_currency_rate). Możesz przekazać nazwę waluty niestandardowej i określić jej kurs. Ceny skórek będą wyświetlane w tej walucie. Maksymalnie 4 znaki.

custom_currency_rate

double

Kurs dowolnej waluty (wymagany z custom_currency). Wartość minimalna: 0,1

Odpowiedź z serwera:

Jeśli się powiedzie, odpowiedź z serwera będzie zawierać obiekt JSON o następującej treści:

items

array

Tablica elementów opisanych poniżej

currency_local

string

Passed currency for skin prices (price_local and multiplied_price_local)

obiekt 'items'

item.asset_id

string

Asset ID of the skin from the Steam inventory. The deposit creation method is passed to the API

item.tradable

bool

Is the skin available for trade on Steam?

item.app_id

int

App ID of the game on Steam. Can be used to form a link to a skin image

item.icon_url

string

Value from the Steam inventory, used to form a link to the skin image (https://steamcommunity-a.akamaihd.net/economy/image/{icon_url}/200fx200f)

item.class_id

string

Value from Steam inventory. Can be used to form a link to a skin image

name

string

Skin name

price

float

The price in USD currency that you will receive on the project balance

stickers

array

Skin stickers (CS2 only)

disabled

bool

If the value is 'true', then we cannot accept this skin and its Asset ID should not be transferred when creating a deposit

price_local

float

Price in currency 'currency'

multiplied_price_local

float

Skin price in currency 'currency' with a multiplier from the project settings

Przykład udanej odpowiedzi:

{
    "status": "success",
    "data": {
        "items": [
            {
                "item": {
                    "asset_id": "4284666526576951869",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTEfCk4nReh8DEiv5dbOK0-r7A-Rvoc_CHvvg",
                    "class_id": "1239822445"
                },
                "name": "Black Bandana",
                "price": 0.07,
                "stickers": [],
                "disabled": false,
                "price_local": 6.49,
                "multiplied_price_local": 12.98
            },
            {
                "item": {
                    "asset_id": "4284666526576951710",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GPMfCk4nReh8DEiv5daMK84rrwwQ_m6f-_bfrM",
                    "class_id": "1150042773"
                },
                "name": "Forest Camo Pants",
                "price": 0.06,
                "stickers": [],
                "disabled": true,
                "price_local": 5.56,
                "multiplied_price_local": 11.13
            },
            {
                "item": {
                    "asset_id": "4284666526576951707",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GPGfCk4nReh8DEiv5ddOKo-rrY3Rf642xqEoVY",
                    "class_id": "1132469022"
                },
                "name": "Multicam Jacket",
                "price": 0.06,
                "stickers": [],
                "disabled": true,
                "price_local": 5.56,
                "multiplied_price_local": 11.13
            },
            {
                "item": {
                    "asset_id": "4284666526576951664",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GHEfCk4nReh8DEiv5dYMKA5pLYzRv6605EYJLk",
                    "class_id": "1217055316"
                },
                "name": "Cloth",
                "price": 0.06,
                "stickers": [],
                "disabled": true,
                "price_local": 5.56,
                "multiplied_price_local": 11.13
            },
            {
                "item": {
                    "asset_id": "4477205562413429653",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTGfCk4nReh8DEiv5dYP6A2rbA-Rf25SfAER4E",
                    "class_id": "1239847866"
                },
                "name": "Forest Camo Bandana",
                "price": 0.08,
                "stickers": [],
                "disabled": false,
                "price_local": 7.42,
                "multiplied_price_local": 14.84
            },
            {
                "item": {
                    "asset_id": "7040881650036228451",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GvGfCk4nReh8DEiv5dRPa89rbIzQPHomfYsJw",
                    "class_id": "1367550349"
                },
                "name": "XXL Picture Frame",
                "price": 0.14,
                "stickers": [],
                "disabled": false,
                "price_local": 12.98,
                "multiplied_price_local": 25.97
            },
            {
                "item": {
                    "asset_id": "7040881650018509899",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GfDfCk4nReh8DEiv5dePqo-rbE2QfDetTZYmg",
                    "class_id": "1221869347"
                },
                "name": "Facepunch TShirt",
                "price": 0.07,
                "stickers": [],
                "disabled": false,
                "price_local": 6.49,
                "multiplied_price_local": 12.98
            },
            {
                "item": {
                    "asset_id": "7040881650018503217",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GvHfCk4nReh8DEiv5dYMK48rbA3Qf25xd6nYFI",
                    "class_id": "1367240336"
                },
                "name": "Two Sided Hanging Sign",
                "price": 0.14,
                "stickers": [],
                "disabled": false,
                "price_local": 12.98,
                "multiplied_price_local": 25.97
            },
            {
                "item": {
                    "asset_id": "7040881650018499246",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GvNfCk4nReh8DEiv5dRMao6rrcxRfpxw9ozkg",
                    "class_id": "1368658386"
                },
                "name": "One Sided Town Sign Post",
                "price": 0.14,
                "stickers": [],
                "disabled": false,
                "price_local": 12.98,
                "multiplied_price_local": 25.97
            },
            {
                "item": {
                    "asset_id": "7040881650018499211",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GvEfCk4nReh8DEiv5ddOag8qL02QPu8iE0BWx4",
                    "class_id": "1368124330"
                },
                "name": "Large Banner Hanging",
                "price": 0.14,
                "stickers": [],
                "disabled": false,
                "price_local": 12.98,
                "multiplied_price_local": 25.97
            },
            {
                "item": {
                    "asset_id": "7040881650018498241",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTHfCk4nReh8DEiv5daPK03qrA0Q_64iUe-2eI",
                    "class_id": "1239833770"
                },
                "name": "Snow Camo Bandana",
                "price": 0.08,
                "stickers": [],
                "disabled": false,
                "price_local": 7.42,
                "multiplied_price_local": 14.84
            },
            {
                "item": {
                    "asset_id": "7040881650018497805",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GbAfCk4nReh8DEiv5dROag6pLw1SPnr505JuQ",
                    "class_id": "1221777137"
                },
                "name": "Rescue Cap",
                "price": 0.06,
                "stickers": [],
                "disabled": true,
                "price_local": 5.56,
                "multiplied_price_local": 11.13
            },
            {
                "item": {
                    "asset_id": "7040881650018497278",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTGfCk4nReh8DEiv5dYP6A2rbA-Rf25SfAER4E",
                    "class_id": "1239847866"
                },
                "name": "Forest Camo Bandana",
                "price": 0.08,
                "stickers": [],
                "disabled": false,
                "price_local": 7.42,
                "multiplied_price_local": 14.84
            },
            {
                "item": {
                    "asset_id": "7040881650018497260",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5WbEfCk4nReh8DEiv5daOa4_rLI_RPi6S8mOXYo",
                    "class_id": "1594188998"
                },
                "name": "Gun Box",
                "price": 0.16,
                "stickers": [],
                "disabled": false,
                "price_local": 14.84,
                "multiplied_price_local": 29.68
            },
            {
                "item": {
                    "asset_id": "4284666526577962863",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTEfCk4nReh8DEiv5dbOK0-r7A-Rvoc_CHvvg",
                    "class_id": "1239822445"
                },
                "name": "Black Bandana",
                "price": 0.07,
                "stickers": [],
                "disabled": false,
                "price_local": 6.49,
                "multiplied_price_local": 12.98
            },
            {
                "item": {
                    "asset_id": "4284666526577962836",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTEfCk4nReh8DEiv5dbOK0-r7A-Rvoc_CHvvg",
                    "class_id": "1239822445"
                },
                "name": "Black Bandana",
                "price": 0.07,
                "stickers": [],
                "disabled": false,
                "price_local": 6.49,
                "multiplied_price_local": 12.98
            },
            {
                "item": {
                    "asset_id": "4284666526577962770",
                    "tradable": 1,
                    "app_id": 252490,
                    "icon_url": "6TMcQ7eX6E0EZl2byXi7vaVKyDk_zQLX05x6eLCFM9neAckxGDf7qU2e2gu64OnAeQ7835Je5GTEfCk4nReh8DEiv5dbOK0-r7A-Rvoc_CHvvg",
                    "class_id": "1239822445"
                },
                "name": "Black Bandana",
                "price": 0.07,
                "stickers": [],
                "disabled": false,
                "price_local": 6.49,
                "multiplied_price_local": 12.98
            }
        ],
        "currency_local": "rub"
    }
}

Lista możliwych błędów:

invalid_game

Określono nieprawidłową grę

invalid_steam_id

Nieprawidłowy steam_id. Przykład Steam ID: 76561198827262007

invalid_trade_token

Nieprawidłowy trade_token. Zażądaj nowego adresu URL transakcji od użytkownika

invalid_currency

Podano nieprawidłową walutę

user_not_tradable

Użytkownik ma ograniczenia w systemie handlu

user_inventory_is_hidden

Ekwipunek użytkownika jest ukryty. Poproś użytkownika o jego otwarcie

user_inventory_is_unavailable

Ekwipunek użytkownika jest niedostępny. Spróbuj ponownie

invalid_custom_currency

Nieprawidłowa waluta niestandardowa

invalid_custom_currency_rate

Określono nieprawidłowy niestandardowy kurs waluty

invalid_custom_multiplier

Określono nieprawidłowy mnożnik niestandardowy

standardowe błędy:

-1

please_use_post_method

Musisz użyć metody POST

-2

invalid_shopid

W systemie nie znaleziono identyfikatora projektu

-3

invalid_signature

Błędnie złożony podpis

-4

shop_not_active

Projekt jest nieaktywny

-5

invalid_method

Nieprawidłowa metoda API

-7

request_limit_reached

Przekroczono limit żądań (500/minutę)

-8

invalid_ip_address

Określ adres IP w ustawieniach projektu

-9

under_maintenance

Witryna w trakcie prac konserwacyjnych

-10

invalid_client_secret

Nieprawidłowy nagłówek X-CLIENT-SECRET

Przykład odpowiedzi z błędem:

{
    "status": "error",
    "error_code": 4,
    "error_message": "invalid_currency"
}