IAMMETER-cloud提供了一些API，开发者可以使用这些API来做一些有趣的工作，比如将IAMMETER的数据集成到一些第三方系统中。 之前我们只是向我们的业务合作伙伴和一些大客户开放这些API，但现在决定向我们所有的客户开放。
欢迎在我们的论坛上告诉我们您的想法。https://imeter.club
该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次 |
返回账户的token。 该令牌将用于几乎所有 API。
除非您需要刷新令牌，否则不需要调用此接口。一小时内调用该接口的次数不要超过5次，一天内调用该接口的次数不要超过30次。
获取所有 API 中使用的帐户的令牌。
网址：https://www.iammeter.com/api/v1/user/login
方法：邮政
| 不。 | 范围 | 评论 | 例子 |
|---|---|---|---|
| 1 | 用户名 | IAMMETER的用户名 | 测试 |
| 2 | 密码 | IAMMETER密码 | 123456 |
令牌值将在以下所有 API 中使用。
{
“数据”：{
“id”：2025，
“令牌”：“349dfxxxxxxac5169”，
“refreshToken”：“8adf75e5da10424985f3b83855133982”
},
“成功”：真实，
“消息”：空
}登录系统后也可以直接读取此令牌。
获取对应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”
},
“成功”：真实，
“消息”：空
}数值定义：电压、电流、有功功率、功率因数,进口千瓦时,出口千瓦时
{
“数据”：{
“值”：[
[
233.41,
0.718,
111、
0.66,
5724.85,
0
]
],
"localTime":"2023/11/21 14:30:22",
“gmtTime”:“2023/11/21 6:30:22”
},
“成功”：真实，
“消息”：空
}中的三个数组价值观分别表示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”
},
“成功”：真实，
“消息”：空
}{
“数据”：{
“值”：[
[//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”
},
“成功”：真实，
“消息”：空
}
返回设定的时间间隔和时间范围内的历史数据。
即时数据以 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 | 必需的 |
数据：[电压、电流、功率、进口电量、出口电量、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”
]
],
“成功”：真实，
“消息”：空
}{
“数据”：[
[
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”
]
],
“成功”：真实，
“消息”：空
}{
“数据”：[
{ //第一个数据
“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
]
]
}
],
“成功”：真实，
“消息”：空
}
返回指定时间内的功率分析结果。
一天内调用该接口的次数不要超过5次。
网址：https://www.iammeter.com/api/v1/site/powerAnalysis
方法： 得到
限制：每个SN每天请求该API的次数不要超过5次。
| 姓名 | 类型 | 例子 | |
|---|---|---|---|
锡 |
细绳 | xxx | 必需的 |
开始时间 |
细绳 | 2023-09-01 | 选修的 |
时间结束 |
细绳 | 2023-09-07 | 选修的 |
笔记：
平均值：该时间范围内的平均功率读数。
AverageDaytime：该时间范围内的平均日间（8:00am-8:00pm）功率读数。
最小值：该时间范围内的最小功率读数。
最大值：该时间范围内的最大功率读数。
{
“数据”：{
“开始时间”：“2023-09-01”，
“结束时间”：“2023-09-07”，
“平均”：862.6，
“平均白天”：836.9，
“最小值”：259.0，
“最大”：3999.0
},
“成功”：真实，
“消息”：空
}返回最近7天的功率分析结果。
返回指定日期的功率分析结果
返回指定时间内对应SN的断线状态。
一天内调用该接口的次数不要超过5次。
网址：https://www.iammeter.com/api/v1/site/offlineAnalysis
方法：得到
限制：每个SN每天请求该API的次数不要超过5次。
| 姓名 | 类型 | 例子 | |
|---|---|---|---|
锡 |
细绳 | xxxx | 必需的 |
开始时间 |
细绳 | 2023-09-01 | 选修的 |
时间结束 |
细绳 | 2023-09-07 | 选修的 |
间隔（单位：分钟） |
数字 | 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
}
]
},
“成功”：真实，
“消息”：空
}返回指定日期的离线分析结果
