Przepraszamy, Twoja przeglądarka nie obsługuje JavaScript!

Jak efektywniej korzystać z chmury IAMMETER poprzez API

Przesłanka

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

Limit API

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

Zdobądź token do konta

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.

Adres URL i metoda

Uzyskaj token konta, który jest używany we wszystkich interfejsach API.

URL:https://www.iammeter.com/api/v1/user/login

Metoda:post

Dane

Nie. parametr uwaga przykład
1 nazwa użytkownika Nazwa użytkownika IAMMETER test
2 hasło hasło IAMMETER 123456

Odpowiedź

Wartość tokenu będzie używana we wszystkich poniższych interfejsach API.

{
    „dane”: {
        „id”: 2025,
        „token”: „349dfxxxxxxac5169”,
        „refreshToken”: „8adf75e5da10424985f3b83855133982”
    },
    „udany”: prawda,
    „wiadomość”: null
}

Uzyskaj token bezpośrednio z systemu internetowego

Token ten można odczytać także bezpośrednio po zalogowaniu się do systemu.

obraz-20230921163110697

Uzyskaj najnowsze przesyłane dane i czas UTC

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.

Adres URL i metoda

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)

Parametry

Nazwa Typ Przykład
Znak Strunowy xxx wymagany

Odpowiedź: jednofazowe – dane licznika (bez współczynnika mocy)

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
}

Odpowiedź: jednofazowa - dane licznika 2 (bez współczynnika mocy)

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
}

Odpowiedź: 3-fazowe dane licznika (bez współczynnika mocy)

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
}

Odpowiedź: 3 fazy - dane licznika 2 (ze współczynnikiem mocy)

{
    „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
}

Przykład

obraz-20230921164457116

Zdobądź zapis historii

Zwróć dane historyczne dotyczące ustawionego interwału i zakresu czasu.

  • zakres czasu: ostatni miesiąc
  • maksymalna długość danych: 2000 sztuk

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.

Adres URL i metoda

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)

Parametry

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

Odpowiedź: jednofazowa – licznik danych

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
}

Odpowiedź: trójfazowa – licznik danych

{
    „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
}

Odpowiedź: trójfazowa - licznikdatalist2

{
    „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
}

Przykład

https://www.iammeter.com/api/v1/Site/MeterDataList/{yourSN}?token={yourToken}&startTime=2023-09-01&endTime=2023-09-07&interval=300

obraz-20230926150649591

Analiza odczytu mocy

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 i metoda

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.

Parametry

Nazwa Typ Przykład
sn Strunowy xxx wymagany
czas rozpoczęcia Strunowy 2023-09-01 opcjonalny
Koniec czasu Strunowy 2023-09-07 opcjonalny

Notatka:

  1. Maksymalny zakres czasu to 7 dni w ostatnim miesiącu.
  2. Parametr time jest opcjonalny, jeśli nie użyjesz parametru, API zwróci wynik z ostatnich 7 dni.

Odpowiedź

ś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
}

Przykład

Zwróć wynik analizy mocy z ostatnich 7 dni.

obraz-20230921163444898

Zwróć wynik analizy mocy z określonego dnia

https://www.iammeter.com/api/v1/site/powerAnalytic?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

obraz-20230922101047074

Analiza stanu offline

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 i metoda

Adres URLhttps://www.iammeter.com/api/v1/site/offlineAnalytics

metodaDostawać

Limit: Proszę nie zamawiać tego API dla każdego numeru seryjnego więcej niż 5 razy dziennie.

Parametry

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:

  1. Maksymalny zakres czasu to 7 dni w ostatnim miesiącu.
  2. Parametr time jest opcjonalny, jeśli nie użyjesz parametru, API zwróci wynik z ostatnich 7 dni.
  3. Jeżeli nie określisz odstępu, domyślnym ustawieniem będzie 5 minut.

Odpowiedź

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
}

Przykład

Zwróć wynik analizy offline z określonego dnia

https://www.iammeter.com/api/v1/site/offlineAnalytic?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

obraz-20230922101653639

Referencja

API licznika energii WiFi

Licznik energii 3-fazowy WiFi

Korzystaj z 3-fazowego licznika energii tak, jak wolisz

Szczyt