Ereignisse in Echtzeit: Webhook

Hauptseite

Hauptinformationen Generierung der Unterschrift

Einzahlungen

Erste Schritte Depot erstellen Depot erstellen ohne Weiterleitung (iframe) Benachrichtigung über Einzahlung (webhook) Überprüfung des Einzahlungsstatus Abrufen der Liste der Einlagen Einzahlungen ohne 8-tägige Wartezeit (Steam Trade Protection) Einzahlungsgenehmigung mit 8-tägigem Hold Benachrichtigungen zu fehlgeschlagenen Webhooks erhalten

Einzahlungen ohne SkinsBack UI

Create a deposit without SkinsBack UI (API) Inventar des Benutzers abrufen

Skin-Abhebung

Preisliste (Skin-Verfügbarkeit) Skin-Suche Skin kaufen Skins in großen Mengen kaufen Status des Skin-Kaufs Kaufverlauf für Skins

Sonstiges

Projektsaldo Auszahlungs- und Einzahlungshistorie Währungen und Wechselkurse Serverstatus Ereignisse in Echtzeit: Websockets Ereignisse in Echtzeit: Webhook

Ereignisse in Echtzeit: Webhook

Erhalten Sie Echtzeit-Änderungen für gekaufte Skins und Guthabenänderungen.

Erzeugen einer Ereignis-Rückrufsignatur

Die Signatur wird aus dem Request Body gebildet und in SHA256 HMAC konvertiert und mit Client Secret signiert. Die Signatur wird im Authorization-Header gesendet. Sie können das Client Secret im Konto des Händlers herausfinden.

Beispiel für Signaturvalidierung in 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');
}

Von der POST-Methode an die Webhook-Ereignis-URL gesendete Parameter:

event

string

Name des Ereignisses

data

array

Daten

An die Webhook-Ereignis-URL gesendete Header:

Signature

string

Zu überprüfende Signatur. Verwenden Sie die Signaturüberprüfungsmethode, um die Signatur der Anfrage zu überprüfen.

ODER Sie können den an Ihren Server gesendeten X-SIGN-Header mit dem folgenden Algorithmus überprüfen:
md5(clientId + clientSecret) (Verkettung).

Liste der möglichen Ereignisse

event

Daten

Beschreibung

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"
   }
}

Skin-Kauf

status_change

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

Status des Skin-Kaufs geändert

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"
   }
}

Projektguthaben geändert