Compra de skin e envio para o 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 de skin e envio para o usuário

Compra de skin e envio para o 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_buy

partner

string

Valor 'partner' da Trade URL do usuário

token

string

Valor 'token' da Trade URL do usuário

name + game

string + string

(market hash name) + jogo ('cs2', 'dota2', 'rust')

— OU —

int

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

max_price

float

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

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:

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",
    "item": {
        "id": "2729",
        "name": "Glock-18 | Bullet Queen (Battle-Scarred)",
        "price": "1591.91",
        "classid": "3770702114",
    },
    "buy_id": 5,
    "offer_status": "creating_trade",
    "balance_debited_sum": 3000
}

Lista de possíveis erros:

missing_name_and_id

Nome do skin e ID ausentes

name_min_length_3

Comprimento mínimo do nome do skin é de 3 caracteres

missing_partner_or_token

Parâmetro 'token' ou 'partner' ausente

insufficient_funds

Saldo insuficiente no projeto

skin_unavailable

A pele não está disponível para compra

skins_not_found_at_specified_price

Não há skins com preço <= 'max_price'

custom_id_already_exists

'custom_id' já existe em nosso sistema

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

custom_id_already_processing

Outra solicitação com o mesmo 'custom_id' está sendo processada no momento. Aguarde e tente novamente

-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