คู่มือผู้ใช้ซอฟต์แวร์ DELTA HTTP API
การแนะนำ
UNonext เป็นเซนเซอร์แบบมัลติฟังก์ชั่น ให้อุณหภูมิ (°C/°F), ความชื้น (rH%), แสงแวดล้อม (ลักซ์), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3) รุ่นขั้นสูงสามารถเลือกให้ TVOC (ppb), HCHO (ppb), CO (ppm) และ O3 (ppb) เอกสารนี้แนะนำการใช้ UNOweb HTTP API เพื่อดึงข้อมูลเซ็นเซอร์ของ UNNext ตามรูปแบบ JSON นอกจากนี้ UNOweb HTTP API ยังให้ข้อมูลค่าเฉลี่ยเคลื่อนที่ของเซ็นเซอร์ตามระเบียบของไต้หวัน ความหนาแน่นของข้อมูลคือ 1 บันทึกต่อ 6 นาทีเมื่อ UNNext ออนไลน์
บันทึก. ยูเอ็นโอweb HTTP API รองรับเฉพาะ UNOext ซึ่งตั้งค่า WiFi และเชื่อมต่อกับ UNO ไว้แล้วweb.
ตารางที่ 1 ตารางเซนเซอร์
| ประเภทเซนเซอร์ | สำคัญ | หน่วยข้อมูล |
| อุณหภูมิ | อุณหภูมิ | °C |
| อุณหภูมิ กทช. (ตัวเลือก) | กทช. | °C |
| อุณหภูมิ °F | อุณหภูมิ_F | °F |
| กทช.อุณหภูมิ °F (ตัวเลือก) | กทช_ฉ | °F |
| ความชื้น | ฮูมิ | RH% |
| แสงโดยรอบ | ลักซ์ | ลักซ์ |
| CO2 | CO2 | หน่วยต่อนาที |
| พีเอ็ม2.5 | PM2p5 | jLg/ม3 |
| พีเอ็ม10 | พีเอ็ม10 | jLg/ม3 |
| TVOC (ทางเลือก) | ทีวีโอซี | พีพีบี |
| HCHO (ตัวเลือก) | เอช.ซี.โอ | พีพีบี |
| CO (ตัวเลือก) | CO | หน่วยต่อนาที |
| O3 (ตัวเลือก) | O3 | พีพีบี |
ตารางที่ 2 ข้อมูลค่าเฉลี่ยเคลื่อนที่ของเซ็นเซอร์
| ประเภทเซนเซอร์ | สำคัญ | หน่วยข้อมูล | คำอธิบายกฎ |
| CO2 | CO2_ma | หน่วยต่อนาที | 8 ชั่วโมง |
| พีเอ็ม2.5 | PM2p5_ma | jLg/ม3 | 24 ชั่วโมง |
| พีเอ็ม10 | PM10_ma | jLg/ม3 | 24 ชั่วโมง |
| TVOC (ทางเลือก) | TVOC_ma | พีพีบี | 1 ชั่วโมง |
| HCHO (ตัวเลือก) | HCHO_ma | พีพีบี | 1 ชั่วโมง |
| CO (ตัวเลือก) | CO_มา | หน่วยต่อนาที | 8 ชั่วโมง |
| O3 (ตัวเลือก) | O3_มะ | พีพีบี | 8 ชั่วโมง |
ป.ล. หากค่าของเซ็นเซอร์เป็น "null" แสดงว่าไม่ได้ต่อเชื่อมหรือไม่มีข้อมูล
คู่มือ API
ความต้องการ
- อูโน่web บัญชีที่ได้รับอนุญาตโทเค็น API
- SN ออนไลน์ของ UNNext
- เตรียมไคลเอนต์ HTTP API เช่น พนักงานส่งจดหมาย (https://www.postman.com- reqBin (https://reqbin.com/)
รูปที่ 1 ภาพหน้าจอบุรุษไปรษณีย์
เอพีไอ
UNO ปัจจุบันweb ให้ HTTP API ต่อไปนี้สำหรับ UNต่อไป. https://isdweb.deltaww.com/api/getUnoNextPeriod
ตารางที่ 3 รับการใช้งาน Uno งวดถัดไป
| เอพีไอ | โปรโตคอล | คำอธิบาย |
| getUnoNextPeriod | โพสต์ | รับข้อมูล UNonext ตามข้อมูลค่าเฉลี่ยเคลื่อนที่ |
| การอนุญาต: Bearer Token (ใน HTTP Request Header) | ||
| โทเค็นผู้ใช้: แต่ละรายการ รูปแบบ | ผู้ใช้มีโทเค็นเฉพาะ ความยาว 32
ผู้ถือ xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
|
| ผู้ถือ เช่น | ||
| เนื้อหาของโพสต์ (รูปแบบ JSON) | ||
| {
“sn”: “2040N00F0116”, “เซ็นเซอร์”: null, “rtData”: [], “รูปแบบข้อมูล”: “dict”, “tsRange”: null } คำอธิบายคีย์ JSON |
||
| สำคัญ | คำอธิบาย | |
| sn | SN ของ UNNext. | |
| เซ็นเซอร์ | ค่าเฉลี่ยเคลื่อนที่ ข้อมูลของอาร์เรย์สตริงเซนเซอร์ โมฆะ หมายถึงเซ็นเซอร์ทั้งหมด อาร์เรย์ว่างเปล่า [] หมายถึงไม่สนใจย้ายเฉลี่ย ข้อมูล. | |
| rtData | ข้อมูลเรียลไทม์ของอาร์เรย์สตริงเซนเซอร์ โมฆะ หมายถึงไม่มีข้อมูลเรียลไทม์ที่สนใจ อาร์เรย์ว่างเปล่า [] หมายถึงข้อมูลเซ็นเซอร์ทั้งหมด | |
| รูปแบบข้อมูล | ยอมรับ “dict”,”csv”,”json” ใช้ “dict” สำหรับกรณีส่วนใหญ่ | |
| ระยะ | ยุค เวลา เซนต์amp อาร์เรย์ [เริ่มต้น สิ้นสุด] – [1613633000, 1613633201] โมฆะ หมายถึงข้อมูลล่าสุดใน 1 ชั่วโมง ยุค เช่นampเลอ: https://www.epochconverter.com/ | |
| การตอบสนอง (แอปพลิเคชัน/json) | ||||||||||||
| { “ผลลัพธ์”: “SUC”, “เพย์โหลด”: { “คอลัมน์”: [ "เวลา", “อุณหภูมิ”, “ฮูมิ” “ลุกซ์”, “กทช.” “ทีวีโอซี” “เอชโช”, “ซีโอ” “คาร์บอนไดออกไซด์” “โอ3”, “PM2p5”, “PM10”, “อุณหภูมิ_F”, “กทค_ฉ” ], "ข้อมูล": [ [ 1619425800, 23.2, 67.57, 282, โมฆะ, 30000, 42, 0, 920, 0, 2, 1, 73.76, โมฆะ ] ] }, “จำนวนดิบ”: 1, “นับ”: 1 } คำอธิบายคีย์ JSON
|
เอกสาร / แหล่งข้อมูล
 |
ซอฟต์แวร์ DELTA HTTP API [พีดีเอฟ] คู่มือการใช้งาน ซอฟต์แวร์ HTTP API, HTTP API, ซอฟต์แวร์ |
