دیتابیس ابری برای ابزارها

در دنیای مدرن، نگهداری و مدیریت داده‌ها به یکی از چالش‌های اصلی صنایع الکترونیک تبدیل شده است. از دست دادن اطلاعات به دلایل مختلفی مانند خرابی سخت‌افزار، نوسانات برق، یا خطاهای نرم‌افزاری می‌تواند مشکلات جدی به همراه داشته باشد. در این راستا، ایر انجین قابلیت دیتابیس ابری را معرفی کرده است تا ابزارهای الکترونیکی بتوانند داده‌های حیاتی خود را به‌صورت ایمن و پایدار ذخیره کنند.

چالش‌های ذخیره‌سازی اطلاعات در ابزارهای الکترونیکی

یکی از روش‌های رایج برای ذخیره داده‌ها در ابزارهای الکترونیکی، استفاده از EEPROM و حافظه‌های داخلی دستگاه است. اما این روش‌ها محدودیت‌های خاص خود را دارند:

• عمر محدود حافظه‌ها: حافظه‌های EEPROM پس از تعداد مشخصی از عملیات نوشتن-خواندن ممکن است دچار خرابی شوند.
• مقاومت پایین در برابر نوسانات الکتریکی: بسیاری از ابزارهای صنعتی در محیط‌هایی با نوسانات برق شدید کار می‌کنند که احتمال از بین رفتن داده‌های ذخیره‌شده را افزایش می‌دهد.
• محدودیت‌های سخت‌افزاری: ظرفیت ذخیره‌سازی این حافظه‌ها معمولاً محدود بوده و امکان افزایش آن دشوار یا پرهزینه است.

راهکار ایر انجین: دیتابیس ابری برای ابزارها

با بهره‌گیری از دیتابیس ابری ایر انجین، کاربران می‌توانند اطلاعات مهم ابزارهای خود را بدون وابستگی به حافظه‌های داخلی ذخیره کرده و از هر نقطه‌ای به آن‌ها دسترسی داشته باشند. این قابلیت امکان ثبت و بازیابی اطلاعات را با اطمینان بالا فراهم می‌کند.

ویژگی‌های دیتابیس ابری ایر انجین

• ذخیره‌سازی امن: داده‌ها در سرورهای ابری قدرتمند ذخیره شده و از مکانیزم‌های رمزگذاری برای حفاظت از آن‌ها استفاده می‌شود.
• دسترسی از راه دور: کاربران می‌توانند داده‌های خود را از هر نقطه‌ای به‌وسیله اینترنت مشاهده و مدیریت کنند.
• پایداری و دوام بالا: برخلاف EEPROM، داده‌های ذخیره‌شده در فضای ابری در برابر خرابی سخت‌افزاری مقاوم هستند.
• امکان ذخیره‌سازی تا ۵ رکورد برای هر ابزار: هر دستگاه قادر خواهد بود تا پنج رکورد اطلاعاتی را در دیتابیس ابری ذخیره کند که این قابلیت می‌تواند در بسیاری از سناریوهای صنعتی و کاربردی مفید باشد.
• قابلیت توسعه در آینده: در صورت نیاز، می‌توان تعداد رکوردهای ذخیره‌سازی را افزایش داده و امکانات بیشتری را برای کاربران فراهم کرد.

---

این Api برای ذخیره اطلاعات است

نکته: کلید Key درواقع همان کلمه‌ای است که شما می‌خواهید با آن دیتا را بشناسید و ذخیره نمایید.

مثال: شما دارای رکوردی برای شمارش ورود ماشین به یک پارکینگ هستید و اسم کلید شما به دلخواه می‌تواند countCar یا حتی یک عبارت نامفهوم مانند kjgyk باشد.
دقت کنید کلید نمی‌تواند بیشتر از ۲۰ کاراکتر باشد.

نکته: می‌توانید دیتاها را به‌صورت داده‌های مختلف، از جمله JSON، ذخیره نمایید.
نکته: فیلدهای username، password، projectCode در زمان اضافه کردن یک ابزار به یک پروژه به شما داده می‌شود.
نکته: value همان مقدار موردنظر شما جهت ذخیره‌سازی است.
نکته: با هر بار AddNewData اگر داده شما وجود داشته باشد آن داده آپدیت می‌شود.

آدرس ذخیره کردن داده

url : https://app.airngin.com/api/v1.0/DeviceCloud/AddNewData

پارامتر	نوع داده	توضیحات
Username	String	نام کاربری MQTT اختصاص یافته به ابزار
Password	String	گذرواژه MQTT اختصاص یافته به ابزار
DeviceSerial	String	شماره سریال دستگاه
ProjectCode	String	کد پروژه مربوط به دستگاه
Key	String	کلید منحصر‌به‌فرد
Value	String	مقدار داده‌ای که ارسال می‌شود

متد: POST
فرمت ارسال داده: FromForm (application/x-www-form-urlencoded)

دریافت داده ذخیره شده

آدرس فراخوانی کردن داده

url : https://app.airngin.com/api/v1.0/DeviceCloud/GetDeviceCloud

جزئیات درخواست:

پارامتر	نوع داده	توضیحات
Username	String	نام کاربری MQTT اختصاص یافته به ابزار
Password	String	گذرواژه MQTT اختصاص یافته به ابزار
DeviceSerial	String	شماره سریال دستگاه
ProjectCode	String	کد پروژه مربوط به دستگاه
Key	String	کلید منحصر‌به‌فرد

حذف داده

آدرس فراخوانی کردن داده

url : https://app.airngin.com/api/v1.0/DeviceCloud/DeleteData

جزئیات درخواست:

پارامتر	نوع داده	توضیحات
Username	String	نام کاربری MQTT اختصاص یافته به ابزار
Password	String	گذرواژه MQTT اختصاص یافته به ابزار
DeviceSerial	String	شماره سریال دستگاه
ProjectCode	String	کد پروژه مربوط به دستگاه
Key	String	کلید منحصر‌به‌فرد

**** متد Delete است و داده به صورت FromQuery ارسال میشود ***

کدهای خطا

کد خطا	توضیحات
8031069	یوزرنیم نمی‌تواند خالی باشد.
8031070	پسورد نمی‌تواند خالی باشد.
8031008	شماره سریال ابزار باید مشخص باشد.
8031071	شماره سریال باید ۱۴ رقم باشد.
8031007	کد پروژه باید مشخص باشد.
8031065	کد پروژه باید ۱۶ رقم باشد.
8031072	کلید باید مشخص باشد.
8031074	طول کلید نمی‌تواند بیش از ۲۰ کاراکتر باشد.
8031075	کلید تنها باید شامل حروف انگلیسی و اعداد باشد.