Ajuda Contatos
pt-ptPT-PT
ENEN DEDE ESES PLPL PT-BRPT-BR PT-PTPT-PT RURU TRTR VIVI ZH-CNZH-CN

API

Geral
Informações Principais Geração de Assinatura
Depósitos
Começando Criação de Depósito Criação de Depósito sem Redirecionamento (iframe) Notificação de Depósito (webhook) Verificação do Status do Depósito Obtenção da Lista de Depósitos Depósitos sem período de espera de 8 dias (Steam Trade Protection) Aprovação de depósito com retenção de 8 dias Receba notificações de webhook com falha
Depósitos sem SkinsBack UI
Create a deposit without SkinsBack UI (API) Obter o inventário do utilizador
Retirada de skins
Lista de preços (disponibilidade de skins) Pesquisar skins Comprar skin Comprar skins em grandes quantidades Status da compra de skin Histórico de compras de skins
Outro
Saldo do Projeto Histórico de Retiradas do Saldo e Depósitos Moedas e taxas Status do servidor Eventos em tempo real: websockets Eventos em tempo real: 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.

Os parâmetros obrigatórios estão destacados em azul.

Envie uma solicitação POST para o Endpoint da API com os seguintes parâmetros:

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
Multiplicador de preços personalizado (substitui o valor das definições do projeto). Valor mínimo: 0.5, máximo: 2
custom_currency
string
Moeda personalizada (obrigatória com custom_currency_rate). Pode passar o nome de uma moeda personalizada e especificar a sua taxa. Os preços das skins serão apresentados nesta moeda. Máximo de 4 caracteres.
custom_currency_rate
double
A taxa de uma moeda arbitrária (exigida com custom_currency). Valor mínimo: 0,1

Resposta do servidor:

Em caso de sucesso, a resposta do servidor será um objeto JSON com o seguinte conteúdo:

items
array
Matriz de elementos, conforme descrito abaixo
currency_local
string
Passed currency for skin prices (price_local and multiplied_price_local)

Objeto '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

Exemplo de resposta bem-sucedida:

{
    "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 de possíveis erros:

1
invalid_game
Jogo inválido especificado
2
invalid_steam_id
steam_id inválido. Exemplo de ID Steam: 76561198827262007
3
invalid_trade_token
trade_token inválido. Pedir um novo URL de troca ao utilizador
4
invalid_currency
Moeda inválida especificada
5
user_not_tradable
O utilizador tem restrições no sistema de trocas
6
user_inventory_is_hidden
O inventário do utilizador está oculto. Pedir ao utilizador para o abrir
7
user_inventory_is_unavailable
O inventário do utilizador não está disponível. Tente novamente
8
invalid_custom_currency
Moeda personalizada inválida especificada
9
invalid_custom_currency_rate
Taxa de moeda personalizada inválida especificada
10
invalid_custom_multiplier
Multiplicador personalizado inválido especificado. Valor mínimo: 0.5, máximo: 2
erros padrão:
-1
please_use_post_method
É necessário usar o método POST
-2
invalid_shopid
ID do projeto não encontrado no sistema
-3
invalid_signature
Assinatura inválida
-4
shop_not_active
Projeto inativo
-5
invalid_method
Método de API inválido
-7
request_limit_reached
Limite de solicitações excedido (500 por minuto)
-8
invalid_ip_address
Especifique o endereço IP nas configurações do projeto
-9
under_maintenance
Site em manutenção
-10
invalid_client_secret
Cabeçalho X-CLIENT-SECRET inválido

Exemplo de resposta com erro:

{
    "status": "error",
    "error_code": 4,
    "error_message": "invalid_currency"
}
© 2025 SkinsBack. All right reserved.
Ajuda Contatos Acordo de Serviço