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

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

Status da compra da pele

Informações sobre a pele adquirida. Este método permite obter o ID da oferta de troca Steam, bem como verificar se o item foi aceito pelo usuário (ou se foi recusado).

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
market_getinfo
buy_id
int
'buy_id' da compra (do método market_buy)
— OU —
custom_ids
array
array de 'custom_id' do seu sistema. Se esse parâmetro for fornecido, a resposta será um array de items contendo informações sobre cada compra
— OU —
buy_ids
array
array de 'buy_id' das compras. Se esse parâmetro for fornecido, a resposta será um array de items contendo informações sobre cada compra

Resposta do servidor:

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

item
object
Objeto contendo informações sobre a skin comprada
— item.id
int
ID da Skin
— item.name
string
Nome da skin
— item.price
float
Preço da skin em USD
— item.classid
string
ID da Classe da skin
buy_id
int
ID da compra da skin
offer_status
string
Status da compra:
1. 'creating_trade' — troca em andamento
2. 'waiting_accept' — troca aguardando aceitação
3. 'accepted' — troca aceita
4. 'canceled' — troca cancelada pelo usuário
5. 'timeout' — troca não aceita em 10 minutos
6. 'invalid_trade_token' — token de troca inválido
7. 'user_not_tradable' — usuário possui restrições no sistema de troca
8. 'trade_create_error' — erro ao criar troca (tente novamente)
9. 'rollback_user' — skin foi devolvido pelo utilizador (Proteção de Troca da Steam)
10. 'rollback_supplier' — skin foi devolvido pelo fornecedor (Proteção de Troca da Steam)
in_hold
bool
Se a skin está em espera ou não
in_hold_until
string (datetime)
Data até a qual a skin estará em espera (se a skin estiver em espera)
error_reason
string
Motivo (se presente):
1. 'user_cant_trade' - o utilizador tem uma restrição para negociar no Steam
2. 'private_inventory' - o utilizador necessita de abrir o inventário
3. 'user_trade_ban' - o utilizador tem proibição de troca
4. 'user_inventory_is_full' - o inventário do utilizador está cheio
5. 'too_many_failed_attempts' - muitas tentativas de retirada mal sucedidas para o utilizador
6. 'skin_unavailable' - skin indisponível para compra (ou vendida)
steamid
string
Steam ID do usuário
date
int
Data da compra (tempo UNIX)
balance_debited_sum
float
Valor debitado do saldo do projeto (USD)
tradeofferid
string
ID da oferta de troca no Steam (somente se a troca foi criada)
custom_id
string
'custom_id' no seu sistema

Exemplo de resposta bem-sucedida:

{
    "status": "success",
    "item": {
        "id": "1280",
        "name": "Taunt: RazorFlip!",
        "price": "0.16",
        "classid": "1723112726"
    },
    "buy_id": "9",
    "offer_status": "trade_create_error",
    "error_reason": null,
    "steamid": "76561198050648523",
    "date": "1596999226",
    "balance_debited_sum": "11.73"
}

Lista de possíveis erros:

1
missing_one_of_required_params
Parâmetro obrigatório ausente (buy_id, buy_ids ou custom_ids)
2
offer_not_found
Compra de pele não encontrada
-6
market_disabled
Mercado desativado
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
© 2025 SkinsBack. All right reserved.
Ajuda Contatos Acordo de Serviço