إعداد المستأجر
مسار عملي من إنشاء الحساب إلى تكامل جاهز للإنتاج.
1) البيئات
استخدم مستأجرين ومفاتيح API وعناوين Webhook وأسرارًا منفصلة لكل بيئة:
- Development
- Staging
- Production
لا تعِد استخدام مفاتيح الإنتاج خارج بيئة الإنتاج.
2) أنشئ مفاتيح API
- سجّل الدخول إلى لوحة تحكم نيزا
- انتقل إلى Settings → API Keys
- أنشئ مفتاحًا لكل بيئة
- خزّن المفتاح في مدير أسرار أو متجر أسرار CI
3) اختر سطح التكامل
اختر الواجهات التي تناسب منتجك:
- قرارات مخاطر من الخادم:
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
4) Webhooks
- أنشئ اشتراكًا:
POST /api/v1/webhooks/subscriptions - احفظ
signingSecretفورًا (يُعاد مرة واحدة) - نفّذ التحقق من التوقيع باستخدام البايتات الخام للطلب
- استخدم
POST /api/v1/webhooks/subscriptions/:id/testللتحقق من الاتصال
راجع قسم Webhooks في مرجع API.
5) قائمة اختبار Sandbox
- تحقق من معالجة
401للمفاتيح المفقودة/غير الصالحة - تحقق من معالجة
400/422للحمولات غير الصالحة - تحقق من سلوك backoff عند
429 - تأكد أن إعادة تسليم Webhook لا تطبّق آثارًا مزدوجة (idempotency)
6) الإطلاق
- فعّل لوحات مراقبة لحجم القرارات ومعدلات الأخطاء
- عرّف runbooks لتدوير المفاتيح والاستجابة للحوادث
- وثّق الملكية الداخلية لوقت تشغيل نقطة استقبال Webhook