Sự kiện thời gian thực: webhooks

Chung

Thông tin chính Tạo chữ ký

Tiền gửi

Bắt đầu Tạo khoản tiền gửi Tạo khoản tiền gửi mà không chuyển hướng (iframe) Thông báo về khoản tiền gửi (webhook) Kiểm tra trạng thái khoản tiền gửi Lấy danh sách khoản tiền gửi Tiền gửi không cần chờ 8 ngày (Bảo vệ giao dịch Steam) Phê duyệt tiền gửi với thời gian giữ 8 ngày Nhận thông báo webhook không thành công

Tiền gửi không Có Giao diện Người Dùng SkinsBack

Create a deposit without SkinsBack UI (API) Nhận hàng tồn kho của người dùng

Rút skin

Bảng giá (sẵn có skin) Tìm kiếm skin Mua skin Mua skin số lượng lớn Trạng thái mua skin Lịch sử mua skin

Khác

Số dư dự án Lịch sử rút tiền từ số dư và khoản tiền gửi Đồng tiền và tỷ giá Trạng thái máy chủ Sự kiện thời gian thực: websockets Sự kiện thời gian thực: webhooks

Sự kiện thời gian thực: webhooks

Nhận thông tin cập nhật thời gian thực về các skin đã mua và thay đổi số dư.

Tạo chữ ký webhook sự kiện

Chữ ký được hình thành từ nội dung yêu cầu và chuyển đổi nó thành SHA256 HMAC được ký bằng Bí mật khách hàng. Chữ ký được gửi trong tiêu đề Ủy quyền. Bạn có thể tìm ra Bí mật khách hàng trong tài khoản của người bán.

Ví dụ xác thực chữ ký trong 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');
}

Các tham số được gửi bằng phương thức POST tới URL Sự kiện Webhook:

event

string

Tên sự kiện

data

array

Dữ liệu

Tiêu đề được gửi tới URL Sự kiện Webhook:

Signature

string

Chữ ký để xác minh. Sử dụng phương pháp xác minh chữ ký để xác minh chữ ký của yêu cầu.

HOẶC bạn có thể xác minh tiêu đề X-SIGN được gửi đến máy chủ của mình bằng thuật toán:
md5(clientId + clientSecret) (nối).

Danh sách các sự kiện có thể xảy ra

event

Dữ liệu

Mô tả

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

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

Trạng thái mua skin đã thay đổi

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

Số dư dự án đã thay đổi