Asosiy qismga oʻtish

2-bob · API va integratsiya

Webhooklar: hodisalar va imzoni tekshirish

Buyurtma holati oʻzgarganda serveringizga imzolangan xabar olish va uni tekshirish.

2 daqiqada oʻqiladi

Shu sahifada
  1. Sozlash
  2. Hodisalar
  3. Soʻrov koʻrinishi
  4. Javob va qayta urinishlar
  5. Imzoni tekshirish

Buyurtma holati oʻzgarganda serveringizga imzolangan POST soʻrov yuboramiz. Bu mijozga natijani tez berish va doimiy soʻrov (polling) yubormaslikning eng yaxshi yoʻli.

Sozlash

  1. Panelda Webhook boʻlimini oching.
  2. Webhook URL maydoniga manzilingizni yozing, masalan https://shop.example.com/partner/webhook. Faqat https, 443 yoki 8443 port va ochiq (public) manzil qabul qilinadi.
  3. Saqlang. Imzo siri (whsec_…) faqat bir marta koʻrsatiladi — nusxa olib, server sozlamalarida saqlang.
  4. Webhookni oʻchirish uchun URL maydonini boʻsh qoldirib saqlang.

Sir yoʻqolsa, Yangi sir yaratish tugmasini bosing — eski sir darhol ishlamay qoladi.

Hodisalar

Hodisa Qachon
order.pending Buyurtma qabul qilindi
order.processing Yetkazish boshlandi
order.completed Buyurtma bajarildi; kodlar data.delivered ichida
order.failed Buyurtma bajarilmadi va pul qaytarildi

Soʻrov koʻrinishi

POST /partner/webhook HTTP/1.1
Content-Type: application/json
User-Agent: GOXOST-Partner-Webhooks/1.0
X-Partner-Event: order.completed
X-Partner-Delivery: whd_481
X-Partner-Signature: t=1763200934,v1=5f2c…

{ "id": "whd_481", "event": "order.completed", "created_at": "2026-11-15T10:02:14Z", "data": { …buyurtma… } }

data — API qaytaradigan buyurtma obyektining aynan oʻzi.

Javob va qayta urinishlar

  • 5 soniya ichida istalgan 2xx kod bilan javob bering. Ogʻir ishni javobdan keyin bajaring.
  • Yoʻnaltirishlar (redirect) kuzatilmaydi — yakuniy URL ni yozing.
  • Aks holda 1 daqiqa, 5 daqiqa, 30 daqiqa, 2 soat, 6 soat va 24 soatdan keyin qayta yuboramiz.
  • Bir xil xabar bir necha marta kelishi mumkin — takrorlarni id boʻyicha oʻtkazib yuboring.
  • Hodisalar tartibsiz kelishi mumkin — kelish tartibiga emas, data.status va data.updated_at ga ishoning.

Panelning Webhook sahifasida Soʻnggi yuborilganlar roʻyxati bor: hodisa, urinishlar soni va holat (Kutilmoqda, Yetkazildi, Yetkazilmadi).

Imzoni tekshirish

Har bir xabarga ishonishdan oldin uni tekshiring. X-Partner-Signature sarlavhasida t (vaqt) va v1 bor. v1 — "{t}.{xom tana}" qatorining imzo siri bilan HMAC-SHA256 qiymati (hex).

  • JSON parse qilinishidan oldingi xom tanadan foydalaning.
  • Doimiy vaqtli taqqoslashdan foydalaning.
  • 5 daqiqadan eski vaqt belgisini rad eting.
<?php
$body = file_get_contents('php://input');
$header = $_SERVER['HTTP_X_PARTNER_SIGNATURE'] ?? '';
parse_str(str_replace(',', '&', $header), $sig);

$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $body, getenv('PARTNER_WEBHOOK_SECRET'));
if (abs(time() - (int) ($sig['t'] ?? 0)) > 300 || ! hash_equals($expected, $sig['v1'] ?? '')) {
    http_response_code(400);
    exit;
}
$event = json_decode($body, true);
http_response_code(200);
import hashlib, hmac, time

def verify(raw_body: bytes, header: str, secret: str) -> bool:
    sig = dict(part.split("=", 1) for part in header.split(","))
    if abs(time.time() - int(sig.get("t", 0))) > 300:
        return False
    expected = hmac.new(secret.encode(), f"{sig['t']}.".encode() + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig.get("v1", ""))

Imzoni qayta kodlangan JSON boʻyicha tekshirmang — bitta boʻshliq ham xeshni buzadi. Node.js namunasi API hujjatining «Webhooklar» bobida.

Maqola foydali boʻldimi?

Javob topmadingizmi?

Murojaat yuboring — mutaxassis hisobingizni koʻrib, javob beradi.