如何通过API更高效地使用IAMMETER-cloud

前提 API 限制 Account：获取账户的token 网址及方法数据回复直接从Web系统获取token 电能表：获取最新上传数据和 UTC 时间网址及方法参数响应：单相-仪表数据（无功率因数）响应：单相-meterdata2（无功率因数）响应： 3相-仪表数据（无功率因数）响应：3相-meterdata2（带功率因数）例子电能表：获取历史记录网址及方法参数响应：单相-meterdatalist 响应：三相-meterdatalist 响应：三相 -meterdatalist2 例子电能表：电能读数分析网址及方法参数回复例子电能表：离线状态分析网址及方法参数回复例子账户：从单个账户中检索所有电能表的最新数据网址及方法参数回复例子地点：返回每种使用类型的每小时或每日千瓦时数据。网址及方法参数响应：单相响应：三相参考

前提

IAMMETER-cloud提供了一些API，开发者可以使用这些API来做一些有趣的工作，比如将IAMMETER的数据集成到一些第三方系统中。之前我们只是向我们的业务合作伙伴和一些大客户开放这些API，但现在决定向我们所有的客户开放。

欢迎在我们的论坛上告诉我们您的想法。https://imeter.club

API 限制

该API不能无限制访问，我们会限制每个API每天的调用次数。请不要频繁调用API。

如果调用次数超过每小时或每日限制，API 将不会返回任何内容。

不。	应用程序编程接口	限制类型	每小时	日常	描述
1	/用户登录	ip	5	30	一个IP每小时只能调用该接口5次
2	/站点/仪表数据/	序列号	12		一个SN每小时只能调用该接口12次
3	/站点/powerAnalyze	序列号		5	一个SN每天只能调用该接口5次
4	/site/offlineAnalyse	序列号		5	一个SN每天只能调用该接口5次

Account：获取账户的token

返回账户的token。该令牌将用于几乎所有 API。

除非您需要刷新令牌，否则不需要调用此接口。一小时内调用该接口的次数不要超过5次，一天内调用该接口的次数不要超过30次。

网址及方法

获取所有 API 中使用的帐户的令牌。

网址：https://www.iammeter.com/api/v1/user/login

方法：邮政

数据

不。	范围	评论	例子
1	用户名	IAMMETER的用户名	测试
2	密码	IAMMETER密码	123456

令牌值将在以下所有 API 中使用。

{
    “数据”：{
        “id”：2025，
        “令牌”：“349dfxxxxxxac5169”，
        “refreshToken”：“8adf75e5da10424985f3b83855133982”
    },
    “成功”：真实，
    “消息”：空
}

直接从Web系统获取token

登录系统后也可以直接读取此令牌。

电能表：获取最新上传数据和 UTC 时间

获取对应SN的最后一次上传数据。

一小时内调用该接口的次数不要超过12次。

网址及方法

基础（仪表数据）: https://www.iammeter.com/api/v1/site/meterdata/{sn}

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

方法：得到

限制：每天请求该API的次数不要超过288次（间隔5分钟）。

基础和高级的区别：

基本：无PF（功率因数）

高级：带PF（功率因数）

参数

姓名	类型	例子
代币	细绳	xxx	必需的

响应：单相-仪表数据（无功率因数）

数值定义：电压、电流、有功功率、输入电量、输出电量

{
    “数据”：{
        “值”：[
            [
                230.220,
                1.300，
                119.000,
                1766.590,
                0.000
            ]
        ],
        "本地时间": "2020/8/28 15:27:33",
        “gmtTime”: “2020/8/28 5:27:33”
    },
    “成功”：真实，
    “消息”：空
}

响应：单相-meterdata2（无功率因数）

数值定义：电压、电流、有功功率、功率因数,进口千瓦时,出口千瓦时

{
    “数据”：{
        “值”：[
            [
                233.41,
                0.718,
                111、
                0.66,
                5724.85,
                0
            ]
        ],
        "localTime":"2023/11/21 14:30:22",
        “gmtTime”:“2023/11/21 6:30:22”
    },
    “成功”：真实，
    “消息”：空
}

响应： 3相-仪表数据（无功率因数）

中的三个数组价值观分别表示A相、B相、C相。

元素定义：电压、电流、有功功率、功率因数,进口千瓦时,出口千瓦时

{
    “数据”：{
        “值”：[
            [
                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
            ]
        ],
        "本地时间": "2020/8/28 15:30:48",
        “gmtTime”：“2020/8/28 5:30:48”
    },
    “成功”：真实，
    “消息”：空
}

响应：3相-meterdata2（带功率因数）

{
    “数据”：{
        “值”：[
            [//A相
                233.8,//电压
                0.03,//当前
                4、//有功功率
                0.57,//功率因数
                222.53,//进口千瓦时
                0 //输出千瓦时
            ],
            [//B相
                5、
                0,
                0,
                0,
                0,
                0
            ],
            [ //C阶段
                3.1、
                0,
                0,
                0,
                0,
                0
            ]
        ],
        "localTime":"2023/11/21 14:39:36",
        “gmtTime”:“2023/11/21 6:39:36”
    },
    “成功”：真实，
    “消息”：空
}

例子

电能表：获取历史记录

返回设定的时间间隔和时间范围内的历史数据。

时间范围：最近一个月
最大数据长度：2000条

即时数据以 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	必需的

响应：单相-meterdatalist

数据：[电压、电流、功率、进口电量、出口电量、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”
        ]
    ],
    “成功”：真实，
    “消息”：空
}

响应：三相-meterdatalist

{
    “数据”：[
        [
            230,//A相电压
            0,//当前
            0,//有功功率
            468.41,//输入千瓦时
            0,//输出kWh
            230,//B相
            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”
        ]
    ],
    “成功”：真实，
    “消息”：空
}

响应：三相 -meterdatalist2

{
    “数据”：[
        { //第一个数据
            “rtcTime”:“2023/9/1 0:00:22”,
            "gmtTime":"2023/8/31 16:00:22",
            “值”：[
                [ //A阶段
                    235.2,//电压
                    0.03,//当前
                    4、//有功功率
                    0.57,//功率因数
                    210.21,//导入千瓦时
                    0 //输出千瓦时
                ],
                [//B相
                    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
                ]
            ]
        }
    ],
    “成功”：真实，
    “消息”：空
}

例子

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

电能表：电能读数分析

返回指定时间内的功率分析结果。

一天内调用该接口的次数不要超过5次。

网址及方法

网址：https://www.iammeter.com/api/v1/site/powerAnalysis

方法：得到

限制：每个SN每天请求该API的次数不要超过5次。

参数

姓名	类型	例子
`锡`	细绳	xxx	必需的
`开始时间`	细绳	2023-09-01	选修的
`时间结束`	细绳	2023-09-07	选修的

笔记：

最大时间范围是最近一个月的 7 天。
时间参数是可选的，如果不使用该参数，API将返回最近7天的结果。

平均值：该时间范围内的平均功率读数。

AverageDaytime：该时间范围内的平均日间（8:00am-8:00pm）功率读数。

最小值：该时间范围内的最小功率读数。

最大值：该时间范围内的最大功率读数。

{
    “数据”：{
        “开始时间”：“2023-09-01”，
        “结束时间”：“2023-09-07”，
        “平均”：862.6，
        “平均白天”：836.9，
        “最小值”：259.0，
        “最大”：3999.0
    },
    “成功”：真实，
    “消息”：空
}

例子

返回最近7天的功率分析结果。

返回指定日期的功率分析结果

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

电能表：离线状态分析

返回指定时间内对应SN的断线状态。

一天内调用该接口的次数不要超过5次。

网址及方法

网址：https://www.iammeter.com/api/v1/site/offlineAnalysis

方法：得到

限制：每个SN每天请求该API的次数不要超过5次。

参数

姓名	类型	例子
`锡`	细绳	xxxx	必需的
`开始时间`	细绳	2023-09-01	选修的
`时间结束`	细绳	2023-09-07	选修的
`间隔`（单位：分钟）	数字	5	选修的

笔记：

最大时间范围是最近一个月的 7 天。
时间参数是可选的，如果不使用该参数，API将返回最近7天的结果。
如果不指定间隔，则默认为 5 分钟。

该时间范围内总共有10080分钟。

该时间范围内总离线时间为906分钟。

数组中列出了大于 5 分钟的离线间隙。

{
    “数据”：{
        “开始时间”：“2023-09-05”，
        “结束时间”：“2023-09-11”，
        “离线计数”：906，
        “总计数”：10080，
        “列表”：[
            {
                "开始时间": "2023/9/5 0:00:00",
                “结束时间”:“2023/9/5 15:06:14”,
                “持续时间”：906
            }
        ]
    },
    “成功”：真实，
    “消息”：空
}

例子

返回指定日期的离线分析结果

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

账户：从单个账户中检索所有电能表的最新数据

返回该帐户下所有电能表的最新值。

网址及方法

网址：https://www.iammeter.com/api/v1/site/metersdata?token=xxx

方法：得到

限制：请确保您对此 API 的请求频率不要超过每 5 分钟一次。

参数

姓名	类型	例子
代币	细绳	xxx	必需的

{
“数据”：[
{
“sn”：“DA2BED94”，
“值”：[
223.71，
1.74，
225，
14761.03，
0
]，
“gmtTime”：“2024/2/22 3:46:20”
},
{
"sn":"B384789C",
"values":[
[
248.9,
13.9,
3356,
21228,
0,
null,
null
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
null,
null
],
[
null,
null,
null,
null,
null,
null,
null,
],
[
248.9,
13.9,
-2747,
8988.48,
18489.44,
null,
null
]
],
“gmtTime”：“2024/2/22 3:45:15”
},
{
"sn":"674B1E5D",
"values":[
[
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",
"values":[
[
245.3,
6.5,
1604,
46055.7,
0,
null,
null
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
null,
null
],
[
null,
null,
null,
null,
null,
null,
null,
],
[
245.3,
6.5,
-910,
15726.73,
8956.56,
null,
null
]
],
"gmtTime":"2024/2/22 3:45:15”
},
{
"sn":"3FE34ABE",
"values":[
[
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"
}
],
"成功":true,
"消息":null
}

例子

地点：返回每种使用类型的每小时或每日千瓦时数据。

检索逆变器发电和电网交换（导出和导入）的每小时/每日千瓦时值

网址及方法

网址：https://www.iammeter.com/api/v1/site/energyhistory/?开始时间={2024-05-05}&时间结束={2024-07-07}&通过...分组=&代币={2be6d1xxxxxxcc688}

方法：得到

限制：

groupby = day :90天数据（90条数据）

groupby = 小时:7天数据 (168条数据)

参数

姓名	类型	设计	例子
代币	细绳	账户 token	xxx	必需的
地点 ID	数字	地點ID		必需的
开始时间	细绳	该api返回的开始时间	2023-09-01	必需的
时间结束	细绳	该api返回的停止时间	2023-09-07	必需的
群交	枚举	选择返回数据间隔（小时/天）	天/小时	必需的

地点 ID：我的位置->编辑

响应：单相

地点编号：1360

开始时间=2024-05-05

结束时间=2024-05-07

分组=天

https://www.iammeter.com/api/v1/site/energyhistory/1360?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 9.62,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/6 0:00:00",
"yield": 0,
"fromGrid": 9.16,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
"消息": null
}

响应：三相

地点编号：2393

开始时间=2024-05-05

结束时间=2024-05-07

分组=天

https://www.iammeter.com/api/v1/site/energyhistory/2393?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/6 0:00:00",
"yield": 0.1,
"fromGrid": 0.22,
"toGrid": 7.15,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
"消息": null
}

地点编号：2393

开始时间=2024-05-05

结束时间=2024-05-06

分组=小时

https://www.iammeter.com/api/v1/site/energyhistory/2393?startTime=2024-05-05&endTime=2024-05-07&groupby=day&Token=f7eba1ac8c194b3fbc8e79b8af0adb72

{
“数据”：[{
“时间”： “2024/5/5 0:00:00”,
“收益”： 0,
“fromGrid”： 0,
“toGrid”： 0,
“specialLoad”： 0,
“selfUse”： 0
},
{
“时间”： “2024/5/5 1:00:00”,
“收益”： 0,
“fromGrid”： 0,
“toGrid”： 0,
“specialLoad”： 0,
“selfUse”： 0
},
{
“时间”： “2024/5/5 2:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 3:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 4:00:00",
"yield": 0,
"fromGrid": 0,
“toGrid”: 0,
“specialLoad”: 0,
“selfUse”: 0
},
{
“time”: “2024/5/5 5:00:00”,
“yield”: 0,
“fromGrid”: 0,
“toGrid”: 0,
“specialLoad”: 0,
“selfUse”: 0
},
{
“time”: “2024/5/5 6:00:00”,
“yield”: 0,
“fromGrid”: 0,
“toGrid”: 0,
“specialLoad”: 0,
"selfUse": 0
},
{
"time": "2024/5/5 7:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 8:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 9:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 10:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 11:00:00",
"yield": 0,
"fromGrid": 0,
“toGrid”: 0,
“specialLoad”: 0,
“selfUse”: 0
},
{
“time”: “2024/5/5 12:00:00”,
“yield”: 0,
“fromGrid”: 0,
“toGrid”: 0,
“specialLoad”: 0,
“selfUse”: 0
},
{
“time”: “2024/5/5 13:00:00”,
“yield”: 0,
“fromGrid”: 0,
“toGrid”: 0,
“specialLoad”: 0,
"selfUse": 0
},
{
"time": "2024/5/5 14:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 15:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 16:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 17:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 18:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 19:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 20:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 21:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 22:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 23:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
}
],
"successful": true,
"message": null
}