Compra de skin e envio para o usuário

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

Compra de uma skin e envio para o usuário.

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_buy

partner

string

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

token

string

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

name + game

string + string

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

— OU —

int

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

max_price

float

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

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:

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",
    "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á peles com preço <= 'max_price'

custom_id_already_exists

'custom_id' já existe em nosso sistema

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

custom_id_already_processing

Outro pedido com o mesmo 'custom_id' está a ser processado. Por favor, 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