Get a user's inventory

Chung

Thông tin chính Tạo chữ ký

Tiền gửi

Bắt đầu Tạo khoản tiền gửi Tạo khoản tiền gửi mà không chuyển hướng (iframe) Thông báo về khoản tiền gửi (webhook) Kiểm tra trạng thái khoản tiền gửi Lấy danh sách khoản tiền gửi Tiền gửi không cần chờ 8 ngày (Bảo vệ giao dịch Steam) Phê duyệt tiền gửi với thời gian giữ 8 ngày Nhận thông báo webhook không thành công

Tiền gửi không Có Giao diện Người Dùng SkinsBack

Create a deposit without SkinsBack UI (API) Nhận hàng tồn kho của người dùng

Rút skin

Bảng giá (sẵn có skin) Tìm kiếm skin Mua skin Mua skin số lượng lớn Trạng thái mua skin Lịch sử mua skin

Khác

Số dư dự án Lịch sử rút tiền từ số dư và khoản tiền gửi Đồng tiền và tỷ giá Trạng thái máy chủ Sự kiện thời gian thực: websockets Sự kiện thời gian thực: webhooks

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.

Các tham số bắt buộc được đánh dấu bằng màu xanh.

Gửi yêu cầu POST tới Điểm cuối API với các tham số sau:

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

Hệ số giá tùy chỉnh (ghi đè giá trị từ cài đặt dự án). Giá trị tối thiểu: 0.5, tối đa: 2

custom_currency

string

Tiền tệ tùy chỉnh (bắt buộc với custom_currency_rate). Bạn có thể truyền tên của một loại tiền tệ tùy chỉnh và chỉ định tỷ giá của nó. Giá giao diện sẽ được hiển thị bằng loại tiền tệ này. Tối đa 4 ký tự.

custom_currency_rate

double

Tỷ giá của một loại tiền tệ tùy ý (bắt buộc với custom_currency). Giá trị tối thiểu: 0,1

Phản hồi từ máy chủ:

Nếu thành công, phản hồi từ máy chủ sẽ là một đối tượng JSON với nội dung sau:

items

array

Mảng các phần tử được mô tả dưới đây

currency_local

string

Passed currency for skin prices (price_local and multiplied_price_local)

Đối tượng '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

Ví dụ phản hồi thành công:

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

Danh sách các lỗi có thể xảy ra:

invalid_game

Trò chơi không hợp lệ đã chỉ định

invalid_steam_id

steam_id không hợp lệ. Ví dụ về ID Steam: 76561198827262007

invalid_trade_token

Trade_token không hợp lệ. Yêu cầu URL giao dịch mới từ người dùng

invalid_currency

Tiền tệ không hợp lệ được chỉ định

user_not_tradable

Người dùng có các hạn chế trong hệ thống giao dịch

user_inventory_is_hidden

Hàng tồn kho của người dùng bị ẩn. Yêu cầu người dùng mở nó

user_inventory_is_unavailable

Hàng tồn kho của người dùng không khả dụng. Thử lại

invalid_custom_currency

Tiền tệ tùy chỉnh không hợp lệ đã chỉ định

invalid_custom_currency_rate

Tỷ giá tiền tệ tùy chỉnh không hợp lệ đã chỉ định

invalid_custom_multiplier

Hệ số nhân tùy chỉnh không hợp lệ đã chỉ định. Giá trị tối thiểu: 0.5, tối đa: 2

các lỗi tiêu chuẩn:

-1

please_use_post_method

Cần sử dụng phương thức POST

-2

invalid_shopid

ID dự án không được tìm thấy trong hệ thống

-3

invalid_signature

Chữ ký được tạo không hợp lệ

-4

shop_not_active

Dự án không hoạt động

-5

invalid_method

Phương thức API không hợp lệ

-7

request_limit_reached

Vượt quá giới hạn yêu cầu (500/1 phút)

-8

invalid_ip_address

Vui lòng cung cấp địa chỉ IP trong cài đặt dự án

-9

under_maintenance

Trang web đang được bảo trì

-10

invalid_client_secret

Tiêu đề X-CLIENT-SECRET không hợp lệ

Ví dụ phản hồi lỗi:

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