webhooks
إعداد سرّ
أنشئ سرّ webhook، حدّد نطاقه، واحفظ قائمة IP المسموحة.
سرّ Spectra webhook هو ما يربط نظام تنبيه خارجي — خادمك الخاص، Screener، سكربت، أو أي مصدر تنبيه يدعم HTTP — بحساب سبكترا. كل سرّ مقيّد باتصال وسيط واحد وسقف خسارة يومي.
إنشاء سرّ
Profile ← Webhooks ← Add. كل سرّ يحمل:
Name → تسمية بشرية، مثل "TV BTC alerts"
Broker connection → أي وسيط توجَّه إليه الأوامر التلقائية
Daily-loss cap → سقف USD لكل سرّ (إلزامي)
IP allowlist → نطاقات CIDR المسموح لها بـ POST
Active → بدّل للإيقاف دون حذف
بعد الحفظ، قيمة السرّ تظهر مرة واحدة. انسخها فوراً — سبكترا يحفظ نسخة معتمدة بـ AES-GCM فقط ولن يعرضها مجدداً. إن فقدتها، دوّرها.
سقف الخسارة اليومي
السقف يُفرض عند عامل السحابة قبل أن يُوجَّه أي أمر للوسيط. إن خرق P&L المحقّق + المفتوح لليوم السقف، يتوقّف السرّ بقية اليوم ويُطلق تنبيه.
تضبط السقف عند إنشاء السرّ؛ غيّره وقت ما تشاء. لا توجد طريقة لتعطيله — الحقل إلزامي، والحدّ الأدنى ١٠٠$ (صغير ليكون بلا احتكاك للاختبار، كبير ليُلاحَظ إن حاول أحد ضبط ٠).
قائمة IP
نطاقات CIDR التي يحقّ لها POST على webhook. افتراضياً أي IP يستطيع POST، لكن مع تحقّق HMAC نادراً ما تكون سطح هجوم حقيقي. قيّدها على IPs المصدر المنشورة عند مزوّد التنبيهات لعزل أكثر صرامة.
التدوير
Webhooks ← سرّ ← Rotate. السرّ القديم يُلغى فوراً؛ يظهر الجديد. حدّث مرسلك خلال ٥ دقائق — حماية الإعادة (انظر Replay) مرتبطة بطابع زمني، فالرسائل القديمة لن تُعاد على أي حال.