Compra em massa de skins e envio para o utilizador

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

Compra em massa de skins e envio para o utilizador

Compra em massa de skins e envio para o utilizador.

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_batch_buy

partner

string

Valor 'partner' do URL de Comércio do usuário

token

string

Valor do 'token' do Trade URL do usuário

items

array

Conjunto de artigos para compra de skins

items[][id]

int

ID do skin a partir da lista de preços ou pesquisa

items[][max_price]

float

Custo máximo do skin para compra (em USD). Usado como limitador de custo

items[][custom_id]

string

ID exclusivo no seu sistema. Utilizado 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 adquiridas, 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á peles 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 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)

Este método só pode conter 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 'partner' inválido

invalid_token_value

Valor 'token' inválido. Solicite uma nova URL de negociação ao usuário

too_many_failed_attempts_for_user

Muitas tentativas sem sucesso ao enviar peles para o usuário (URL de negociação inválida, usuário não aceita peles no tempo especificado, usuário não tem permissão para trocar peles). 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