إعداد حساب المنشأة

خصّص لكل بيئة حساب منشأة ومفاتيح API وعناوين Webhook وأسرارًا مستقلة:

• Development
• Staging
• Production

لا تستخدم مفاتيح الإنتاج خارج بيئة الإنتاج.

1. سجّل الدخول إلى لوحة تحكم نيزا
2. انتقل إلى Settings → API Keys
3. أنشئ مفتاحًا لكل بيئة
4. احفظ المفتاح في أداة لإدارة الأسرار أو في متغيرات الأسرار الخاصة ببيئة CI

اختر الواجهات التي تناسب منتجك:

• تقييم المخاطر من الخادم: POST /api/v1/decisions/evaluate
• إرسال أحداث من الخادم: POST /api/v1/events (متزامن) أو POST /api/v1/events/async
• إشارات المتصفح: POST /api/v1/websdk/tokens + POST /api/v1/websdk/signals
• أتمتة العمليات: القوائم + الملاحظات + Webhooks

1. أنشئ اشتراكًا: POST /api/v1/webhooks/subscriptions
2. احفظ signingSecret فورًا (لا يظهر إلا مرة واحدة)
3. تحقّق من التوقيع باستخدام جسم الطلب الخام (raw body) كما وصل دون تعديل
4. استخدم POST /api/v1/webhooks/subscriptions/:id/test للتحقق من الاتصال

راجع قسم Webhooks في مرجع API.

• تحقق من معالجة 401 للمفاتيح المفقودة/غير الصالحة
• تحقق من معالجة 400 / 422 لبيانات الطلب غير الصالحة
• تحقق من تطبيق التأخير التدريجي بين المحاولات (backoff) عند 429
• تأكد أن إعادة إرسال Webhook لا تنفّذ الإجراء نفسه مرتين (منع تكرار الطلبات)

• فعّل لوحات مراقبة لحجم القرارات ومعدلات الأخطاء
• جهّز أدلة تشغيل (runbooks) لتدوير المفاتيح والتعامل مع الحوادث
• حدّد الفريق المسؤول داخليًا عن استمرار عمل نقطة استقبال Webhook