Получение инвентаря пользователя

Главное

Основная информация Генерация подписи

Депозиты

Начало работы Создание депозита Создание депозита без переадресации (iframe) Уведомление о депозите (webhook) Проверка статуса депозита Получение списка депозитов Депозиты без 8 дневного ожидания (Steam Trade Protection) Одобрение депозита с 8 дневным холдом Недошедшие уведомления о платежах

Депозиты без SkinsBack UI

Создание депозита без SkinsBack UI (API) Получить инвентарь пользователя

Вывод скинов

Прайс-лист (наличие скинов) Поиск скинов Купить скин Массовая покупка скинов Статус покупки скина История покупок скинов

Другое

Баланс проекта История выводов с баланса и депозитов Валюты и курсы Статус сервера Real-time обновления: WebSockets Real-time обновления: WebHooks

Получение инвентаря пользователя

Данный метод позволяет получить инвентарь пользователя Steam для дальнейшего создания депозита через API.

Синим выделены обязательные параметры.

Отправьте POST запрос на API Endpoint со следующими параметрами:

method

string

user_inventory

game

string

'cs2', 'dota2', 'rust'

steam_id

string

Steam ID пользователя

trade_token

string

'token' из Trade URL пользователя (8 символов)

currency

string

Валюта (опционально)

custom_multiplier

double

Кастомный множитель цены (переопределяет значение из настроек проекта). Мин. значение: 0.5, макс.: 2

custom_currency

string

Кастомная валюта (обязательно с custom_currency_rate). Вы можете передать название своей валюты и указать ее курс. Цены на скины будут отображаться в этой валюте. Максимум 4 символа.

custom_currency_rate

double

Курс кастомной валюты (обязательно с custom_currency). Мин. значение: 0,1

Ответ от сервера:

В случае успеха, в ответе от сервера будет объект JSON, со следующим содержанием:

items

array

Массив из элементов, описанных ниже

currency_local

string

Переданная валюта для цен на скины (price_local и multiplied_price_local)

Объект 'items'

item.asset_id

string

Asset ID скина из инвентаря Steam. Передается в API метод создания депозита

item.tradable

bool

Доступен ли скин к обмену в Steam

item.app_id

int

App ID игры в Steam. Может использоваться для формирования ссылки на картинку скина

item.icon_url

string

Значение из инвентаря Steam, используется для формирования ссылки на картинку скина (https://steamcommunity-a.akamaihd.net/economy/image/{icon_url}/200fx200f)

item.class_id

string

Значение из инвентаря Steam. Может использоваться для формирования ссылки на картинку скина

name

string

Название скина

price

float

Цена в валюте USD, которую вы получите на баланс проекта

stickers

array

Стикеры у скина (только для CS2)

disabled

bool

Если значение 'true', то значит мы не можем принять данный скин и его Asset ID не стоит передавать при создании депозита

price_local

float

Цена в валюте 'currency'

multiplied_price_local

float

Цена скина в валюте 'currency' с множителем из настроек проекта

Пример успешного ответа:

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

Список возможных ошибок:

invalid_game

Указана неверная игра

invalid_steam_id

Неверный steam_id. Пример Steam ID: 76561198827262007

invalid_trade_token

Неверный trade_token. Запросите новый Trade URL у пользователя

invalid_currency

Указана неверная валюта

user_not_tradable

Пользователь имеет ограничения в системе обмена

user_inventory_is_hidden

Инвентарь пользователя скрыт. Попросите пользователя его открыть

user_inventory_is_unavailable

Инвентарь пользователя недоступен. Попробуйте еще раз

invalid_custom_currency

Указана неверная произвольная валюта

invalid_custom_currency_rate

Указан неверный курс произвольной валюты

invalid_custom_multiplier

Указан неверный опциональный множитель. Мин. значение: 0.5, макс: 2.

стандартные ошибки:

-1

please_use_post_method

Необходимо использовать POST метод

-2

invalid_shopid

ID проекта не найден в системе

-3

invalid_signature

Неверно сформирована подпись

-4

shop_not_active

Проект неактивен

-5

invalid_method

Неверный API метод

-7

request_limit_reached

Превышен лимит запросов (500/в минуту)

-8

invalid_ip_address

Укажите IP адрес в настройках проекта

-9

under_maintenance

Сайт на обслуживании

-10

invalid_client_secret

Неверный передан заголовок X-CLIENT-SECRET

Пример ответа с ошибкой:

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