HTTP API ဖြင့် တိုင်းတာချက်များ ပို့ခြင်း
Node-RED, Home Assistant, PLC ဂိတ်ဝေး သို့မဟုတ် ကိုယ်ပိုင်စခရစ်မှ FreeMaint Connect သို့ JSON ပို့နည်း- ဖော်မတ်၊ header၊ ယူနစ်နှင့် ကန့်သတ်ချက်။
JSON body ပါသော HTTP request ပို့နိုင်သည့် မည်သည့်စနစ်မဆို FreeMaint Connect သို့ ဒေတာ ပေးပို့နိုင်သည်- Node-RED, Home Assistant, Modbus ဖတ်သော ဂိတ်ဝေး၊ PLC သို့မဟုတ် သင့်ကိုယ်ပိုင် စခရစ်။ ၎င်း၏ URL နှင့် ဝင်ရောက်ခွင့် ကီးကို ရရန် HTTP API (Node-RED, စခရစ်…) အမျိုးအစား ချိတ်ဆက်မှုတစ်ခု ဖန်တီးပါ။
Request
- Method- POST၊ ချိတ်ဆက်မှု ဖန်တီးစဉ် ပြသသော URL သို့ (၎င်းသည် /connect/ingest/generic ဖြင့် အဆုံးသတ်သည်)။
- Header Authorization: Bearer ပြီးနောက် ဝင်ရောက်ခွင့် ကီး။
- Content-Type: application/json header ကို ထည့်ပါ။
- ဒေတာကို လက်ခံပါက FreeMaint က 202 ဖြင့် တုံ့ပြန်ပြီး စက္ကန့်ပိုင်းအတွင်း သိမ်းဆည်းသည်။
Body
Body တွင် items အောက်၌ စက်ပစ္စည်းများကို စာရင်းပြုစုသည်။ စက်ပစ္စည်းတစ်ခုစီတွင် identifier (device)၊ ရွေးချယ်နိုင်သော ပြသအမည်၊ ရွေးချယ်နိုင်သော အချိန် (ts, ISO 8601) နှင့် ၎င်း၏ point များ ပါရှိသည်။ Point တစ်ခုစီတွင် key တစ်ခု၊ value တစ်ခုနှင့် ဖြစ်နိုင်လျှင် unit နှင့် quantity ပါရှိသည်။ ဖန်တီးသည့် မျက်နှာပြင်တွင် ကူးယူနိုင်သော ဥပမာ အပြည့်အစုံကို ပြသထားသည်။
Point အကွက်များ
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 က ဖတ်ချက်များကြား သုံးစွဲမှုကို တွက်ချက်သည်။ ရိုးရိုး တိုင်းတာတန်ဖိုးအတွက် ချန်လှပ်ထားပါ။
ကန့်သတ်ချက်များ
- Request တစ်ခုလျှင် စက်ပစ္စည်း 500 ခုနှင့် point 5,000 ခုအထိ။
- ချိတ်ဆက်မှုတစ်ခုလျှင် တစ်မိနစ်ကို request 120 ခုအထိ၊ ကျော်လွန်ပါက FreeMaint က 429 ဖြင့် တုံ့ပြန်ပြီး သင့်စနစ်က နောက်မှ ပြန်ကြိုးစားသင့်သည်။
- ပုံစံမမှန်သော request သည် ပြဿနာကို ဖော်ပြသည့် 400 တုံ့ပြန်ချက် ရရှိသဖြင့် မှားယွင်းစွာ သတ်မှတ်ထားသော ဂိတ်ဝေးကို လွယ်ကူစွာ ပြင်နိုင်သည်။
- ချန်နယ်အသစ်တိုင်းကို သင့်အစီအစဉ်၏ အသုံးပြုနေသော ချန်နယ် ကန့်သတ်ချက်ထဲ ရေတွက်သည်။
အကြံပြုချက်
သတိပေးချက်
ဆက်စပ် ဆောင်းပါးများ
ဤစာမျက်နှာသည် အသုံးဝင်ပါသလား။