Compra masiva de skins y envío al usuario.

Principal

Información principal Generación de firma

Depósitos

Empezando Creación de depósito Creación de depósito sin redireccionamiento (iframe) Notificación de depósito (webhook) Verificación del estado del depósito Obtener lista de depósitos Depósitos sin período de espera de 8 días (Steam Trade Protection) Aprobación de depósito con retención de 8 días Recibir notificaciones de webhooks fallidos

Depósitos sin SkinsBack UI

Create a deposit without SkinsBack UI (API) Crear un depósito sin SkinsBack UI (API)

Retiro de skins

Lista de precios (disponibilidad de skins) Buscar skins Comprar skin Compra de skins al por mayor Estado de compra de skin Historial de compras de skins

Otro

Saldo del proyecto Historial de retiros del saldo y depósitos Monedas y tasas Estado del servidor Eventos en tiempo real: websockets Eventos en tiempo real: webhooks

Compra masiva de skins y envío al usuario.

Compra masiva de skins y envio a usuarios.

Los parámetros obligatorios están resaltados en azul .

Envía una solicitud POST a API Endpoint con los siguientes parámetros:

method

string

market_batch_buy

partner

string

Valor 'partner' de la Trade URL del usuario

token

string

Valor 'token' de la Trade URL del usuario

items

array

Variedad de artículos para comprar aspectos

items[][id]

int

ID del skin en la lista de precios o búsqueda

items[][max_price]

float

Costo máximo del skin para comprar (en USD). Se utiliza como límite de costo

items[][custom_id]

string

ID único en su sistema. Se utiliza para evitar compras duplicadas.

Respuesta del servidor:

En caso de éxito, la respuesta del servidor será un objeto JSON con el siguiente contenido:

purchased

array

Matriz que contiene una lista de máscaras compradas, descripción a continuación

unavailable

array

Matriz que contiene una lista de identificaciones de máscaras no disponibles y motivos:
- insufficient_funds (error_code: 4) — Fondos insuficientes en el saldo del proyecto
- skin_unavailable (error_code: 5) — La skin no está disponible para comprar
- skins_not_found_at_specified_price (error_code: 6) — No se encontraron skins con un precio <= 'max_price'
- custom_id_already_exists: (error_code: 7) — 'custom_id' ya existe en nuestro sistema

Matriz de 'purchased'

item

object

Objeto que contiene información sobre la piel comprada

— item.id

int

ID de la piel

— item.name

string

Nombre de la piel

— item.price

float

Precio de la piel en USD

— item.classid

string

ID de clase de la piel

buy_id

int

ID de la compra, se requiere para verificar el estado de la transferencia del artículo

offer_status

string

Estado de compra:
1. 'creating_trade' — el intercambio se está creando
2. 'waiting_accept' — el intercambio está esperando a ser aceptado
3. 'accepted' — el intercambio ha sido aceptado
4. 'canceled' — el intercambio ha sido cancelado por el usuario
5. 'timeout' — el intercambio no fue aceptado en 10 minutos
6. 'invalid_trade_token' — token de intercambio inválido
7. 'user_not_tradable' — el usuario tiene restricciones en el sistema de intercambio
8. 'trade_create_error' — error al crear el intercambio (intente nuevamente)
9. 'rollback_user' — el skin ha sido devuelto por el usuario (Protección de Intercambio de Steam)
10. 'rollback_supplier' — el skin ha sido devuelto por el proveedor (Protección de Intercambio de Steam)

Este método solo puede contener create_trade. Otros estados se encuentran en los métodos market_getinfo / market_history.

balance_debited_sum

float

Monto debitado del saldo del proyecto (USD)

Ejemplo de respuesta exitosa:

{
   "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 posibles errores:

invalid_partner_value

Valor incorrecto para 'partner'

invalid_token_value

Valor incorrecto para 'token'. Solicite una nueva Trade URL al usuario

too_many_failed_attempts_for_user

Demasiados intentos fallidos al enviar skins al usuario (Trade URL incorrecta, usuario no acepta skins a tiempo, usuario no tiene capacidad para intercambiar skins). Intente nuevamente más tarde

-6

market_disabled

Mercado desactivado

errores estándar:

-1

please_use_post_method

Es necesario utilizar el método POST

-2

invalid_shopid

ID del proyecto no encontrado en el sistema

-3

invalid_signature

Firma incorrecta

-4

shop_not_active

El proyecto no está activo

-5

invalid_method

Método API inválido

-7

request_limit_reached

Se ha alcanzado el límite de solicitudes (500 por minuto)

-8

invalid_ip_address

Por favor, especifique la dirección IP en la configuración del proyecto

-9

under_maintenance

El sitio web está en mantenimiento

-10

invalid_client_secret

Encabezado X-CLIENT-SECRET no válido