Webhooks

Lynq تُرسل طلبات HTTPS POST إلى عناوين URL مسجّلة. الحمولات بغلاف Stripe-style موقّع بـ HMAC-SHA256.

الاشتراك

POST /webhooks مع URL HTTPS. 201 Created يتضمن:

id — ULID الاشتراك
secret — يُعرض مرة واحدة

{
  "url": "https://your-company.example.com/webhooks/lynq",
  "description": "Production listener",
  "event_filters": []
}

event_filters فارغ = كل الأحداث في الكatalog.

الرؤوس

الرأس	الغرض
`X-Lynq-Signature`	`t=<unix>,v1=<hex>` على `{t}.{raw_body}`
`X-Lynq-Event`	نوع الحدث
`Content-Type`	`application/json`

خوارزمية التحقق

اقرأ بايتات الجسم الخام.
استخرج t وv1 من X-Lynq-Signature.
احسب HMAC-SHA256(secret, "{t}.{raw_body}") hex صغير.
قارن مع v1 بمقارنة ثابتة الزمن.

استخدم الأدوات للمقتطفات المرجعية.

شكل الغلاف

{
  "id": "01EVTEXAMPLE0000000000000001",
  "object": "event",
  "created": 1715000000,
  "livemode": false,
  "type": "order.delivered",
  "data": {
    "object": {
      "id": "01ORDER…",
      "status": "delivered"
    }
  }
}

إعادة المحاولة

إعادة المحاولة مع backoff. نفس id للحدث المنطقي. احفظ المعرّفات المعالجة.

الاختبار

POST /webhooks/\{id\}/test — حدث webhook.test تجريبي

كatalog الأحداث

صفحات مرجعية تحت Webhook Events.

الاشتراك​

الرؤوس​

خوارزمية التحقق​

شكل الغلاف​

إعادة المحاولة​

الاختبار​

كatalog الأحداث​

ذات صلة​