IAMMETER-cloud предоставя някои API и разработчикът може да използва тези API, за да извърши интересна работа, като например интегриране на данните на IAMMETER към система на трета страна. Току-що отворихме тези API за нашите бизнес партньори и някои големи клиенти преди, но решихме да ги отворим за всички наши клиенти сега.
Добре дошли да споделите с нас какво мислите в нашия форум.https://imeter.club
API не може да се посещава неограничено, ние ще ограничим дневния брой обаждания за всеки API. Моля, не се обаждайте на API по-често.
Ако броят на обажданията надвиши почасовото или дневното ограничение, API няма да върне нищо.
| Не. | API | тип ограничение | почасово | Ежедневно | описание |
|---|---|---|---|---|---|
| 1 | /потребителски вход | ip | 5 | 30 | само един IP може да извиква този api 5 пъти на час |
| 2 | /site/meterdata/ | SN | 12 | само един SN може да извиква този api 12 пъти на час | |
| 3 | /site/powerAnalysis | SN | 5 | само на един SN е позволено да извиква този api 5 пъти дневно | |
| 4 | /site/offlineAnalysis | SN | 5 | само на един SN е позволено да извиква този api 5 пъти дневно |
Върнете токена на акаунта. Токенът ще се използва в почти всички API.
Не е необходимо да извиквате този API, освен ако не искате да опресните токена.Моля, не се обаждайте на този API повече от 5 пъти за един час и не повече от 30 пъти за един ден.
Вземете токена на акаунта, който се използва във всички API.
URL:https://www.iammeter.com/api/v1/user/login
Метод:пост
| Не. | параметър | Забележка | пример |
|---|---|---|---|
| 1 | потребителско име | Потребителско име на IAMMETER | тест |
| 2 | парола | парола на IAMMETER | 123456 |
Стойността на токена ще се използва във всички API по-долу.
{
"данни": {
"id": 2025,
"токен": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"успешно": вярно,
"съобщение": нула
}Този токен може да бъде прочетен и директно след като влезете в системата.
Вземете последните данни за качване със съответния SN.
Моля, не извиквайте този API повече от 12 пъти за един час.
Основен (метрични данни): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Разширени (метрични данни 2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Метод: ВЗЕМЕТЕ
Лимит: моля, не изисквайте този API повече от 288 пъти всеки ден (интервал от 5 минути).
Разликата между основни и разширени:
Основен: без PF (фактор на мощността)
Разширено: с PF (фактор на мощността)
| Име | Тип | Пример | |
|---|---|---|---|
| Токен | низ | xxx | изисква се |
дефиниция на стойности: напрежение, ток, активна мощност, внесени Kwh, изнесени Kwh
{
"данни": {
"стойности": [
[
230.220,
1.300,
119 000,
1766.590,
0,000
]
],
"местно време": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"успешно": вярно,
"съобщение": нула
}дефиниция на стойности: напрежение, ток, активна мощност,фактор на мощността,внесени Kwh, изнесени Kwh
{
"данни":{
"стойности":[
[
233.41,
0,718,
111,
0,66,
5724.85,
0
]
],
"местно време":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"успешен": вярно,
"съобщение":нулево
}Трите масива встойностипредставляват фаза A, фаза B и фаза C.
Определение на елемента: напрежение, ток, активна мощност,фактор на мощността,внесени Kwh, изнесени Kwh
{
"данни": {
"стойности": [
[
242.600,
1000,
216 000,
32354.600,
0,000
],
[
242.600,
1000,
1986 000,
30536.410,
17704.720
],
[
0,000,
0,000,
0,000,
0,000,
0,000
]
],
"местно време": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"успешно": вярно,
"съобщение": нула
}{
"данни":{
"стойности":[
[//фаза А
233.8 // напрежение
0,03,//ток
4,//активна мощност
0,57 // фактор на мощността
222.53,//внесени Kwh
0 //изнесени Kwh
],
[//фаза Б
5,
0,
0,
0,
0,
0
],
[ //фаза C
3.1,
0,
0,
0,
0,
0
]
],
"местно време":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"успешен": вярно,
"съобщение":нулево
}
Връща историческите данни за зададения интервал и времеви диапазон.
Моменталните данни са в интервал от 1 минута. Има 60*24=1440 данни на ден. Ако поискате исторически данни в интервал от 1 минута, можете да поискате данни само за 1,39 (2000/1440) дни. Но ако поискате данните в интервал от 5 минути, можете да поискате данните от близо 7 дни.
Основен (метричен списък):https://www.iammeter.com/api/v1/site/meterdatalist/
**Разширени(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Разликата между основни и разширени:
Основен: без PF (фактор на мощността)
Разширено: с PF (фактор на мощността)
| Име | Тип | Пример | |
|---|---|---|---|
| Токен | низ | xxx | изисква се |
| интервал | номер | 300 | необходимо, единица: секунда |
| начален час | низ | 2023-09-01 | изисква се |
| крайно време | низ | 2023-09-07 | изисква се |
Данни: [напрежение, ток, мощност, внос на енергия, износ на енергия, UTC време, местно време]
{
"данни": [
[
227.73,
1,45,
172,
13121.56,
0,
"2023/9/12 0:00:34",
"2023/9/11 14:00:34"
],
[
229.43,
1,45,
172,
13121.56,
0,
"2023/9/12 0:01:33",
"2023/9/11 14:01:33"
]
],
"успешно": вярно,
"съобщение": нула
}{
"данни": [
[
230,//фаза А напрежение
0,//ток
0,//активна мощност
468.41,//внесени kWh
0,//изнесени kWh
230, // Фаза Б
0,
0,
236.58,
290.77,
230, // Фаза C
0,
0,
258.62,
0,
"2023/9/12 0:00:15",
"2023/9/11 16:00:15"
],
[
230,
0,
0,
468.41,
0,
230,
0,
0,
236.58,
290.77,
230,
0,
0,
258.62,
0,
"2023/9/12 0:02:08",
"2023/9/11 16:02:08"
]
],
"успешно": вярно,
"съобщение": нула
}{
"данни":[
{ //първи данни
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"стойности":[
[ //фаза А
235.2,//напрежение
0,03,//ток
4,//активна мощност
0,57 // фактор на мощността
210.21,//внос Kwh
0 //изнесени Kwh
],
[//фаза Б
5.5,
0,
0,
0,
0,
0
],
[ //фаза C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //втори данни
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"стойности":[
[
233.4,
0,03,
4,
0,57,
210.24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{ //трети данни
"rtcTime":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"стойности":[
[
235.6,
0,03,
4,
0,57,
210.27,
0
],
[
5.5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"успешен": вярно,
"съобщение":нулево
}
Върнете резултата от анализа на мощността в определеното време.
Моля, не се обаждайте на този API повече от 5 пъти за един ден.
URL адрес: https://www.iammeter.com/api/v1/site/powerAnalysis
Метод: получи
Лимит: Моля, не изисквайте този API за SN повече от 5 пъти всеки ден.
| Име | Тип | Пример | |
|---|---|---|---|
сн |
низ | xxx | изисква се |
начален час |
низ | 2023-09-01 | по желание |
крайно време |
низ | 2023-09-07 | по желание |
Забележка:
средно: средно отчитане на мощността през този времеви диапазон.
средно дневно време: средно дневно (8:00 сутринта-20:00 вечерта) отчитане на мощността през този времеви диапазон.
минимум: минимално отчитане на мощността през този времеви диапазон.
максимум: отчитане на максимална мощност през този времеви диапазон.
{
"данни": {
"начален час": "2023-09-01",
"крайно време": "2023-09-07",
"средно": 862.6,
"средно през деня": 836,9,
"минимум": 259.0,
"максимум": 3999.0
},
"успешно": вярно,
"съобщение": нула
}Връща резултата от анализа на мощността за последните 7 дни.
Върнете резултата от анализа на мощността за посочения ден
Върнете състоянието на прекъсване с разглеждания SN в определеното време.
Моля, не се обаждайте на този API повече от 5 пъти за един ден.
URL адрес：https://www.iammeter.com/api/v1/site/offlineAnalysis
Метод：Вземете
Лимит: Моля, не изисквайте този API за SN повече от 5 пъти всеки ден.
| Име | Тип | Пример | |
|---|---|---|---|
сн |
низ | xxxx | изисква се |
начален час |
низ | 2023-09-01 | по желание |
крайно време |
низ | 2023-09-07 | по желание |
интервал(единица:минута) |
Номер | 5 | по желание |
Забележка:
Има общо 10080 минути в този времеви диапазон.
Общото време офлайн е 906 минути в този времеви диапазон.
Офлайн интервалът, който е по-голям от 5 минути, е посочен в масива.
{
"данни": {
"начален час": "2023-09-05",
"крайно време": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"списък": [
{
"начален час": "2023/9/5 0:00:00",
"краен час": "2023/9/5 15:06:14",
"продължителност": 906
}
]
},
"успешно": вярно,
"съобщение": нула
}Връща резултата от офлайн анализа за посочения ден
API на WiFi измервателя на енергия
Използвайте трифазния електромер по начина, по който предпочитате
Еднофазен Wi-Fi измервател на енергия