Eventos en tiempo real: webhooks

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

Eventos en tiempo real: webhooks

Obtener cambios en tiempo real de las skins adquiridas y el saldo.

Generar una firma de webhook de eventos

La firma se forma a partir del cuerpo de la solicitud y se convierte a SHA256 HMAC firmado con Client Secret. Firma enviada en el encabezado de Autorización. Puede descubrir el secreto del cliente en la cuenta del comerciante.

Ejemplo de validación de firma en PHP:

<?php

$clientSecret = '123'; // Client Secret

$requestContent = file_get_contents('php://input');
$expectedSignature = hash_hmac('sha256', $requestContent, $clientSecret);
$providedSignature = $_SERVER['HTTP_SIGNATURE'] ?? '';

if (!hash_equals($expectedSignature,$providedSignature)) {
    die('Wrong signature');
}

Parámetros enviados por el método POST a la URL de Webhook Events:

event

string

Nombre del evento

data

array

Datos

Encabezados enviados a la URL de eventos de Webhook:

Signature

string

Firma para verificar. Utilice el método de verificación de firma para verificar la firma de la solicitud.

O bien, puede verificar el encabezado X-SIGN enviado a su servidor mediante el algoritmo:
md5(clientId + clientSecret) (concatenación).

Lista de eventos posibles

event

Datos

Descripción

buy_item

{
   "event":"buy_item",
   "data":{
	  "item":{
		 "id":"2516",
		 "name":"AK-47 | Safari Mesh (Minimal Wear)",
		 "price":"0.4",
		 "classid":"3940562910"
	  },
	  "buy_id":"65",
	  "offer_status":"creating_trade",
	  "balance_debited_sum":"29.93",
	  "custom_id": "123456"
   }
}

Compra de skin

status_change

{
   "event":"status_change",
   "data":{
      "item":{
         "id":"2516"
      },
      "buy_id":"65",
      "offer_status":"waiting_accept",
      "error_reason":null,
      "tradeofferid":"4176876858",
      "custom_id": "123456"
   }
}

El estado de compra de la skin ha cambiado

balance_change

{
   "event":"buy_item",
   "data":{
	  "item":{
		 "id":"2516",
		 "name":"AK-47 | Safari Mesh (Minimal Wear)",
		 "price":"0.4",
		 "classid":"3940562910"
	  },
	  "buy_id":"65",
	  "offer_status":"creating_trade",
	  "balance_debited_sum":"29.93",
	  "custom_id": "123456"
   }
}

El balance del proyecto ha cambiado