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
Histórico de compras de skins
Informações sobre todos os itens adquiridos. Limite de retirada: 1000.
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_history
starting
int
Tempo Unix de início da amostra
ending
int
Tempo Unix de término da amostra
start_from
int
parâmetro start_from na resposta para navegação entre páginas (limite de 1000 resultados)
Resposta do servidor:
Em caso de sucesso, a resposta do servidor será um objeto JSON com o seguinte conteúdo:
total_count
int
Total de resultados (o número de resultados é limitado a 1000)
has_more
bool
Se há mais páginas seguintes para paginação
start_from
int
Usado para navegação entre páginas
items
array
Matriz de elementos, conforme descrito abaixo
Objeto 'items'
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)
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)
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",
"items": [
{
"item": {
"id": "2713",
"name": "AWP | Man-o'-war (Minimal Wear)",
"price": "1325.61",
"classid": "3496732101",
"instanceid": "480085569"
},
"tradeofferid": "4169974564",
"buy_id": "2",
"offer_status": "user_not_tradable",
"error_reason": "private_inventory",
"steamid": "76561198050648523",
"date": "1596623088"
},
{
"item": {
"id": "2713",
"name": "AWP | Man-o'-war (Minimal Wear)",
"price": "1325.61",
"classid": "3496732101",
"instanceid": "480085569"
},
"tradeofferid": "4169977670",
"buy_id": "3",
"offer_status": "canceled",
"error_reason": null,
"steamid": "76561198050648523",
"date": "1596623246"
},
],
"total_count": "2000",
"has_more": true,
"start_from": 999
}
Lista de possíveis erros:
1
missing_starting_or_ending
Falta a data de início ou fim em formato UNIX
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