DELTA HTTP API سافٽ ويئر يوزر مينوئل

DELTA HTTP API سافٽ ويئر يوزر مينوئل

مواد لڪائڻ

تعارف

UNOnext هڪ ملٽي فنڪشنل سينسر آهي. اهو درجه حرارت (°C/°F)، نمي (rH٪)، ايمبيئنٽ لائيٽ (lux)، CO2 (ppm)، PM2.5 (μg/m3)، PM10 (μg/m3) مهيا ڪري ٿو. اڳواٽ ماڊل اختياري طور TVOC مهيا ڪري ٿو. (ppb)، HCHO (ppb)، CO (ppm)، ۽ O3 (ppb). هي دستاويز UNO استعمال ڪندي متعارف ڪرايو آهيweb JSON فارميٽ جي بنياد تي UNOnext جي سينسر ڊيٽا کي ٻيهر حاصل ڪرڻ لاءِ HTTP API. ان کان علاوه، UNOweb HTTP API تائيوان جي ضابطي جي بنياد تي سينسر جي هلندڙ اوسط ڊيٽا پڻ مهيا ڪري ٿي. ڊيٽا جي کثافت آهي 1 رڪارڊ في 6 منٽ جڏهن UNO اڳيون آن لائن آهي.
نوٽ. UNOweb HTTP API صرف UNOnext کي سپورٽ ڪري ٿو جيڪو اڳ ۾ ئي سيٽ ڪيل وائي فائي ۽ UNO سان ڳنڍيل آهيweb.

ٽيبل 1 سينسر ٽيبل

سينسر جو قسم	چاٻي	ڊيٽا يونٽ
گرمي پد	TEMP	^°C
NTC گرمي پد (آپٽ.)	اين ٽي سي	^°C
گرمي پد ^°F	TEMP_F	^°F
NTC درجه حرارت ^°F (اختيار)	NTC_F	^°F
نمي	هومي	rH%
محيطي روشني	LUX	lux
CO2	CO2	پي پي ايم
پي ايم 2.5	PM2p5	jLg/m³
پي ايم 10	پي ايم 10	jLg/m³
TVOC (اختيار)	ٽي وي او سي	پي پي بي
HCHO (اختياري)	ايچ او	پي پي بي
CO (آپٽ.)	CO	پي پي ايم
O3 (اختيار)	O3	پي پي بي

ٽيبل 2 سينسر حرڪت وارو اوسط ڊيٽا

سينسر جو قسم	چاٻي	ڊيٽا يونٽ	ضابطي جي وضاحت
CO2	CO2_ma	پي پي ايم	8 ڪلاڪ
پي ايم 2.5	PM2p5_ma	jLg/m³	24 ڪلاڪ
پي ايم 10	PM10_ma	jLg/m³	24 ڪلاڪ
TVOC (اختيار)	TVOC_ma	پي پي بي	1 ڪلاڪ
HCHO (اختياري)	HCHO_ma	پي پي بي	1 ڪلاڪ
CO (آپٽ.)	CO_ma	پي پي ايم	8 ڪلاڪ
O3 (اختيار)	O3_ma	پي پي بي	8 ڪلاڪ

پي ايس. جيڪڏهن سينسر جو قدر آهي "نال" پيش ڪيل غير نصب ٿيل يا ڊيٽا دستياب ناهي.

API دستياب

گهرج

UNOweb ٽوڪن API جي اجازت سان اڪائونٽ.
هڪ آن لائين UNOnext جي SN.
هڪ HTTP API ڪلائنٽ تيار ڪريو. مثال پوسٽمن (https://www.postman.com/) reqBin (https://reqbin.com/)

تصوير 1 پوسٽمن اسڪرين شاٽ

API

موجوده UNOweb هيٺ ڏنل HTTP API مهيا ڪري ٿو UNO اڳيون. https://isdweb.deltaww.com/api/getUnoNextPeriod

جدول 3 حاصل ڪريو Uno ايندڙ دور جي استعمال

API	پروٽوڪول	وصف
getUnoNextPeriod	پوسٽ	ھلندڙ اوسط ڊيٽا جي بنياد تي UNO اڳيون ڊيٽا حاصل ڪريو.
اختيار ڏيڻ: بيئرر ٽوڪن (HTTP درخواست هيڊر ۾)
استعمال ڪندڙ ٽوڪن: هر فارميٽ	استعمال ڪندڙ کي هڪ منفرد ٽوڪن آهي. ڊگھائي 32 آھي. بيئرر xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
کڻندڙ مثال

پوسٽ باڊي (JSON فارميٽ)
{ "sn": "2040N00F0116", "سينسر": null, "rtData": [], "ڊيٽا فارميٽ": "ڊڪٽ"، "tsRange": null } JSON اهم وضاحت
چاٻي	وصف
sn	SN جو تعلق UNOnext سان.
سينسر	هلندڙ اوسط. sensor string array جي ڊيٽا. *null* مطلب سڀ سينسر. خالي صف [] مطلب ته حرڪت ۾ دلچسپي نه آهي اوسط. ڊيٽا.
rtData	sensor string array جي حقيقي وقت ڊيٽا. *null* مطلب ته حقيقي وقت جي ڊيٽا ۾ دلچسپي نه آهي. خالي صف [] مطلب ته سڀ سينسر ڊيٽا.
ڊيٽا فارميٽ	قبول ڪريو "ڊڪٽ"، "csv"، "json". اڪثر ڪيسن لاءِ ”ڊڪٽ“ استعمال ڪريو.
حد	Epoch time stamp صف. [شروع، پڄاڻي] - [1613633000، 1613633201] *null* مطلب 1 ڪلاڪ ۾ آخري ڊيٽا. Epoch Exampاليزي: https://www.epochconverter.com/

جواب (ايپليڪيشن/json)

{
"نتيجو": "SUC",
"پيلوڊ": {
"ڪالمن": [
"وقت"،
"TEMP"،
”هومي“،
"LUX"،
"NTC"،
"TVOC"،
"HCHO"،
"CO"،
"CO2",
"O3",
"PM2p5",
"PM10"،
"TEMP_F",
"NTC_F"
],
"ڊيٽا": [
[
1619425800،
23.2،
67.57،
282،
خالي،
30000،
42،
0,
920،
0,
2,
1,
73.76،
null
]] }،
"را ڳڻپ": 1،
"ڳڻپ": 1
}

JSON اهم وضاحت

چاٻي	وصف
نتيجو	"SUC" آهي ڪامياب. "FAIL" ۽ "ERR" غلطي پيغام سان واپسي آھن.
payload.columns	جوابي صف پيش ڪيل سينسر ڪالمن. "وقت" epoch st آهيamp. ٻيا ڳولهي سگهجن ٿا جدول 1 ۽ ٽيبل 2 ۾
payload.data	جواب ڏنو nested ڊيٽا صف، هر شئي صف سان لاڳاپيل سينسر ڪالمن آهي. null مطلب ته هن وقت ڪوبه ڊيٽا ناهيamp, unmounted يا سينسر غير معمولي.
شمار	جيڪڏهن "نتيجو" "SUC" آهي، "ڳڻپ" صحيح ڊيٽا جي ڊيگهه پيش ڪري ٿو (سڀ نه null ڊيٽا) صف.
خام شمار	جيڪڏهن "نتيجو" "SUC" آهي، "ڳڻپ" ڊيٽا جي ڊيگهه پيش ڪري ٿو (سڀ تي مشتمل آهي null ڊيٽا) صف.