نمای یکپارچه
GET
/api/v1/channel_data فهرستی از قرائتهای گره اندازهگیری (metering unit) را به تفکیک نوع آرشیو و بازهٔ زمانی تأمینکنندهٔ منابع، به شکل یکپارچه بازمیگرداند.
پارامترهای پرسوجو
archive_type string نوع آرشیوی که دادههای آن دریافت میشود. فهرست انواع آرشیو در جدول «مرجع انواع آرشیو» آمده است.
equipment_id integer شناسهٔ دستگاه اندازهگیریای که دادههای آن دریافت میشود.
fp_start string بازهٔ زمانی (آغاز بازه) با قالب yyyy-mm-dd که دادههای آن دریافت میشود.
fp_end string بازهٔ زمانی (پایان بازه) با قالب yyyy-mm-dd که دادههای آن دریافت میشود.
page integer شمارهٔ صفحه.
channel_consolidation integer مقدار آن را برابر 1 قرار دهید تا پارامتر، در صورت وجود، به شکل یکپارچه دریافت شود.
فیلدهای پاسخ
| ویژگی | توضیح |
|---|---|
event_time | تاریخ و زمان قرائتهای کنتور با قالب UTC |
channel_data | دادههای آرشیو. نامهای یکپارچهٔ کانالها: gas_consume — حجم استاندارد گاز در بازه، reading_value — حجم استاندارد انباشتهٔ گاز، VNakwork — حجم کاری انباشتهٔ گاز، Vwork — حجم کاری گاز، P — فشار، T — دما |
data | آرایهای از دادههای بازگرداندهشده |
total_pages | تعداد کل صفحهها در مجموعهٔ بازگرداندهشده |
current_page | صفحهٔ جاری |
next_page | صفحهٔ بعدی که برای بارگیری در دسترس است؛ اگر صفحهٔ جاری آخرین صفحه باشد، null |
درخواست
bash
curl -i \
--header "access-token: *********************" \
--header "token-type: Bearer" \
--header "client: **********************" \
--header "uid: api-user@example.com" \
--header "Content-Type: application/json" \
--request GET \
"https://api.vadsro.eu/api/v1/channel_data?archive_type=hourly&equipment_id=25&fp_end=2021-02-20&fp_start=2021-02-01&page=2&channel_consolidation=1"js
const res = await fetch(
'https://api.vadsro.eu/api/v1/channel_data?archive_type=hourly&equipment_id=25&fp_end=2021-02-20&fp_start=2021-02-01&page=2&channel_consolidation=1',
{
headers: {
'access-token': '*********************',
'token-type': 'Bearer',
client: '**********************',
uid: 'api-user@example.com',
'Content-Type': 'application/json',
},
},
);
const data = await res.json();python
import requests
res = requests.get(
"https://api.vadsro.eu/api/v1/channel_data",
params={
"archive_type": "hourly",
"equipment_id": 25,
"fp_end": "2021-02-20",
"fp_start": "2021-02-01",
"page": 2,
"channel_consolidation": 1,
},
headers={
"access-token": "*********************",
"token-type": "Bearer",
"client": "**********************",
"uid": "api-user@example.com",
"Content-Type": "application/json",
},
)
data = res.json()go
req, _ := http.NewRequest("GET", "https://api.vadsro.eu/api/v1/channel_data?archive_type=hourly&equipment_id=25&fp_end=2021-02-20&fp_start=2021-02-01&page=2&channel_consolidation=1", nil)
req.Header.Set("access-token", "*********************")
req.Header.Set("token-type", "Bearer")
req.Header.Set("client", "**********************")
req.Header.Set("uid", "api-user@example.com")
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)php
$ch = curl_init("https://api.vadsro.eu/api/v1/channel_data?archive_type=hourly&equipment_id=25&fp_end=2021-02-20&fp_start=2021-02-01&page=2&channel_consolidation=1");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"access-token: *********************",
"token-type: Bearer",
"client: **********************",
"uid: api-user@example.com",
"Content-Type: application/json",
]);
$data = json_decode(curl_exec($ch), true);پاسخ
json
{
"data": [
{
"event_time": 1631791097,
"channel_data": [
{ "gas_consume": "503.2795" },
{ "reading_value": "671893.9226" },
{ "VNakwork": "15402.9101" },
{ "Vwork": "15398" },
{ "P": "1.4" },
{ "T": "20" }
]
}
],
"total_pages": 1,
"current_page": 1,
"next_page": null
} آخرین بهروزرسانی در
آیا این صفحه مفید بود؟
از بازخورد شما سپاسگزاریم!