Maaf, browser Anda tidak mendukung JavaScript!

Bagaimana Menggunakan IAMMETER-cloud secara lebih efisien dengan API

Premis

IAMMETER-cloud menyediakan beberapa API, dan pengembang dapat menggunakan API ini untuk melakukan beberapa pekerjaan menarik, seperti mengintegrasikan data IAMMETER ke beberapa sistem pihak ketiga. Kami baru saja membuka API ini untuk mitra bisnis kami dan beberapa pelanggan besar sebelumnya, namun memutuskan untuk membukanya untuk semua pelanggan kami sekarang.

Selamat datang untuk memberi tahu kami pendapat Anda di forum kami.https://imeter.club

Batasan pada API

API tidak dapat dikunjungi tanpa batas, kami akan membatasi jumlah panggilan harian untuk setiap API. Mohon jangan memanggil API lebih sering.

Jika jumlah panggilan melebihi batasan per jam atau harian, API tidak akan mengembalikan apa pun.

Tidak. API tipe batas per jam Harian keterangan
1 /pengguna/login aku p 5 30 satu IP hanya diperbolehkan memanggil api ini 5 kali setiap jam
2 /situs/meterdata/ SN 12 satu SN hanya diperbolehkan memanggil api ini 12 kali setiap jam
3 /situs/powerAnalysis SN 5 satu SN hanya diperbolehkan memanggil api ini 5 kali sehari
4 /situs/offlineAnalysis SN 5 satu SN hanya diperbolehkan memanggil api ini 5 kali sehari

Dapatkan token akunnya

Kembalikan token akun. Token tersebut akan digunakan di hampir semua API.

Anda tidak perlu memanggil API ini kecuali Anda ingin menyegarkan token.Mohon jangan memanggil API ini lebih dari 5 kali dalam satu jam, dan tidak lebih dari 30 kali dalam satu hari.

URL & Metode

Dapatkan token akun yang digunakan di semua API.

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

Metode:pos

Data

Tidak. parameter komentar contoh
1 nama belakang Nama pengguna IAMMETER tes
2 kata sandi kata sandi IAMMETER 123456

Tanggapan

Nilai token akan digunakan di semua API di bawah.

{
    "data": {
        "id": 2025,
        "token": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "sukses": benar,
    "pesan": batal
}

Dapatkan token dari sistem web secara langsung

Token ini juga dapat langsung dibaca setelah Anda login ke sistem.

gambar-20230921163110697

Dapatkan data pengunggahan terbaru dan waktu UTC

Dapatkan data unggahan terakhir dengan SN yang bersangkutan.

Mohon jangan memanggil API ini lebih dari 12 kali dalam satu jam.

URL & Metode

Dasar (data meter): https://www.iammeter.com/api/v1/site/meterdata/{sn}

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

metode: MENDAPATKAN

Membatasi: mohon jangan meminta API ini lebih dari 288 kali setiap hari (interval 5 menit).

Perbedaan antara dasar dan lanjutan:

Dasar: tanpa PF (Faktor daya)

Lanjutan: dengan PF (Faktor daya)

Parameter

Nama Jenis Contoh
Token Rangkaian xxx diperlukan

Respon: fase tunggal -meterdata (tanpa faktor Daya)

definisi nilai: tegangan, arus, daya aktif, Kwh impor, Kwh ekspor

{
    "data": {
        "nilai": [
            [
                230.220,
                1.300,
                119.000,
                1766.590,
                0,000
            ]
        ],
        "Waktu Lokal": "28/8/2020 15:27:33",
        "Waktu gmt": "28/8/2020 5:27:33"
    },
    "sukses": benar,
    "pesan": batal
}

Respon: fase tunggal -meterdata2 (tanpa faktor Daya)

definisi nilai: tegangan, arus, daya aktif,faktor kekuatan, Kwh impor, Kwh ekspor

{
    "data":{
        "nilai":[
            [
                233.41,
                0,718,
                111,
                0,66,
                5724.85,
                0
            ]
        ],
        "Waktu Lokal":"21/11/2023 14:30:22",
        "Waktu gmt":"21/11/2023 6:30:22"
    },
    "sukses": benar,
    "pesan":batal
}

Respon: 3 fase -meterdata (tanpa faktor Daya)

Tiga array dinilai-nilaimewakili Fase A, fase B, dan Fase C.

Definisi elemen: tegangan, arus, daya aktif,faktor kekuatan, Kwh impor, Kwh ekspor

{
    "data": {
        "nilai": [
            [
                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
            ]
        ],
        "Waktu Lokal": "28/8/2020 15:30:48",
        "Waktu gmt": "28/8/2020 5:30:48"
    },
    "sukses": benar,
    "pesan": batal
}

Respon: 3 fase -meterdata2 (dengan faktor Daya)

{
    "data":{
        "nilai":[
            [//fase A
                233,8,//tegangan
                0,03,//saat ini
                4,//daya aktif
                0,57,//faktor daya
                222.53,//Kwh yang diimpor
                0 //mengekspor Kwh
            ],
            [//fase B
                5,
                0,
                0,
                0,
                0,
                0
            ],
            [ //fase C
                3.1,
                0,
                0,
                0,
                0,
                0
            ]
        ],
        "Waktu Lokal":"21/11/2023 14:39:36",
        "Waktu gmt":"21/11/2023 6:39:36"
    },
    "sukses":benar,
    "pesan":batal
}

Contoh

gambar-20230921164457116

Dapatkan catatan sejarah

Mengembalikan data historis pada interval dan rentang waktu yang ditetapkan.

  • rentang waktu: bulan terakhir
  • panjang data maksimum: 2000 buah

Data instan dalam interval 1 menit. Ada 60*24=1440 data per hari. Jika Anda meminta data historis dalam interval 1 menit, Anda hanya dapat meminta data 1,39(2000/1440) hari. Namun jika Anda meminta data dalam interval 5 menit, Anda dapat meminta data dalam waktu hampir 7 hari.

URL & Metode

Dasar (daftar data meteran):https://www.iammeter.com/api/v1/site/meterdatalist/

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

Perbedaan antara dasar dan lanjutan:

Dasar: tanpa PF (Faktor daya)

Lanjutan: dengan PF (Faktor daya)

Parameter

Nama Jenis Contoh
Token Rangkaian xxx diperlukan
selang nomor 300 diperlukan, satuan: detik
waktu mulai rangkaian 2023-09-01 diperlukan
akhir waktu rangkaian 2023-09-07 diperlukan

Respon: fase tunggal - meterdatalist

Data:[tegangan, arus, daya, energi impor, energi ekspor, waktu utc, waktu setempat]

{
    "data": [
        [
            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"
        ]
    ],
    "sukses": benar,
    "pesan": batal
}

Respon: tiga fase - meterdatalist

{
    "data": [
        [
            230,//faseA tegangan
            0,//saat ini
            0,//daya aktif
            468,41,//kWh impor
            0,//kWh yang diekspor
            230,//TahapB
            0,
            0,
            236.58,
            290,77,
            230,//Tahap 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"
        ]
    ],
    "sukses": benar,
    "pesan": batal
}

Respon: tiga fase - meterdatalist2

{
    "data":[
        {//data pertama
            "rtcTime":"2023/9/1 0:00:22",
            "Waktu gmt":"2023/8/31 16:00:22",
            "nilai":[
                [ //fase A
                    235.2,//tegangan
                    0,03,//saat ini
                    4,//daya aktif
                    0,57,//faktor daya
                    210.21,//impor Kwh
                    0 //mengekspor Kwh
                ],
                [//fase B
                    5.5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //fase C
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        {//data kedua
            "rtcTime":"2023/9/1 8:00:49",
            "Waktu gmt":"2023/9/1 0:00:49",
            "nilai":[
                [
                    233.4,
                    0,03,
                    4,
                    0,57,
                    210.24,
                    0
                ],
                [
                    5.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        {//data ketiga
            "rtcTime":"2023/9/1 16:00:24",
            "Waktu gmt":"2023/9/1 8:00:24",
            "nilai":[
                [
                    235.6,
                    0,03,
                    4,
                    0,57,
                    210.27,
                    0
                ],
                [
                    5.5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [
                    3.4,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        }
    ],
    "sukses": benar,
    "pesan":batal
}

Contoh

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

gambar-20230926150649591

Analisis kekuatan membaca

Kembalikan hasil analisis daya dalam waktu yang ditentukan.

Mohon jangan memanggil API ini lebih dari 5 kali dalam satu hari.

URL & Metode

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

metode: mendapatkan

Membatasi: Mohon jangan meminta API ini per SN lebih dari 5 kali setiap hari.

Parameter

Nama Jenis Contoh
sn Rangkaian xxx diperlukan
waktu mulai Rangkaian 2023-09-01 opsional
akhir waktu Rangkaian 2023-09-07 opsional

Catatan:

  1. Rentang waktu maksimum adalah 7 hari pada bulan terakhir.
  2. Parameter waktu bersifat opsional, jika Anda tidak menggunakan parameter tersebut, API akan mengembalikan hasil 7 hari terakhir.

Tanggapan

rata-rata: pembacaan daya rata-rata selama rentang waktu ini.

rata-rata Siang Hari: rata-rata pembacaan daya Siang Hari (8:00-20:00) selama rentang waktu ini.

minimum: pembacaan daya minimum selama rentang waktu ini.

maksimum: pembacaan daya maksimum selama rentang waktu ini.

{
    "data": {
        "Waktu mulai": "01-09-2023",
        "Waktu berakhir": "07-09-2023",
        "rata-rata": 862,6,
        "rata-rataSiang Hari": 836,9,
        "minimum": 259,0,
        "maksimum": 3999.0
    },
    "sukses": benar,
    "pesan": batal
}

Contoh

Kembalikan hasil analisis kekuatan 7 hari terakhir.

gambar-20230921163444898

Mengembalikan hasil analisis kekuatan pada hari yang ditentukan

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

gambar-20230922101047074

Analisis status offline

Kembalikan status pemutusan dengan SN yang bersangkutan dalam waktu yang ditentukan.

Mohon jangan memanggil API ini lebih dari 5 kali dalam satu hari.

URL & Metode

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

metodeMendapatkan

Membatasi: Mohon jangan meminta API ini per SN lebih dari 5 kali setiap hari.

Parameter

Nama Jenis Contoh
sn Rangkaian xxxx diperlukan
waktu mulai Rangkaian 2023-09-01 opsional
akhir waktu Rangkaian 2023-09-07 opsional
selang(satuan : menit) Nomor 5 opsional

Catatan:

  1. Rentang waktu maksimum adalah 7 hari pada bulan terakhir.
  2. Parameter waktu bersifat opsional, jika Anda tidak menggunakan parameter tersebut, API akan mengembalikan hasil 7 hari terakhir.
  3. Jika Anda tidak menentukan intervalnya, defaultnya adalah 5 menit.

Tanggapan

Ada total 10.080 menit dalam rentang waktu ini.

Total waktu offline adalah 906 menit dalam rentang waktu ini.

Kesenjangan offline yang lebih besar dari 5 menit tercantum dalam array.

{
    "data": {
        "Waktu mulai": "05-09-2023",
        "Waktu berakhir": "11-09-2023",
        "penghitungan offline": 906,
        "jumlahJumlah": 10080,
        "daftar": [
            {
                "Waktu mulai": "2023/9/5 0:00:00",
                "Waktu berakhir": "2023/9/5 15:06:14",
                "durasi": 906
            }
        ]
    },
    "sukses": benar,
    "pesan": batal
}

Contoh

Kembalikan hasil analisis offline pada hari yang ditentukan

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

gambar-20230922101653639

Referensi

API pengukur Energi WiFi

Pengukur Energi WiFi 3 fase

Gunakan pengukur energi 3 fase sesuai keinginan Anda

Atas