الأجهزة المتصلة · واجهة HTTP API
Node-RED أو Home Assistant أو برنامجك النصي، متصلة بالصيانة
كثير من المواقع تقرأ عداداتها أصلًا في مكان ما: تدفق Node-RED يستطلع محلّل طاقة يعمل بـ Modbus، أو نظام Home Assistant مع عشرات المستشعرات، أو بوابة لوحدة تحكم منطقية، أو برنامج نصي بلغة Python على حاسوب صغير. تتيح FreeMaint Connect لأي منها إرسال قيمه بطلب HTTP واحد، فتصل هذه القياسات أخيرًا إلى الأصول والتنبيهات وأوامر العمل بدل أن تبقى حبيسة شاشة لا يراها فريق الصيانة.
Free your maintenance · باقة Core مجانية، مستخدمون بلا حدود، بدون بطاقة ائتمان.
باختصار
تقبل FreeMaint Connect القياسات من أي نظام قادر على إرسال JSON عبر HTTP: Node-RED، أو Home Assistant، أو بوابة Modbus أو وحدة تحكم منطقية، أو موجّه Teltonika، أو برنامج نصي. يحمل كل طلب مفتاح وصول في ترويسته ويسرد الأجهزة مع قيمها؛ فيحوّل FreeMaint الوحدات، ويُنشئ القنوات مع أول رسالة، ويتيح لقواعد التنبيه وعدادات ساعات التشغيل وعدادات الطاقة استخدامها مثل أي جهاز معتمد.
آخر تحديث 16 أكتوبر 2026
ما الذي تمنحك إياه واجهة HTTP API
طلب واحد لأجهزة كثيرة
يمكن لطلب POST واحد أن يحمل ما يصل إلى 500 جهاز و5,000 قيمة، لكل منها توقيتها الخاص. وتُنشأ الأجهزة والقنوات تلقائيًا مع أول رسالة منها.
متاح في باقة Businessتحويل الوحدات يتولاه FreeMaint
أرسل الطاقة بالواط ساعة أو الكيلوواط ساعة أو الميغاواط ساعة، ودرجات الحرارة بالدرجة المئوية °C أو الفهرنهايت °F، وسرعة الاهتزاز بـ mm/s أو in/s: يخزّن FreeMaint كل كمية بوحدة واحدة، فتُجمع قيم الأنظمة المختلفة بشكل صحيح.
متاح في باقة Businessالعدادات تُفهم على أنها عدادات
صنّف القيمة على أنها تراكمية، مثل إجمالي الطاقة أو عداد ساعات التشغيل، فيحسب FreeMaint الاستهلاك بين القراءات، حتى بعد إعادة ضبط العداد.
متاح في باقة Businessالتنبيهات وأوامر العمل نفسها كأي جهاز
بمجرد وصول القيمة تصبح قناة مثل أي قناة أخرى: قواعد التنبيه، ومناطق الاهتزاز وفق ISO 20816، وساعات التشغيل، والربط بعدادات الأصول وعدادات الطاقة، والعرض المباشر في تطبيق الهاتف.
متاح في باقة Businessمفتاح لكل اتصال
لكل اتصال مفتاح وصول خاص به، يُرسل في ترويسة الطلب وليس في عنوان URL أبدًا. يمكنك تدويره في أي وقت، مع إبقاء المفتاح القديم صالحًا لمدة 24 ساعة أو إلغائه فورًا.
متاح في باقة Businessمتى تكون واجهة HTTP API هي المسار الصحيح
يفك FreeMaint ترميز عدد قليل من الأجهزة بنفسه، هي عدادات الطاقة Shelly ومستشعرا LoRaWAN من Milesight. وكل ما عدا ذلك يمر عبر واجهة HTTP API، وهذا يغطي معظم أجهزة الموقع الصناعي: محلّل طاقة يعمل بـ Modbus يقرؤه Node-RED، أو مستشعر في Home Assistant، أو نظام إدارة مبانٍ يصدّر نقاطه، أو وحدة تحكم منطقية تنشر عداداتها أصلًا، أو مستشعر اهتزاز تقرؤه بوابته الخاصة.
لا يتعامل FreeMaint مباشرة مع بروتوكولات Modbus أو MQTT أو BACnet أو OPC UA. وهذا اختيار مقصود: فالبوابة الموجودة أصلًا في شبكتك تعرف البروتوكول وخريطة السجلات، بينما لا يحتاج FreeMaint إلا إلى القيم. وتدفق Node-RED أو برنامج نصي قصير يحوّل السجلات إلى JSON لا يتجاوز في العادة بضعة أسطر.
- تدفقات Node-RED التي تقرأ أجهزة Modbus RTU أو TCP
- أتمتة Home Assistant التي تعيد إرسال قراءات المستشعرات
- موجّهات Teltonika مع خاصية Data to Server
- بوابات وحدات التحكم المنطقية وأنظمة إدارة المباني
- برامج نصية على حاسوب صغير أو Raspberry Pi
كيف يبدو الطلب
الطلب من نوع POST يُرسل إلى عنوان URL الذي يعرضه FreeMaint عند إنشاء الاتصال، مع ترويستين: Authorization التي تحمل مفتاح الوصول، وContent-Type بقيمة application/json. ويسرد متن الطلب عناصر: كل عنصر هو معرّف جهاز، مع اسم عرض وتوقيت اختياريين، ونقاط القياس الخاصة به. ولكل نقطة مفتاح مثل power أو energy_total، وقيمة، ويُفضَّل أن تحمل وحدة وكمية، ونوعًا تراكميًا إذا كانت عدادًا.
يردّ FreeMaint بالرمز 202 عند قبول البيانات، ويخزّنها خلال ثوانٍ. أما الطلب غير السليم فيتلقى ردًا بالرمز 400 يسمّي المشكلة، فتُصلح البوابة سيئة الضبط خلال دقائق بدل أن يُكتشف خطؤها بعد أسابيع. ويقبل كل اتصال ما يصل إلى 120 طلبًا في الدقيقة؛ وبعد ذلك يردّ FreeMaint بالرمز 429، وعلى نظامك أن يعيد المحاولة لاحقًا.
ساعات التشغيل والطاقة من نظامك الخاص
إذا كانت وحدة التحكم المنطقية لديك تحسب ساعات التشغيل أصلًا، فأرسل العداد كقيمة تراكمية واربط القناة بعداد ساعات التشغيل الخاص بالأصل: فتنطلق الخطط الوقائية وفقه. وإذا كانت لا تُبلغ إلا عن القدرة أو التيار، فدع FreeMaint يحسب ساعات التشغيل من تلك القناة عبر «حساب ساعات التشغيل». أما للطاقة، فاربط القناة بعداد طاقة، فيسجّل FreeMaint قراءة كل 15 دقيقة مع تكلفتها وانبعاثات CO2 الخاصة بها.
الخطط والحدود
واجهة HTTP API جزء من FreeMaint Connect، ضمن خطة Business بسعر 99 دولارًا أمريكيًا شهريًا لكل شركة، بسعر ثابت، مع 100 قناة نشطة. وتشمل خطة Enterprise خمسة آلاف قناة (5,000). والقناة غير النشطة لا تُحتسب، وتبقى البيانات التي وصلت ظاهرة في كل الخطط. ولقراءة بقية بيانات FreeMaint وكتابتها، مثل أوامر العمل والأصول وقطع الغيار، تتوفر أيضًا واجهة GraphQL API في خطة Business، وwebhooks صادرة موقّعة بدءًا من خطة Starter.
أرسل قيمك الأولى في أربع خطوات
- 1
أنشئ الاتصال
من الأجهزة المتصلة ← التكاملات، انقر على «توصيل جهاز» واختر «واجهة HTTP API (Node-RED، نص برمجي…)».
- 2
انسخ عنوان URL والمفتاح
يعرض FreeMaint عنوان URL والترويستين ومثالًا على محتوى الطلب. لا يُعرض المفتاح إلا مرة واحدة.
- 3
أرسل طلبًا
من Node-RED أو Home Assistant أو برنامجك النصي، أرسل JSON بطلب POST مع الترويستين.
- 4
استخدم القنوات
اربط الجهاز الجديد بأصله، وأضف قواعد التنبيه، واربط القنوات بالعدادات.
الأسئلة الشائعة
هل يستطيع FreeMaint قراءة عداد Modbus لديّ مباشرة؟
لا. تقرأ بوابة سجلات Modbus، سواء كانت Node-RED أو Home Assistant أو موجّه Teltonika أو برنامجًا نصيًا، ثم ترسل القيم إلى FreeMaint على شكل JSON عبر HTTPS.
هل بروتوكول MQTT مدعوم؟
ليس مباشرة. يمكن لبوابة تشترك في مواضيع MQTT لديك، مثل Node-RED، أن تعيد إرسال القيم إلى واجهة HTTP API.
كم قيمة يمكن أن يحملها الطلب الواحد؟
ما يصل إلى 500 جهاز و5,000 نقطة قياس في الطلب الواحد، وما يصل إلى 120 طلبًا في الدقيقة لكل اتصال.
ماذا يحدث إذا كان طلبي خاطئًا؟
يردّ FreeMaint بالرمز 400 ويسمّي المشكلة، فتستطيع إصلاح البوابة فورًا. أما البيانات المقبولة فتتلقى الرمز 202.
هل يمكن لقيم برنامجي النصي أن تفتح أوامر عمل؟
نعم. بمجرد وصول القيمة تصبح قناة: وقاعدة تنبيه مفعّل فيها «إنشاء أمر عمل» تفتح أمر عمل على الأصل.
كيف يُحمى مفتاح الوصول؟
لكل اتصال مفتاحه الخاص، يُرسل في ترويسة Authorization وليس في عنوان URL أبدًا. ويمكنك تدويره في أي وقت، مع إبقاء القديم صالحًا 24 ساعة أو إلغائه فورًا.
ما الخطة التي أحتاجها؟
خطة Business، بسعر 99 دولارًا أمريكيًا شهريًا لكل شركة، مع 100 قناة نشطة. وتشمل خطة Enterprise خمسة آلاف قناة (5,000).
صفحات ذات صلة
أدخل البيانات التي تملكها أصلًا
ابدأ بخطة Core المجانية، ثم انتقل إلى Business عندما تكون مستعدًا لإرسال القياسات.
أنشئ حسابك المجاني