Atvainojiet, jūsu pārlūkprogramma neatbalsta JavaScript!

Kā efektīvāk izmantot IAMMETER mākoni, izmantojot API

Telpas

IAMMETER-cloud nodrošina dažas API, un izstrādātājs var izmantot šīs API, lai veiktu kādu interesantu darbu, piemēram, integrētu IAMMETER datus kādā trešās puses sistēmā. Mēs tikko atvērām šīs API saviem biznesa partneriem un dažiem lieliem klientiem iepriekš, taču nolēmām tagad tās atvērt visiem mūsu klientiem.

Laipni lūdzam darīt mums zināmu savu viedokli mūsu forumā.https://imeter.club

API ierobežojums

API nevar apmeklēt neierobežoti, mēs ierobežosim katras API ikdienas zvanu skaitu. Lūdzu, nezvaniet API biežāk.

Ja zvanu skaits pārsniedz stundas vai dienas ierobežojumu, API neko neatgriezīs.

Nē. API limita veids stundu Ikdienas apraksts
1 /lietotājs/pieteikšanās ip 5 30 vienam IP ir atļauts izsaukt šo API tikai 5 reizes stundā
2 /site/meterdata/ SN 12 vienam SN ir atļauts izsaukt šo API tikai 12 reizes stundā
3 /site/powerAnalysis SN 5 vienam SN ir atļauts zvanīt šai API tikai 5 reizes dienā
4 /site/offlineAnalīze SN 5 vienam SN ir atļauts zvanīt šai API tikai 5 reizes dienā

Iegūstiet konta marķieri

Atgrieziet konta marķieri. Tokens tiks izmantots gandrīz visā API.

Jums nav jāizsauc šī API, ja vien nevēlaties atsvaidzināt pilnvaru.Lūdzu, neizsauciet šo API vairāk kā 5 reizes vienā stundā un ne vairāk kā 30 reizes vienā dienā.

URL&metode

Iegūstiet konta pilnvaru, kas tiek izmantota visās API.

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

Metode:pastu

Dati

Nē. parametrs Piezīme piemērs
1 lietotājvārds IAMMETER lietotājvārds pārbaude
2 parole IAMMETER parole 123456

Atbilde

Marķiera vērtība tiks izmantota visās tālāk norādītajās API.

{
    "dati": {
        "id": 2025,
        "Token": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "veiksmīgs": taisnība,
    "Ziņojums": null
}

Iegūstiet pilnvaru tieši no tīmekļa sistēmas

Šo marķieri var nolasīt arī uzreiz pēc pieteikšanās sistēmā.

attēls-20230921163110697

Iegūstiet jaunākos augšupielādes datus un UTC laiku

Iegūstiet pēdējos augšupielādes datus ar aplūkoto SN.

Lūdzu, neizsauciet šo API vairāk kā 12 reizes vienas stundas laikā.

URL&metode

Pamata (mēra dati): https://www.iammeter.com/api/v1/site/meterdata/{sn}

Papildu (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}

Metode: GŪT

Ierobežot: lūdzu, nepieprasiet šo API vairāk kā 288 reizes dienā (5 minūšu intervāls).

Atšķirība starp pamata un uzlaboto:

Pamata: bez jaudas koeficienta (PF)

Uzlabots: ar PF (jaudas koeficients)

Parametri

Vārds Tips Piemērs
Token Stīga xxx nepieciešams

Atbilde: vienfāzes mērīšanas dati (bez jaudas koeficienta)

vērtību definīcija: spriegums, strāva, aktīvā jauda, importētie Kwh, eksportētie Kwh

{
    "dati": {
        "vērtības": [
            [
                230.220,
                1300,
                119 000,
                1766 590,
                0000
            ]
        ],
        Vietējais laiks: "2020/8/28 15:27:33,
        "gmtTime": "2020/8/28 5:27:33"
    },
    "veiksmīgs": taisnība,
    "Ziņojums": null
}

Atbilde: vienfāzes -meterdata2 (bez jaudas koeficienta)

vērtību definīcija: spriegums, strāva, aktīvā jauda,spēka faktors,importēts Kwh, izvests Kwh

{
    "dati":{
        "vērtības":[
            [
                233,41,
                0,718,
                111,
                0,66,
                5724,85,
                0
            ]
        ],
        "localTime":"2023/11/21 14:30:22,
        "gmtTime":"2023/11/21 6:30:22"
    },
    "veiksmīgs":true,
    "ziņa":null
}

Atbilde: 3 fāzu mērīšanas dati (bez jaudas koeficienta)

Trīs masīvi iekšāvērtībasapzīmē A fāzi, B fāzi un C fāzi.

Elementa definīcija: spriegums, strāva, aktīvā jauda,spēka faktors,importēts Kwh, izvests Kwh

{
    "dati": {
        "vērtības": [
            [
                242 600,
                1000,
                216 000,
                32354.600,
                0000
            ],
            [
                242 600,
                1000,
                1986 000,
                30536.410,
                17704.720
            ],
            [
                0000,
                0000,
                0000,
                0000,
                0000
            ]
        ],
        Vietējais laiks: "2020/8/28 15:30:48,
        "gmtTime": "2020/8/28 5:30:48"
    },
    "veiksmīgs": taisnība,
    "Ziņojums": null
}

Atbilde: 3 fāzes -meterdata2 (ar jaudas koeficientu)

{
    "dati":{
        "vērtības":[
            [//A fāze
                233,8,//spriegums
                0,03,//pašreizējais
                4,//aktīvā jauda
                0,57,//jaudas koeficients
                222,53,//importēti Kwh
                0 //eksportēti Kwh
            ],
            [//B fāze
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //C fāze
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        Vietējais laiks: 2023/11/21 14:39:36,
        "gmtTime":"2023/11/21 6:39:36"
    },
    "veiksmīgs":true,
    "ziņa":null
}

Piemērs

attēls-20230921164457116

Iegūstiet vēstures ierakstu

Atgriezt vēsturiskos datus iestatītajā intervālā un laika diapazonā.

  • laika diapazons: pēdējais mēnesis
  • maksimālais datu garums: 2000 gab

Tūlītējie dati ir 1 minūtes intervālā. Dienā ir 60*24=1440 datu gabali. Ja pieprasāt vēsturiskos datus 1 min intervālā, varat pieprasīt tikai 1,39 (2000/1440) dienu datus. Bet, ja pieprasāt datus 5 minūšu intervālā, varat pieprasīt gandrīz 7 dienu datus.

URL&metode

Pamata (metrdatalist):https://www.iammeter.com/api/v1/site/meterdatalist/

**Papildu (meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}

Atšķirība starp pamata un uzlaboto:

Pamata: bez jaudas koeficienta (PF)

Uzlabots: ar PF (jaudas koeficients)

Parametri

Vārds Tips Piemērs
Token Stīga xxx nepieciešams
intervāls numuru 300 nepieciešams, mērvienība: sekunde
sākuma laiks virkne 2023-09-01 nepieciešams
beigu laiks virkne 2023-09-07 nepieciešams

Atbilde: vienfāzes - meterdatalist

Dati: [spriegums, strāva, jauda, importa enerģija, eksporta enerģija, UTC laiks, vietējais laiks]

{
    "dati": [
        [
            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"
        ]
    ],
    "veiksmīgs": taisnība,
    "Ziņojums": null
}

Atbilde: trīs fāzu - meterdatalist

{
    "dati": [
        [
            230,//phaseA spriegums
            0,//pašreizējais
            0,//aktīvā jauda
            468,41,//importēts kWh
            0,//eksportēts kWh
            230,//B fāze
            0,
            0,
            236,58,
            290,77,
            230,//C fāze
            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"
        ]
    ],
    "veiksmīgs": taisnība,
    "Ziņojums": null
}

Atbilde: trīs fāzes - meterdatalist2

{
    "dati":[
        { //pirmie dati
            "rtcTime":"2023/9/1 0:00:22",
            "gmtTime":"2023/8/31 16:00:22",
            "vērtības":[
                [ //A fāze
                    235,2,//spriegums
                    0,03,//pašreizējais
                    4,//aktīvā jauda
                    0,57,//jaudas koeficients
                    210,21,//importēt Kwh
                    0 //eksportēti Kwh
                ],
                [//B fāze
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //C fāze
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //sekundes dati
            "rtcTime":"2023/9/1 8:00:49",
            "gmtTime":"2023/9/1 0:00:49",
            "vērtības":[
                [
                    233,4,
                    0,03,
                    4,
                    0,57,
                    210.24,
                    0
                ],
                [
                    5.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //trešie dati
            "rtcTime":"2023/9/1 16:00:24",
            "gmtTime":"2023/9/1 8:00:24",
            "vērtības":[
                [
                    235,6,
                    0,03,
                    4,
                    0,57,
                    210.27,
                    0
                ],
                [
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        }
    ],
    "veiksmīgs":true,
    "ziņa":null
}

Piemērs

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

attēls-20230926150649591

Jaudas nolasīšanas analīze

Atgrieziet jaudas analīzes rezultātu norādītajā laikā.

Lūdzu, neizsauciet šo API vairāk kā 5 reizes vienā dienā.

URL&metode

URL:https://www.iammeter.com/api/v1/site/powerAnalysis

Metode: gūt

Ierobežot: lūdzu, nepieprasiet šo API vienam SN vairāk kā 5 reizes dienā.

Parametri

Vārds Tips Piemērs
sn Stīga xxx nepieciešams
sākuma laiks Stīga 2023-09-01 neobligāti
beigu laiks Stīga 2023-09-07 neobligāti

Piezīme:

  1. Maksimālais laika diapazons ir 7 dienas pēdējā mēnesī.
  2. Laika parametrs nav obligāts, ja neizmantojat parametru, API atgriezīs pēdējo 7 dienu rezultātu.

Atbilde

vidējais: vidējā jaudas rādījums šajā laika diapazonā.

vidējais dienas laiks: vidējais dienas (8:00–20:00) jaudas rādījums šajā laika diapazonā.

minimums: minimālās jaudas rādījums šajā laika diapazonā.

maksimums: maksimālās jaudas nolasījums šajā laika diapazonā.

{
    "dati": {
        "sākuma laiks": "2023-09-01",
        "beigu laiks": "2023-09-07",
        "vidējais": 862,6,
        "vidējais dienas laiks": 836,9,
        "minimums": 259,0,
        "maksimums": 3999,0
    },
    "veiksmīgs": taisnība,
    "Ziņojums": null
}

Piemērs

Atgriezt pēdējo 7 dienu jaudas analīzes rezultātu.

attēls-20230921163444898

Atgriezt norādītās dienas jaudas analīzes rezultātu

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

attēls-20230922101047074

Bezsaistes statusa analīze

Norādītajā laikā atgriezt atvienošanas statusu ar aplūkoto SN.

Lūdzu, neizsauciet šo API vairāk kā 5 reizes vienā dienā.

URL&metode

URLhttps://www.iammeter.com/api/v1/site/offlineAnalysis

Metodegūt

Ierobežot: lūdzu, nepieprasiet šo API vienam SN vairāk kā 5 reizes dienā.

Parametri

Vārds Tips Piemērs
sn Stīga xxxx nepieciešams
sākuma laiks Stīga 2023-09-01 neobligāti
beigu laiks Stīga 2023-09-07 neobligāti
intervāls(vienība :minūte) Numurs 5 neobligāti

Piezīme:

  1. Maksimālais laika diapazons ir 7 dienas pēdējā mēnesī.
  2. Laika parametrs nav obligāts, ja neizmantojat parametru, API atgriezīs pēdējo 7 dienu rezultātu.
  3. Ja nenorādīsiet intervālu, noklusējuma vērtība ir 5 minūtes.

Atbilde

Šajā laika diapazonā kopā ir 10080 minūtes.

Kopējais bezsaistes laiks šajā laika diapazonā ir 906 minūtes.

Bezsaistes pārtraukums, kas pārsniedz 5 minūtes, ir norādīts masīvā.

{
    "dati": {
        "sākuma laiks": "2023-09-05",
        Beigu laiks: "2023-09-11,
        "offlineCount": 906,
        "TotalCount": 10080,
        "saraksts": [
            {
                "sākuma laiks": "2023/9/5 0:00:00",
                "beigu laiks": "2023/9/5 15:06:14",
                "ilgums": 906
            }
        ]
    },
    "veiksmīgs": taisnība,
    "Ziņojums": null
}

Piemērs

Atgriezt norādītās dienas bezsaistes analīzes rezultātu

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

attēls-20230922101653639

Atsauce

WiFi enerģijas skaitītāja API

3 fāžu WiFi enerģijas skaitītājs

Izmantojiet 3 fāžu enerģijas skaitītāju, kā vēlaties

Tops