DELTA HTTP API Proqram Təlimatı İstifadəçi Təlimatı

DELTA HTTP API Proqram Təlimatı İstifadəçi Təlimatı

İçindəkilər gizlətmək

3 Sənədlər / Resurslar

3.1 İstinadlar

4 Əlaqədar Yazılar

Giriş

UNOnext çox funksiyalı sensorlardır. O, Temperatur (°C/°F), Rütubət (rH%), Ətraf İşığı (lüks), CO2 (ppm), PM2.5 (μg/m3), PM10 (μg/m3) təmin edir. Qabaqcıl model isteğe bağlı olaraq TVOC təmin edir. (ppb), HCHO (ppb), CO (ppm) və O3 (ppb). Bu sənəd UNO-dan istifadəni təqdim edirweb JSON formatına əsaslanan UNOnext-in sensor məlumatlarını əldə etmək üçün HTTP API. Bundan əlavə, UNOweb HTTP API həmçinin Tayvan tənzimləməsi əsasında sensorun hərəkətli orta məlumatlarını təmin edir. UNOnext onlayn olduqda məlumat sıxlığı 1 dəqiqədə 6 qeyddir.
Qeyd. UNOweb HTTP API yalnız WiFi quraşdırılmış və UNO-ya qoşulmuş UNOnext-i dəstəkləyirweb.

Cədvəl 1 Sensor Cədvəli

Sensor növü	Açar	Məlumat vahidi
Temperatur	TEMP	^°C
NTC Temperaturu (option.)	NTC	^°C
Temperatur ^°F	TEMP_F	^°F
NTC temperaturu ^°F (seçim)	NTC_F	^°F
Rütubət	HUMİ	rH%
Ətraf İşığı	LUX	lüks
CO2	CO2	ppm
PM2.5	PM2p5	jLg/m³
PM10	PM10	jLg/m³
TVOC (seçim)	TVOC	ppb
HCHO (seçim)	HCHO	ppb
CO (seçim)	CO	ppm
O3 (seçim)	O3	ppb

Cədvəl 2 Sensor Hərəkət edən Orta Məlumat

Sensor növü	Açar	Məlumat vahidi	Qayda təsviri
CO2	CO2_ma	ppm	8 saat
PM2.5	PM2p5_ma	jLg/m³	24 saat
PM10	PM10_ma	jLg/m³	24 saat
TVOC (seçim)	TVOC_ma	ppb	1 saat
HCHO (seçim)	HCHO_ma	ppb	1 saat
CO (seçim)	CO_ma	ppm	8 saat
O3 (seçim)	O3_ma	ppb	8 saat

PS. Sensorun dəyəri “null” olarsa, quraşdırılmamış və ya məlumat mövcud deyildir.

API təlimatı

Tələb

UNOweb token API icazəsi ilə hesab.
Onlayn UNOnext-in SN.
HTTP API müştəri hazırlayın. Məs poçtalyon (https://www.postman.com, reqBin (https://reqbin.com/)

Şəkil 1 Poçtalyon ekran görüntüsü

API

Hazırkı UNOweb üçün aşağıdakı HTTP API təmin edir UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod

Cədvəl 3 Uno Növbəti Dövr İstifadəsini əldə edir

API	Protokol	Təsvir
getUnoNextPeriod	POST	Hərəkətli orta məlumatlara əsaslanan UNOnext məlumatlarını əldə edin.
İcazə: Daşıyıcı Token (HTTP Sorğu Başlığında)
İstifadəçi nişanı: Hər biri Format	istifadəçinin unikal nişanı var. Uzunluğu 32. Daşıyan xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Daşıyıcı Məs

Post Bədii (JSON Format)
{ “sn”: “2040N00F0116”, "sensor": null, “rtData”: [], “dataFormat”: “dict”, “tsRange”: null } JSON Açar Təsviri
Açar	Təsvir
sn	UNOnext-ə aid olan SN.
sensor	Hərəkətli orta. sensor sətir massivinin məlumatları. *null* bütün sensor deməkdir. Boş massiv [] maraqlı hərəkətli ortanın olmaması deməkdir. data.
rtData	Sensor sətir massivinin real vaxt məlumatları. *null* maraqlı real vaxt məlumatının olmaması deməkdir. Boş massiv [] bütün sensor məlumatları deməkdir.
məlumat formatı	“dict”,”csv”,”json” qəbul edin. Əksər hallarda “dict” istifadə edin.
tsRange	Dövr vaxtı stamp massiv. [başlanğıc, son] – [1613633000, 1613633201] *null* 1 saat ərzində son məlumat deməkdir. Epoch Example: https://www.epochconverter.com/

Cavab (tətbiq/json)

{
"nəticə": "SUC",
"faydalı yük": {
"sütunlar": [
“zaman”,
“TEMP”,
"HUMİ",
"LUX",
"NTC",
"TVOC",
"HCHO",
“CO”,
“CO2”,
"O3",
“PM2p5”,
“PM10”,
“TEMP_F”,
"NTC_F"
],
"məlumatlar": [
[
1619425800,
23.2,
67.57,
282,
null,
30000,
42,
0,
920,
0,
2,
1,
73.76,
null
] ] },
“rawCount”: 1,
"saymaq": 1
}

JSON Açar Təsviri

Açar	Təsvir
nəticə	"SUC" dir UĞURLU. “FAIL” və “ERR” səhv mesajı ilə qaytarılır.
faydalı yük.sütunlar	Cavab verilmiş massiv sensor sütununu təqdim edir. “zaman” epoxa stamp. Digərləri Cədvəl 1 və Cədvəl 2-də tapıla bilər
payload.data	Cavab verilmiş daxili məlumat massivi, hər bir element sensor sütunlarına uyğundur. null bu anda heç bir məlumat yoxdur stamp, sökülməmiş və ya sensor anormal.
saymaq	Əgər “nəticə” “SUC” olarsa, “say” etibarlı məlumatların uzunluğunu təqdim edir (hamısı deyil null data) massivi.
rawCount	Əgər “nəticə” “SUC” olarsa, “say” verilənlərin uzunluğunu təqdim edir (hamısı var null data) massivi.