# ويب هوكس

> اشترك بنقطة نهاية في أحداث المنصّة وتحقّق من التسليمات الموقّعة.

Source: https://gheima.ma/ar/docs/webhooks

ترسل خطافات الويب الصادرة أحداث المنصّة إلى نقطة نهاية تتحكّم بها، فتتفاعل الأنظمة الخارجية مع ما يجري على غيمة. أدِرها من صفحة خطافات الويب أو عبر API. ولا يديرها إلا المسؤولون.

### أنشئ ويب هوك

أرسل عبر POST رابطًا والأحداث التي تريدها. القائمة الفارغة ([]) تشترك في جميع الأحداث. لا يُعاد سرّ التوقيع إلا مرة واحدة، فاحفظه في مكان آمن.

```bash
curl -X POST https://api.gheima.ma/v1/webhooks \
  -H "Authorization: Bearer gh_xxxxx" -H "content-type: application/json" \
  -d '{"url":"https://example.com/hook","events":["DEPLOYMENT_CREATED"]}'
```

### الأحداث

- DEPLOYMENT_CREATED: بدأت عملية نشر. يُسلَّم باسم deployment.created.
- DEPLOYMENT_SUCCEEDED وDEPLOYMENT_FAILED: أصبحت عملية نشر متاحة أو فشلت، بما في ذلك المعاينات والتراجعات (تحمل المعاينة preview: true). يُسلَّمان باسمَي deployment.succeeded وdeployment.failed. لا تُرسل عملية النشر الملغاة أو المتخطّاة أيًّا منهما.
- SERVICE_CREATED وSERVICE_DELETED: أُنشئت خدمة أو حُذفت. يُسلَّمان باسمَي service.created وservice.deleted.
- DATABASE_CREATED: جُهّزت قاعدة بيانات. يُسلَّم باسم database.created.
- PING: حدث الاختبار. يُسلَّم باسم ping.

### تحقّق من التسليمات

كل تسليم هو جسم JSON بالشكل { event, data, timestamp } مع ترويسة x-gheima-event وترويسة x-gheima-signature (‏sha256=HMAC للجسم الخام بسرّك). تحقّق من التوقيع قبل الوثوق بالحمولة. أرسِل تسليمًا تجريبيًا في أي وقت:

```bash
curl -X POST https://api.gheima.ma/v1/webhooks/<id>/test \
  -H "Authorization: Bearer gh_xxxxx"
```

يرسل حدث ping إلى نقطة نهايتك.

> Result: تتفاعل أنظمتك مع أحداث غيمة في الزمن الحقيقي، بحمولات موقّعة قابلة للتحقّق.

---

All docs: https://gheima.ma/ar/docs.md