IAMMETER-cloud udostępnia pewne interfejsy API, a programista może używać tych interfejsów API do wykonywania ciekawych prac, takich jak integrowanie danych IAMMETER z systemem innej firmy. Właśnie udostępniliśmy te interfejsy API naszym partnerom biznesowym i niektórym dużym klientom, ale teraz postanowiliśmy udostępnić je wszystkim naszym klientom.
Zapraszamy do podzielenia się z nami swoimi przemyśleniami na naszym forum.https://imeter.club
API nie można odwiedzać bez ograniczeń, ograniczymy dzienną liczbę połączeń dla każdego API. Proszę nie wywoływać częściej API.
Jeśli liczba połączeń przekroczy limit godzinowy lub dzienny, interfejs API nic nie zwróci.
| Nie. | API | typ limitu | cogodzinny | Codzienny | opis |
|---|---|---|---|---|---|
| 1 | /login użytkownika | ip | 5 | 30 | jeden adres IP może dzwonić do tego interfejsu API tylko 5 razy na godzinę |
| 2 | /site/dane licznika/ | SN | 12 | jeden SN może dzwonić do tego interfejsu API tylko 12 razy na godzinę | |
| 3 | /site/powerAnalytics | SN | 5 | jeden SN może dzwonić do tego interfejsu API tylko 5 razy dziennie | |
| 4 | /site/offlineAnaliza | SN | 5 | jeden SN może dzwonić do tego interfejsu API tylko 5 razy dziennie |
Zwróć token konta. Token będzie używany w prawie całym interfejsie API.
Nie musisz wywoływać tego interfejsu API, chyba że chcesz odświeżyć token.Proszę nie wywoływać tego API więcej niż 5 razy w ciągu godziny i nie więcej niż 30 razy w ciągu jednego dnia.
Uzyskaj token konta, który jest używany we wszystkich interfejsach API.
URL:https://www.iammeter.com/api/v1/user/login
Metoda:post
| Nie. | parametr | uwaga | przykład |
|---|---|---|---|
| 1 | nazwa użytkownika | Nazwa użytkownika IAMMETER | test |
| 2 | hasło | hasło IAMMETER | 123456 |
Wartość tokenu będzie używana we wszystkich poniższych interfejsach API.
{
„dane”: {
„id”: 2025,
„token”: „349dfxxxxxxac5169”,
„refreshToken”: „8adf75e5da10424985f3b83855133982”
},
„udany”: prawda,
„wiadomość”: null
}Token ten można odczytać także bezpośrednio po zalogowaniu się do systemu.
Uzyskaj ostatnie dane do przesłania za pomocą odpowiedniego numeru seryjnego.
Proszę nie wywoływać tego interfejsu API więcej niż 12 razy w ciągu godziny.
Podstawowe (dane licznika): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Zaawansowane (dane licznika2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
metoda: DOSTAWAĆ
Limit: proszę nie żądać tego API częściej niż 288 razy dziennie (odstęp 5 minut).
Różnica między podstawowym a zaawansowanym:
Podstawowy: bez PF (współczynnik mocy)
Zaawansowane: z PF (współczynnik mocy)
| Nazwa | Typ | Przykład | |
|---|---|---|---|
| Znak | Strunowy | xxx | wymagany |
definicja wartości: napięcie, prąd, moc czynna, importowana Kwh, eksportowana Kwh
{
„dane”: {
„wartości”: [
[
230.220,
1.300,
119.000,
1766.590,
0,000
]
],
„Czas lokalny”: „28.08.2020 r. 15:27:33”,
„gmtTime”: „2020/8/28, 5:27:33”
},
„udany”: prawda,
„wiadomość”: null
}definicja wartości: napięcie, prąd, moc czynna,współczynnik mocy,importowane Kwh, wyeksportowane Kwh
{
„dane”:{
„wartości”:[
[
233,41,
0,718,
111,
0,66,
5724,85,
0
]
],
„Czas lokalny”: „21.11.2023 14:30:22”,
„gmtTime”: „21.11.2023, 6:30:22”
},
„udany”: prawda,
„wiadomość”: null
}Trzy tablice wwartościreprezentują fazę A, fazę B i fazę C.
Definicja elementu: napięcie, prąd, moc czynna,współczynnik mocy,importowane Kwh, wyeksportowane Kwh
{
„dane”: {
„wartości”: [
[
242.600,
1.000,
216.000,
32354.600,
0,000
],
[
242.600,
1.000,
1986.000,
30536.410,
17704.720
],
[
0,000,
0,000,
0,000,
0,000,
0,000
]
],
„Czas lokalny”: „28.08.2020 15:30:48”,
„gmtTime”: „28.08.2020 r., 5:30:48”
},
„udany”: prawda,
„wiadomość”: null
}{
„dane”:{
„wartości”:[
[//faza A
233,8,//napięcie
0,03,//prąd
4,//moc czynna
0,57,//współczynnik mocy
222,53,//importowane Kwh
0 //eksportowane kWh
],
[//faza B
5,
0,
0,
0,
0,
0
],
[ //faza C
3.1,
0,
0,
0,
0,
0
]
],
„Czas lokalny”: „21.11.2023 14:39:36”,
„gmtTime”: „21.11.2023, 6:39:36”
},
„udany”: prawda,
„wiadomość”: null
}
Zwróć dane historyczne dotyczące ustawionego interwału i zakresu czasu.
Dane natychmiastowe są podawane w odstępie 1 minuty. Dziennie przypada 60*24=1440 danych. Jeśli zażądasz danych historycznych w odstępie 1 minuty, możesz zażądać tylko danych z 1,39 (2000/1440) dni. Ale jeśli poprosisz o dane w odstępie 5 minut, możesz zażądać danych przez prawie 7 dni.
Podstawowy(metratalista):https://www.iammeter.com/api/v1/site/meterdatalist/
**Zaawansowane(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
Różnica między podstawowym a zaawansowanym:
Podstawowy: bez PF (współczynnik mocy)
Zaawansowane: z PF (współczynnik mocy)
| Nazwa | Typ | Przykład | |
|---|---|---|---|
| Znak | Strunowy | xxx | wymagany |
| interwał | numer | 300 | wymagane, jednostka: sekunda |
| czas rozpoczęcia | strunowy | 2023-09-01 | wymagany |
| Koniec czasu | strunowy | 2023-09-07 | wymagany |
Dane: [napięcie, prąd, moc, energia importowana, energia eksportowana, czas UTC, czas lokalny]
{
„dane”: [
[
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”
]
],
„udany”: prawda,
„wiadomość”: null
}{
„dane”: [
[
230,//napięcie fazoweA
0,//prąd
0,//moc czynna
468,41,//zaimportowane kWh
0,//eksportowane kWh
230,//Faza B
0,
0,
236,58,
290,77,
230,//Faza 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”
]
],
„udany”: prawda,
„wiadomość”: null
}{
„dane”:[
{ //pierwsze dane
„rtcTime”: „2023/9/1 0:00:22”,
„gmtTime”: „2023/8/31 16:00:22”,
„wartości”:[
[ //faza A
235,2,//napięcie
0,03,//prąd
4,//moc czynna
0,57,//współczynnik mocy
210,21,//import Kwh
0 //eksportowane kWh
],
[//faza B
5,5,
0,
0,
0,
0,
0
],
[ //faza C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //drugie dane
„rtcTime”: „2023/9/1 8:00:49”,
„gmtTime”: „2023/9/1 0:00:49”,
„wartości”:[
[
233,4,
0,03,
4,
0,57,
210,24,
0
],
[
5,4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{ //trzecie dane
„rtcTime”: „2023/9/1 16:00:24”,
„gmtTime”: „2023/9/1 8:00:24”,
„wartości”:[
[
235,6,
0,03,
4,
0,57,
210,27,
0
],
[
5,5,
0,
0,
0,
0,
0
],
[
3,4,
0,
0,
0,
0,
0
]
]
}
],
„udany”: prawda,
„wiadomość”: null
}
Zwróć wynik analizy mocy w określonym czasie.
Proszę nie wywoływać tego interfejsu API więcej niż 5 razy w ciągu jednego dnia.
Adres URL:https://www.iammeter.com/api/v1/site/powerAnalytics
metoda: Dostawać
Limit: Proszę nie zamawiać tego API dla każdego numeru seryjnego więcej niż 5 razy dziennie.
| Nazwa | Typ | Przykład | |
|---|---|---|---|
sn |
Strunowy | xxx | wymagany |
czas rozpoczęcia |
Strunowy | 2023-09-01 | opcjonalny |
Koniec czasu |
Strunowy | 2023-09-07 | opcjonalny |
Notatka:
średnia: średni odczyt mocy w tym przedziale czasu.
średni dzień: średni odczyt mocy w ciągu dnia (8:00–20:00) w tym przedziale czasowym.
minimum: minimalny odczyt mocy w tym zakresie czasu.
maksimum: maksymalny odczyt mocy w tym zakresie czasu.
{
„dane”: {
„Czas startu”: „2023-09-01”,
„Czas zakończenia”: „07.09.2023”,
„średnia”: 862,6,
„średnia pora dnia”: 836,9,
„minimum”: 259,0,
„maksimum”: 3999,0
},
„udany”: prawda,
„wiadomość”: null
}Zwróć wynik analizy mocy z ostatnich 7 dni.
Zwróć wynik analizy mocy z określonego dnia
Zwróć stan rozłączenia z danym SN w określonym czasie.
Proszę nie wywoływać tego interfejsu API więcej niż 5 razy w ciągu jednego dnia.
Adres URL：https://www.iammeter.com/api/v1/site/offlineAnalytics
metoda：Dostawać
Limit: Proszę nie zamawiać tego API dla każdego numeru seryjnego więcej niż 5 razy dziennie.
| Nazwa | Typ | Przykład | |
|---|---|---|---|
sn |
Strunowy | xxx | wymagany |
czas rozpoczęcia |
Strunowy | 2023-09-01 | opcjonalny |
Koniec czasu |
Strunowy | 2023-09-07 | opcjonalny |
interwał(jednostka: minuta) |
Numer | 5 | opcjonalny |
Notatka:
W tym przedziale czasowym jest łącznie 10080 minut.
Całkowity czas offline w tym przedziale czasu wynosi 906 minut.
Przerwa w trybie offline, która jest większa niż 5 minut, jest wyświetlana w tablicy.
{
„dane”: {
„Czas startu”: „2023-09-05”,
„Czas zakończenia”: „11.09.2023”,
„Liczba offline”: 906,
„całkowita liczba”: 10080,
„lista”: [
{
„Czas startu”: „2023/9/5 0:00:00”,
„Godzina zakończenia”: „2023/9/5 15:06:14”,
„czas trwania”: 906
}
]
},
„udany”: prawda,
„wiadomość”: null
}Zwróć wynik analizy offline z określonego dnia
Zwróć najnowszą wartość całego licznika energii na tym koncie.
Adres URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
metoda：Dostawać
Limit: Upewnij się, że nie wysyłasz żądań do tego API częściej niż raz na 5 minut.
| Nazwa | Typ | Przykład | |
|---|---|---|---|
| Znak | Strunowy | xxx | wymagany |
{
„dane”:[
{
„sn”: „DA2BED94”,
„wartości”:[
223,71,
1,74,
225,
14761.03,
0
],
„gmtTime”: „2024/2/22 3:46:20”
},
{
„sn”: „B384789C”,
„wartości”:[
[
248,9,
13,9,
3356,
21228,
0,
zero,
zero
],
[
248,9,
13,9,
-2747,
8988,48,
18489,44,
zero,
zero
],
[
zero,
zero,
zero,
zero,
zero,
zero,
zero
],
[
248,9,
13,9,
-2747,
8988,48,
18489,44,
zero,
zero
]
],
„gmtTime”: „2024/2/22 3:45:15”
},
{
„sn”: „674B1E5D”,
„wartości”:[
[
220,4,
1,86,
377,
5345,985,
20,565
],
[
220,4,
1,86,
377,
5367.715,
0,033
],
[
220,5,
1,86,
377,
5369.532,
0,033
]
],
„gmtTime”: „2024/2/22 3:45:50”
},
{
„sn”: „59C9AB8D”,
„wartości”:[
[
245,3,
6,5,
1604,
46055.7,
0,
zero,
zero
],
[
245,3,
6,5,
-910,
15726,73,
8956,56,
zero,
zero
],
[
zero,
zero,
zero,
zero,
zero,
zero,
zero
],
[
245,3,
6,5,
-910,
15726,73,
8956,56,
zero,
zero
]
],
„gmtTime”: „2024/2/22 3:45:15”
},
{
„sn”: „3FE34ABE”,
„wartości”:[
[
230,
15,9,
3650.1,
2704,35,
0,
49,99,
0,94
],
[
230,
-11,5,
-2650,1,
1411.31,
1722,35,
49,99,
0,94
],
[
230,
4.3,
1000,
1946.03,
0,
49,99,
0,94
]
],
„gmtTime”: „2024/2/22 3:46:01”
}
],
„udany”: prawda,
„wiadomość”: null
}
Pobieranie godzinowych/dziennych wartości kWh na potrzeby generowania falownika i wymiany sieci (zarówno eksportowane, jak i importowane)
Adres URL:https://www.iammeter.com/api/v1/site/energyhistory/?czas rozpoczęcia={2024-05-05}&Koniec czasu={2024-07-07}&Grupuj według=&Znak={2be6d1xxxxxxcc688}
metoda: Dostawać
Limit：
groupby = dzień: dane z 90 dni (dane 90 szt.)
groupby = godzina: dane z 7 dni (dane 168 szt.)
| Nazwa | Typ | Des | Przykład | |
|---|---|---|---|---|
| Znak | Strunowy | token konta | xxx | wymagany |
| identyfikator_miejsca | numer | Identyfikator miejsca | wymagany | |
| czas rozpoczęcia | strunowy | czas rozpoczęcia tego powrotu interfejsu API | 2023-09-01 | wymagany |
| Koniec czasu | strunowy | czas zatrzymania tego powrotu interfejsu API | 2023-09-07 | wymagany |
| grupa | wyliczenie | wybierz interwał danych zwrotnych (godzina/dzień) | dzień/godzina | wymagany |
Identyfikator miejsca: Moje miejsca->Edytuj
id_miejsca:1360
startTime=2024-05-05
czas zakończenia=2024-05-07
grupowanie=dzień
{
„dane”: [{
„czas”: „2024/5/5 0:00:00”,
„wydajność”: 0,
„z siatki”: 9,62,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/6 0:00:00”,
„wydajność”: 0,
„z siatki”: 9.16,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
}
],
„udany”: prawda,
„wiadomość”: null
}id_miejsca:2393
startTime=2024-05-05
czas zakończenia=2024-05-07
grupowanie=dzień
{
„dane”: [{
„czas”: „2024/5/5 0:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/6 0:00:00”,
„wydajność”: 0,1,
„z siatki”: 0,22,
„do siatki”: 7,15,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
}
],
„udany”: prawda,
„wiadomość”: null
}id_miejsca:2393
startTime=2024-05-05
czas zakończenia=2024-05-06
grupowanie=godzina
{
„dane”: [{
„czas”: „2024/5/5 0:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 1:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 2:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 3:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 4:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 5:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 6:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 7:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 8:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 9:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 10:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 11:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 12:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 13:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 14:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 15:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 16:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 17:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 18:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 19:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 20:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 21:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 22:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
},
{
„czas”: „2024/5/5 23:00:00”,
„wydajność”: 0,
„z siatki”: 0,
„do siatki”: 0,
„specjalne obciążenie”: 0,
„samodzielne użycie”: 0
}
],
„udany”: prawda,
„wiadomość”: null
}Jakie możliwości oferuje IAMMETER?
Który typ licznika elektrycznego najlepiej odpowiada Twoim potrzebom?
Jak znaleźć miernik mocy w odniesieniu do swoich wymagań
Trójfazowy licznik energii Wi-Fi (WEM3080T)
Jednofazowy licznik energii Wi-Fi (WEM3080)
Trójfazowy licznik energii Wi-Fi (WEM3046T)
Trójfazowy licznik energii Wi-Fi (WEM3050T)