Compra em massa de skins e envio ao usuário

Principal

Informações Principais Gerando uma Assinatura

Depósitos

Começando Criando um Depósito Criando um Depósito sem Redirecionamento (iframe) Notificação de Depósito (webhook) Verificando o Status do Depósito Obtendo a 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 a interface do usuário do SkinsBack

Create a deposit without SkinsBack UI (API) Obter o inventário do usuário

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 Saques e Depósitos Moedas e taxas Status do servidor Eventos em tempo real: websockets Eventos em tempo real: webhooks

Compra em massa de skins e envio ao usuário

Compra em massa de skins e envio ao usuário.

Parâmetros obrigatórios destacados em azul

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

method

string

market_batch_buy

partner

string

Valor 'partner' da Trade URL do usuário

token

string

Valor 'token' da Trade URL do usuário

items

array

Conjunto de itens para compra de skins

items[][id]

int

ID do skin da lista de preços ou da busca

items[][max_price]

float

Valor máximo do skin para compra (em USD). Usado como limitador de preço

items[][custom_id]

string

ID exclusivo em seu sistema. Usado para evitar compras duplicadas

Resposta do servidor:

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

purchased

array

Matriz contendo uma lista de skins compradas, descrição abaixo

unavailable

array

Matriz contendo uma lista de IDs de skin indisponíveis e motivos:
- insufficient_funds (error_code: 4) — Saldo insuficiente no projeto
- skin_unavailable (error_code: 5) — A pele não está disponível para compra
- skins_not_found_at_specified_price (error_code: 6) — Não há skins com preço <= 'max_price'
- custom_id_already_exists: (error_code: 7) — 'custom_id' já existe em nosso sistema

Matriz de 'purchased'

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, necessário para verificar o status da transferência do item posteriormente

offer_status

string

Status da compra:
1. 'creating_trade' — troca sendo criada
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 tem restrições no sistema de trocas
8. 'trade_create_error' — erro ao criar troca (tente novamente)
9. 'rollback_user' — skin foi devolvido pelo usuário (Proteção de Troca da Steam)
10. 'rollback_supplier' — skin foi devolvido pelo fornecedor (Proteção de Troca da Steam)

Este método pode conter apenas create_trade. Outros status estão em market_getinfo / market_history.

balance_debited_sum

float

Valor debitado do saldo do projeto (USD)

Exemplo de resposta bem-sucedida:

{
   "status":"success",
   "purchased":{
      "62696971":{
         "item":{
            "id":"62696971",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.28,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112705,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.28,
         "custom_id":"10000"
      },
      "62697425":{
         "item":{
            "id":"62697425",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.03,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112706,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.03,
         "custom_id":"10001"
      }
   },
    "unavailable":{
      "62696979":{
         "error_code":5,
         "error_message":"skin_unavailable"
      },
      "62697480":{
         "error_code":5,
         "error_message":"skin_unavailable"
      }
   }
}

Lista de possíveis erros:

invalid_partner_value

Valor inválido para 'partner'

invalid_token_value

Valor inválido para 'token'. Solicite uma nova Trade URL ao usuário

too_many_failed_attempts_for_user

Muitas tentativas malsucedidas ao enviar skins para o usuário (Trade URL inválida, usuário não aceita skins no tempo especificado, usuário não tem permissão para negociar skins). Tente novamente mais tarde

-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