دليل مستخدم برنامج DELTA HTTP API
شعار برنامج ساعي البريد

مقدمة

UNOnext عبارة عن أجهزة استشعار متعددة الوظائف. يوفر درجة الحرارة (درجة مئوية/درجة فهرنهايت)، الرطوبة (rH%)، الضوء المحيط (لوكس)، ثاني أكسيد الكربون (جزء في المليون)، PM2 (ميكروجرام/م2.5)، PM3 (ميكروجرام/م10). يوفر النموذج المتقدم اختياريًا TVOC (ppb)، HCHO (جزء في البليون)، CO (جزء في المليون)، وO3 (جزء في البليون). يقدم هذا المستند استخدام UNOweb HTTP API لاسترداد بيانات المستشعر الخاصة بـ UNOnext بناءً على تنسيق JSON. بالإضافة إلى ذلك، UNOweb يوفر HTTP API أيضًا بيانات المتوسط ​​المتحرك للمستشعر بناءً على لوائح تايوان. كثافة البيانات هي سجل واحد لكل 1 دقائق عندما يكون UNOnext متصلاً بالإنترنت.
ملحوظة. أونوweb يدعم HTTP API فقط UNOnext الذي تم بالفعل ضبط WiFi ومتصل بـ UNOweb.

الجدول 1: جدول الاستشعار

نوع المستشعر مفتاح وحدة البيانات
درجة حرارة درجة حرارة °C
درجة حرارة NTC (اختياري) مركز التحكم الوطني °C
درجة حرارة °F TEMP_F °F
درجة حرارة إن تي سي °ف (اختياري) NTC_F °F
رطوبة HUMI rH٪
الإضاءة المحيطة لوكس لوكس
ثاني أكسيد الكربون ثاني أكسيد الكربون جزء في المليون
ب م 2.5 PM2p5 جلج/م3
ب م 10 ب م 10 جلج/م3
TVOC (اختياري) TVOC جزء في البليون
HCHO (اختياري) صنع جزء في البليون
شارك.) CO جزء في المليون
O3 (اختياري) O3 جزء في البليون

 

الجدول 2: بيانات المتوسط ​​المتحرك لجهاز الاستشعار

نوع المستشعر مفتاح وحدة البيانات وصف القاعدة
ثاني أكسيد الكربون CO2_ma جزء في المليون 8 ساعات
ب م 2.5 PM2p5_ma جلج/م3 24 ساعات
ب م 10 PM10_ma جلج/م3 24 ساعات
TVOC (اختياري) TVOC_ma جزء في البليون 1 ساعات
HCHO (اختياري) HCHO_ma جزء في البليون 1 ساعات
شارك.) غيبوبة جزء في المليون 8 ساعات
O3 (اختياري) O3_ma جزء في البليون 8 ساعات

ملاحظة: إذا كانت قيمة المستشعر "خالية" يتم تقديمها غير مثبتة أو أن البيانات غير متوفرة.

دليل API

متطلبات
  • أونوweb حساب بإذن API المميز.
  • رقم SN الخاص بـ UNOnext عبر الإنترنت.
  • قم بإعداد عميل HTTP API. على سبيل المثال ساعي البريد (https://www.postman.com/) ، reqBin (https://reqbin.com/)

لقطة شاشة ساعي البريد
الشكل 1: لقطة شاشة ساعي البريد

واجهة برمجة التطبيقات

UNO الحاليweb يوفر واجهة برمجة تطبيقات HTTP التالية لـ UNOnext. https://isdweb.deltaww.com/api/getUnoNextPeriod

الجدول 3 احصل على استخدام Uno في الفترة التالية

واجهة برمجة التطبيقات بروتوكول وصف
getUnoNextPeriod بريد احصل على بيانات UNOnext بناءً على بيانات المتوسط ​​المتحرك.
التفويض: الرمز المميز لحامله (في رأس طلب HTTP)
رمز المستخدم: كل شكل المستخدم لديه رمز مميز. الطول 32.

 

حامل ههههههههههههههههههههههههههههههه

حامل مثلا
نص المشاركة (تنسيق JSON)
{

"الSN": "2040N00F0116"،

"الاستشعار": لا شيء،

"rtData": []،

"تنسيق البيانات": "الإملاء"،

"tsRange": خالي

}

وصف مفتاح JSON

مفتاح وصف
sn SN ينتمي إلى UNOnext.
جهاز استشعار متوسط ​​التحرك بيانات مجموعة سلسلة الاستشعار. باطل يعني جميع أجهزة الاستشعار. مصفوفة فارغة [] يعني عدم وجود متوسط ​​متحرك مهتم. بيانات.
rtData البيانات في الوقت الحقيقي لمجموعة سلسلة الاستشعار. باطل يعني عدم وجود بيانات مهتمة في الوقت الحقيقي. مصفوفة فارغة [] يعني جميع بيانات الاستشعار.
تنسيق البيانات قبول "الإملاء"، "csv"، "json". استخدم "dict" في معظم الحالات.
tsRange عصر الوقت شamp مجموعة مصفوفة. [البداية والنهاية] – [1613633000، 1613633201] باطل يعني آخر البيانات في 1 ساعة. عصر السابقينampعلى: https://www.epochconverter.com/
الاستجابة (التطبيق/json) 
{
"النتيجة": "SUC"،
"الحمولة": {
"الأعمدة": [
"وقت"،
"درجة حرارة"،
"هومي"،
"لوكس"،
"إن تي سي"،
"تفوك"،
"HCHO"،
"ثاني أكسيد الكربون"،
"ثاني أكسيد الكربون"،
"O3"،
"PM2p5"،
"بي إم 10"،
"TEMP_F"،
"NTC_F"
],
"بيانات": [
[
1619425800,
23.2,
67.57,
282,
باطل،
30000,
42,
0,
920,
0,
2,
1,
73.76,
باطل
] ] }،
"العدد الخام": 1،
"العد": 1
}

وصف مفتاح JSON

مفتاح وصف
نتيجة

"SUC" هو ناجح.

يتم إرجاع "FAIL" و"ERR" مع رسالة خطأ.

payload.columns

تم تقديم المصفوفة المستجيبة لعمود الاستشعار. "الوقت" هو عصر الحادي والعشرينamp. ويمكن الاطلاع على غيرها في الجدول 1 والجدول 2

payload.data تم الرد على مجموعة البيانات المتداخلة، كل عنصر عبارة عن صفيف من أعمدة الاستشعار المقابلة. باطل يعني عدم وجود بيانات في هذا الوقت شampأو غير مثبت أو مستشعر غير طبيعي.
عدد

إذا كانت "النتيجة" هي "SUC"، فإن "العدد" يعرض طول البيانات الصالحة (وليس كلها باطل البيانات) مصفوفة.

RawCount

إذا كانت "النتيجة" هي "SUC"، فإن "العدد" يعرض طول البيانات (تحتوي على الكل باطل البيانات) مصفوفة.

 

 

المستندات / الموارد

برنامج دلتا HTTP API [بي دي اف] دليل المستخدم
برنامج HTTP API، برنامج HTTP API، برنامج

مراجع

اترك تعليقا

لن يتم نشر عنوان بريدك الإلكتروني. تم وضع علامة على الحقول المطلوبة *