ويب هوكس

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

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

أنشئ ويب هوك#

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

Shell

curl -X POST https://gheima.ma/api/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).
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 للجسم الخام بسرّك). تحقّق من التوقيع قبل الوثوق بالحمولة. أرسِل تسليمًا تجريبيًا في أي وقت:

Shell

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

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

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