HTTP API দিয়ে পরিমাপ পাঠান

JSON বডিসহ HTTP রিকোয়েস্ট পাঠাতে পারে এমন যেকোনো সিস্টেম FreeMaint Connect-এ ডেটা দিতে পারে: Node-RED, Home Assistant, Modbus পড়ে এমন একটি গেটওয়ে, একটি PLC বা আপনার নিজস্ব স্ক্রিপ্ট। এর URL ও অ্যাক্সেস কী পেতে HTTP API (Node-RED, স্ক্রিপ্ট…) ধরনের একটি সংযোগ তৈরি করুন।

রিকোয়েস্ট

মেথড: POST, সংযোগ তৈরির সময় দেখানো URL-এ (এটি /connect/ingest/generic দিয়ে শেষ হয়)।
হেডার Authorization: Bearer, তারপর অ্যাক্সেস কী।
হেডার Content-Type: application/json।
ডেটা গৃহীত হলে FreeMaint 202 উত্তর দেয়; কয়েক সেকেন্ডের মধ্যে তা সংরক্ষিত হয়।

বডি

বডিতে items-এর অধীনে ডিভাইসগুলোর তালিকা থাকে। প্রতিটি ডিভাইসের একটি শনাক্তকারী (device), একটি ঐচ্ছিক প্রদর্শন নাম, একটি ঐচ্ছিক সময় (ts, ISO 8601) এবং এর পয়েন্টগুলো থাকে। প্রতিটি পয়েন্টে একটি key, একটি value এবং আদর্শভাবে একটি unit ও একটি quantity থাকে। তৈরির স্ক্রিনে কপি করার মতো একটি সম্পূর্ণ উদাহরণ দেখানো হয়।

পয়েন্টের ফিল্ড

key

এই ডিভাইসে চ্যানেলের নাম, যেমন power বা energy_total। একই key সবসময় একই চ্যানেলে যায়।

value

একটি সংখ্যা।

unit

যেমন W, kWh, °C বা mm/s। Wh বা MWh-এ শক্তি kWh-এ, তাপমাত্রা °C-এ এবং কম্পনের বেগ mm/s-এ রূপান্তরিত হয়। Pa, hPa, kPa, mbar, psi, inH2O, inWC বা mmH2O-তে চাপ bar-এ রূপান্তরিত হয়। অন্য এককে একটি চ্যানেল দেখতে, FreeMaint-এ তার প্রদর্শনের একক বেছে নিন। চ্যানেল পৃষ্ঠায় “প্রাপ্ত একক”-এর নিচে সর্বশেষ রিডিংয়ের একক দেখানো হয়। মিলি ও মেগার ক্ষেত্রে বড় ও ছোট হাতের অক্ষর গুরুত্বপূর্ণ: mW ও mWh মানে মিলি, MW ও MWh মানে মেগা। BACnet এককের নামও বড় বা ছোট হাতের অক্ষরে গ্রহণযোগ্য: “PASCALS”, “inches-of-water”, “kilowatt-hours”…

quantity

কী পরিমাপ করা হচ্ছে, যেমন power, energy, temperature বা vibration_velocity। এর মাধ্যমে FreeMaint সঠিক একক ও গ্রাফ বেছে নেয়।

kind

শুধু ঊর্ধ্বমুখী কাউন্টারের জন্য CUMULATIVE (মোট শক্তি, চালনার ঘণ্টা)। তখন FreeMaint রিডিংগুলোর মধ্যকার ব্যবহার হিসাব করে। সাধারণ পরিমাপ করা মানের ক্ষেত্রে এটি বাদ দিন।

সীমা

প্রতি রিকোয়েস্টে সর্বোচ্চ 500টি ডিভাইস ও 5,000টি পয়েন্ট।
প্রতি সংযোগে প্রতি মিনিটে সর্বোচ্চ 120টি রিকোয়েস্ট; এর বেশি হলে FreeMaint 429 উত্তর দেয় এবং আপনার সিস্টেমকে পরে আবার চেষ্টা করতে হবে।
ভুল গঠনের রিকোয়েস্ট সমস্যার নামসহ একটি 400 উত্তর পায়, তাই ভুলভাবে কনফিগার করা গেটওয়ে সহজেই ঠিক করা যায়।
প্রতিটি নতুন চ্যানেল আপনার প্ল্যানের সক্রিয় চ্যানেলের সীমায় গণনা হয়।

টিপ

সাধারণ সেটআপ: একটি Node-RED ফ্লো যা প্রতি মিনিটে একটি Modbus শক্তি মিটার পড়ে তার মান পোস্ট করে; একটি Home Assistant অটোমেশন যা একটি সেন্সরের মান ফরোয়ার্ড করে; একটি Teltonika রাউটার যার Data to Server ফিচার রিডিং পোস্ট করে।

সতর্কতা

অ্যাক্সেস কী গোপন রাখুন: যার কাছে এটি আছে সে-ই এই সংযোগে ডেটা পাঠাতে পারে। এটি ফাঁস হয়ে থাকতে পারে মনে হলে একটি নতুন কী তৈরি করুন এবং “এখনই বাতিল করুন” বেছে নিন।