تدخل بروتوكولاتك. يقرأ نظام SCADA لديك الحالة باستخدام مفتاح API بصلاحية القراءة فقط.
انقر على أي خط لمعرفة ما يمثله وكيف يتصل وحالته.
دخول →
→ خروج
OT · أرض المصنع
Modbus RTU/TCP
بوابة Wertek AI — Modbus RTU/TCP، مع خرائط سجلات لـ 32 جهازاً من 17 علامة تجارية (Eastron، Schneider، Siemens، Circutor، ABB، Janitza، Carlo Gavazzi…) وبنوك المكثفات.المعدات ترسل تقاريرها بهذه الطريقة بالفعل.
MQTT
أجهزة تنشر عبر MQTTمع التهيئة — Banner DXM (اهتزاز لاسلكي، مع مودم 4G)، ومجموعات Acrel وعدادات الطاقة.المعدات ترسل تقاريرها بهذه الطريقة بالفعل.
HTTP بمفتاح
تدفقك الخاص عبر HTTP بمفتاحعبر Node-RED / Ignition / بوابة — Node-RED أو Ignition أو n8n أو Python أو JavaScript/TypeScript؛ وصفات لـ Modbus TCP وMQTT وOPC UA، تم التحقق منها بقيم محاكاة.
OPC UA (Bently Nevada)
OPC UA من Bently Nevada System 1Beta — موصل قراءة.
هاتف في الميدان
في الميدان، بالهاتف — ملاحظات مع صور، وفيديو باستخدام VibeDiag، وتحليل صوتي وقراءات يدوية (ساعات، دورات، kWh…).
بروتوكولات أخرى
S7 وEtherNet/IP وOPC UA العام: لا نملك برنامج تشغيل خاصاً بنا؛ تصل إليها عبر Node-RED أو Ignition أو بوابة.
SCADA أو HMI أو Node-RED بمفتاح قراءة — يقرأ Ignition أو Node-RED أو برنامج نصي الأصول والقياسات مع نتائجها وتوصياتها والطاقة، لعرض الحالة بجانب tag العمليات. يُنشأ مفتاح القراءة بدءاً من خطة Monitoring.لا تكتب Wertek AI إلى PLC لديك: تنشر الوقائع والحالات، وأنت تقرر أي tag تعدّل.
IT · أنظمة الأعمال · خروج
API
API بمفتاح — أصول وقياسات وإشارة وFFT وطاقة؛ تصدير بصيغة JSON. يُنشأ مفتاح القراءة بدءاً من خطة Monitoring.
تنزيلات
تنزيلات — CSV وXLSX وParquet وWAV وPDF: قياسات وملاحظات وأوامر عمل واستهلاك وتقرير الامتثال لكود الشبكة الكهربائية.
تنبيهات
تنبيهات — إشعارات فورية وبريد إلكتروني، ومباشرة في التطبيق.
تقارير
تقارير دورية بالبريد الإلكتروني — الطاقة والامتثال لكود الشبكة الكهربائية، والحالة، والملخص الشهري لمراكز الاستهلاك.
سجّل الأصل في التطبيق وعيّن الموضع الذي ستغذيه: رمزه ومتغيراته مع وحدة UCUM ودوريته. يمكنك أيضاً تعيينه بالمفتاح: POST /iaes/assets/{asset_id}/measurement-points. يستهلك التعيين نقطة قياس: نفّذه مرة واحدة لكل موضع، لا عند كل إرسال.
3
أنشئ مفتاح الاستيعاب
في الإعدادات → مفاتيح API (Settings → API Keys)، بصلاحية الاستيعاب. احفظه سراً: في متغير بيئة، وليس في الشفرة أو في وسم أبداً.
4
أرسل القراءة
حدث asset.measurement واحد لكل قراءة، منفرداً أو في قائمة تصل إلى 100، إلى POST https://api.wertek.ai/iaes/ingest. يتضمن الرد رمزاً لكل حدث؛ وتظهر البيانات المخزنة في سجل الأصل تحت الموضع المعيّن.
كيفية تعيين نقطة قياس
1في Measurement points (أو في الأصل)، انقر على «Designate position».
المزيد
يستهلك التعيين نقطة قياس واحدة من رصيد مؤسستك: مرة واحدة لكل موضع، لا عند كل إرسال.
2أدخل الرمز والقالب والدورية.
123
الرمز = location
القالب والمتغيرات
الدورية
المزيد
الرمز هو قيمة `location` التي سيرسلها تكاملك (بأحرف صغيرة، دون مسافات). يوفّر القالب متغيرات العائلة مع وحدة UCUM الخاصة بها؛ ويمكنك إضافة متغيرات مخصصة. تحدد الدورية المتعاقد عليها، بالثواني، وتيرة إرسال القراءة.
3يظهر الموضع في القائمة ويبدأ باستقبال القراءات.
المزيد
يُحفظ كل حدث ترسله بهذا الرمز ومفتاح الاستيعاب في سجل الأصل، تحت ذلك الموضع.
استورد تدفق وصفة الإعداد (pump-process-to-wertek.flow.json)؛ تستخدم عقدة iaes-publish المفتاح نفسه.
وصفات الإعداد
Node-RED
وصفة إعداد تم التحقق منها برمجياً: يعمل برنامج القبول النصي على API بقيم محاكاة. عُقد IAES 2.0.2 استُوردت وشُغّلت في Node-RED 5.0.6 حقيقي (Docker، 2026-11-12): 5/5 أحداث صالحة.
وصفة إعداد تم التحقق منها باستخدام API في 2026-10-05، دون برنامج نصي تلقائي للقبول. عُقد IAES 2.0.2 استُوردت وشُغّلت في n8n 2.8.4 حقيقي (2026-11-12): 5/5 أحداث صالحة.
يعني MQTT اليوم قنوات لمعدات محددة — Banner DXM ومجموعات Acrel وعدادات الطاقة — لكل منها موضوع وبيانات اعتماد خاصة، تُعدّ مع التهيئة. لا يوجد موضوع شامل: لأي جهاز آخر، المسار هو HTTP بمفتاح.
الأمان والتشفير
ما يحمي بياناتك عند دخولها وما تتحكم فيه
ما يفعله الكود اليوم، ولا شيء أكثر من ذلك.
مفاتيح الإدخال
يبدأ المفتاح بـ wk_ ويُعرض مرة واحدة عند إنشائه. تخزن Wertek AI فقط تجزئة SHA-256 الخاصة به وبادئة من 12 حرفًا للتعرف عليه.
الصلاحيات وانتهاء الصلاحية والإلغاء
يحمل كل مفتاح صلاحياته (telemetry.view, telemetry.export, iaes.ingest)، ويمكن قصره على أصول محددة، ويمكن أن تنتهي صلاحيته خلال 1 إلى 365 يومًا، ويمكن إلغاؤه. لا يدير المفاتيح إلا مالك أو مسؤول.
مرتبط بمؤسستك
لا يُقبل الحدث إلا لأصول المؤسسة التي ينتمي إليها المفتاح: لا يمكن لمفتاح الكتابة إلى أصول مؤسسة أخرى.
أثناء النقل
تُقدَّم API عبر HTTPS. بالنسبة إلى MQTT، استخدم المنفذ 8883 مع TLS.
ملفات عبر روابط موقعة
تُسلَّم اللقطات والمستندات عبر روابط موقعة باستخدام HMAC-SHA256 تنتهي صلاحيتها.
البيانات المخزنة
يشفر مزودونا (Supabase لقاعدة البيانات وCloudflare R2 للملفات) البيانات التي يخزنونها.
الحدود والاستخدام
حتى 300 طلب في الدقيقة لكل بيانات اعتماد آلة (429 عند تجاوز ذلك) و100 حدث لكل دفعة. تسجل API الخاصة بالقياس عن بُعد استخدام كل مفتاح وآخر استخدام له.
توصيات للمكاملين
MQTT: المنفذ 8883 مع TLS.
لا نوصي بإرسال بيانات غير مشفرة. إذا كان جهاز لا يدعم TLS، فتواصل معنا: يمكن تقييمه مع وسائل حماية أخرى.
مفتاح واحد لكل موقع، بأقل صلاحية (iaes.ingest لإرسال البيانات) وبتاريخ انتهاء صلاحية.
احتفظ بالمفتاح في متغير بيئة أو مخزن للأسرار، ولا تضعه أبدًا في الكود أو التدفق.