التوثيق

Webhooks

استقبل أحداث verification.completed موقّعة على endpoint HTTPS.

Shernova ترسل webhooks صادرة عند اكتمال التحقق. اضبط webhook_url في لوحة التحكم أو PATCH /v1/apps/:id.

الأحداث

الحدثمتى
verification.completedعند verified
webhook.testاختبار يدوي

التوصيل

POST · JSON · مهلة 10 ث · حتى 5 محاولات backoff.

Headers

http
Content-Type: application/json
User-Agent: Shernova-Webhook/1.0
X-Shernova-Event: verification.completed
X-Shernova-Signature: sha256=<hmac_hex>

Payload (verification.completed)

json
{
  "session_id": "uuid",
  "status": "verified",
  "phone_number": "+201012345678",
  "verified_at": "2026-07-21T12:00:00.000Z",
  "timestamp": "2026-07-21T12:00:01.000Z"
}

التحقق من التوقيع

HMAC-SHA256 للجسم الخام بسر webhook. قارن مع X-Shernova-Signature.

متطلبات URL

  • HTTPS فقط
  • بدون عناوين خاصة
  • بدون redirects
  • استجابة 2xx خلال 10 ث

المراقبة

لوحة Admin /admin/webhooks وإعادة المحاولة عبر API.