IAMMETER-cloud proporciona algunas API, y los desarrolladores pueden usar estas API para realizar trabajos interesantes, como integrar los datos de IAMMETER en algún sistema de terceros. Anteriormente solo abríamos estas API a nuestros socios comerciales y algunos grandes clientes, pero ahora hemos decidido abrirlas a todos nuestros clientes.
Bienvenido a compartir tus opiniones en nuestro foro. https://imeter.club
La API no se puede visitar sin límite; limitaremos el recuento diario de llamadas para cada API. Por favor, no llames a la API con demasiada frecuencia.
Si el recuento de llamadas supera el límite horario o diario, la API no devolverá nada.
| No. | API | tipo de límite | por hora | diario | descripción |
|---|---|---|---|---|---|
| 1 | /user/login | ip | 5 | 30 | solo se permite que una IP llame a esta API 5 veces por hora |
| 2 | /site/meterdata/ | SN | 12 | solo se permite que un SN llame a esta API 12 veces por hora | |
| 3 | /site/powerAnalysis | SN | 5 | solo se permite que un SN llame a esta API 5 veces al día | |
| 4 | /site/offlineAnalysis | SN | 5 | solo se permite que un SN llame a esta API 5 veces al día |
Devuelve el token de la cuenta. El token se usará en casi todas las API.
No es necesario llamar a esta API a menos que desees actualizar el token. Por favor, no llames a esta API más de 5 veces en una hora, ni más de 30 veces en un día.
Obtén el token de la cuenta que se utiliza en todas las API.
URL: https://www.iammeter.com/api/v1/user/login
Método: post
Esta API se puede probar en línea en IAMMETER SwaggerUI get token
| No. | parámetro | observación | ejemplo |
|---|---|---|---|
| 1 | user name | Nombre de usuario de IAMMETER | test |
| 2 | password | Contraseña de IAMMETER | 123456 |
El valor del token se usará en todas las API siguientes.
{
"data": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"successful": true,
"message": null
}
Este token también se puede leer directamente después de iniciar sesión en el sistema.
Obtén los últimos datos de carga con el SN correspondiente.
Por favor, no llames a esta API más de 12 veces en una hora.
Básica (meterdata): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Esta API se puede probar en línea en IAMMETER SwaggerUI
Avanzada (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Esta API se puede probar en línea en IAMMETER SwaggerUI meterdata y IAMMETER SwaggerUI meterdata2
Método: GET
Límite: por favor, no solicites esta API más de 288 veces al día (intervalo de 5 minutos).
La diferencia entre básica y avanzada:
Básica: sin PF (factor de potencia)
Avanzada: con PF (factor de potencia)
| Nombre | Tipo | Ejemplo | |
|---|---|---|---|
| Token | String | xxx | requerido |
| rtctime | string | 2025-6-16 | opcional |
definición de valores: voltaje, corriente, potencia activa, kWh importados, kWh exportados
{
"data": {
"values": [
[
230.220, //voltaje
1.300, //corriente
119.000,//potencia activa
1766.590, //kWh importados
0.000 //kWh exportados
]
],
"localTime": "2020/8/28 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"successful": true,
"message": null
}
definición de valores: voltaje, corriente, potencia activa, factor de potencia, kWh importados, kWh exportados.
Si bien reconocemos que colocar el factor de potencia entre la potencia activa y la energía importada no es óptimo, el formato actual ya está configurado de esta manera; ten en cuenta esta disposición.
{
"data":{
"values":[
[
233.41, //voltaje
0.718,//corriente
111,//potencia activa
0.66,//factor de potencia
5724.85, //energía importada
0 //energía exportada
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"successful":true,
"message":null
}
Los tres arrays en values representan la Fase A, la Fase B y la Fase C.
definición de valores: voltaje, corriente, potencia activa, kWh importados, kWh exportados
{
"data": {
"values": [
[
242.600,//voltaje
1.000,//corriente
216.000,//potencia activa
32354.600,//energía importada
0.000//energía exportada
],
[
242.600,
1.000,
1986.000,
30536.410,
17704.720
],
[
0.000,
0.000,
0.000,
0.000,
0.000
]
],
"localTime": "2020/8/28 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"successful": true,
"message": null
}
Definición de elementos: voltaje, corriente, potencia activa, factor de potencia, kWh importados, kWh exportados
{
"data":{
"values":[
[//fase A
233.8,//voltaje
0.03,//corriente
4,//potencia activa
0.57,//factor de potencia
222.53,//kWh importados
0 //kWh exportados
],
[//fase B
5,
0,
0,
0,
0,
0
],
[ //fase C
3.1,
0,
0,
0,
0,
0
]
],
"localTime":"2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"successful":true,
"message":null
}
El RTC (Reloj en Tiempo Real) también es un parámetro en la solicitud HTTP GET, como se muestra a continuación:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16
Esta solicitud devolverá el valor de datos del medidor cargado más cercano a la fecha especificada (2025-6-16), es decir, el punto de tiempo registrado más próximo.
Nota: estas API son las mismas que las del capítulo anterior, solo se añaden algunos parámetros más.
Devuelve los datos históricos en el intervalo y rango de tiempo configurados.
Los datos instantáneos tienen un intervalo de 1 minuto. Hay 60*24=1440 datos por día. Si solicitas los datos históricos con un intervalo de 1 minuto, solo puedes solicitar los datos de 1,39 (2000/1440) días. Pero si solicitas los datos con un intervalo de 5 minutos, puedes solicitar los datos de casi 7 días.
Básica (meterdatalist): https://www.iammeter.com/api/v1/site/meterdatalist/{sn}
Avanzada (meterdatalist2): https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
La diferencia entre básica y avanzada:
Básica: sin PF (factor de potencia)
Avanzada: con PF (factor de potencia)
Esta API se puede probar en línea en IAMMETER SwaggerUI meterdata y IAMMETER SwaggerUI meterdata2
| Nombre | Tipo | Ejemplo | |
|---|---|---|---|
| Token | String | xxx | requerido |
| interval | number | 300 | requerido, unidad: segundos |
| startTime | string | 2023-09-01 | requerido |
| endTime | string | 2023-09-07 | requerido |
Datos: [voltaje, corriente, potencia, energía importada, energía exportada, hora UTC, hora local]
{
"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"
]
],
"successful": true,
"message": null
}
{
"data": [
[
230,//voltaje fase A
0,//corriente
0,//potencia activa
468.41,//kWh importados
0,//kWh exportados
230,//Fase B
0,
0,
236.58,
290.77,
230,//Fase 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"
]
],
"successful": true,
"message": null
}
{
"data":[
{ //primer dato
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"values":[
[ //fase A
235.2,//voltaje
0.03,//corriente
4,//potencia activa
0.57,//factor de potencia
210.21,//kWh importados
0 //kWh exportados
],
[//fase B
5.5,
0,
0,
0,
0,
0
],
[ //fase C
3.3,
0,
0,
0,
0,
0
]
]
},
{ //segundo dato
"rtcTime":"2023/9/1 8:00:49",
"gmtTime":"2023/9/1 0:00:49",
"values":[
[
233.4,
0.03,
4,
0.57,
210.24,
0
],
[
5.4,
0,
0,
0,
0,
0
],
[
3.3,
0,
0,
0,
0,
0
]
]
},
{ //tercer dato
"rtcTime":"2023/9/1 16:00:24",
"gmtTime":"2023/9/1 8:00:24",
"values":[
[
235.6,
0.03,
4,
0.57,
210.27,
0
],
[
5.5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"successful":true,
"message":null
}
Devuelve el resultado del análisis de potencia en el tiempo especificado.
Por favor, no llames a esta API más de 5 veces al día.
URL: https://www.iammeter.com/api/v1/site/powerAnalysis
Método: get
Límite: por favor, no solicites esta API por SN más de 5 veces al día.
| Nombre | Tipo | Ejemplo | |
|---|---|---|---|
sn |
String | xxx | requerido |
startTime |
String | 2023-09-01 | opcional |
endTime |
String | 2023-09-07 | opcional |
Nota:
average: lectura de potencia promedio durante este rango de tiempo.
averageDaytime: lectura de potencia promedio durante el día (8:00 a. m. - 8:00 p. m.) en este rango de tiempo.
minimum: lectura de potencia mínima durante este rango de tiempo.
maximum: lectura de potencia máxima durante este rango de tiempo.
{
"data": {
"startTime": "2023-09-01",
"endTime": "2023-09-07",
"average": 862.6,
"averageDaytime": 836.9,
"minimum": 259.0,
"maximum": 3999.0
},
"successful": true,
"message": null
}
Devuelve el resultado del análisis de potencia de los últimos 7 días.
Devuelve el resultado del análisis de potencia del día especificado.
Devuelve el estado de desconexión con el SN especificado en el tiempo indicado.
Por favor, no llames a esta API más de 5 veces al día.
URL: https://www.iammeter.com/api/v1/site/offlineAnalysis
Método: Get
Límite: por favor, no solicites esta API por SN más de 5 veces al día.
| Nombre | Tipo | Ejemplo | |
|---|---|---|---|
sn |
String | xxxx | requerido |
startTime |
String | 2023-09-01 | opcional |
endTime |
String | 2023-09-07 | opcional |
interval (unidad: minuto) |
Number | 5 | opcional |
Nota:
Hay un total de 10080 minutos en este rango de tiempo.
El tiempo total fuera de línea es de 906 minutos en este rango de tiempo.
Los intervalos de desconexión mayores a 5 minutos se enumeran en el array.
{
"data": {
"startTime": "2023-09-05",
"endTime": "2023-09-11",
"offlineCount": 906,
"totalCount": 10080,
"list": [
{
"startTime": "2023/9/5 0:00:00",
"endTime": "2023/9/5 15:06:14",
"duration": 906
}
]
},
"successful": true,
"message": null
}
Devuelve el resultado del análisis fuera de línea del día especificado.
Devuelve el último valor de todos los medidores de energía en esta cuenta.
URL: https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Método: Get
Límite: asegúrate de no realizar solicitudes a esta API con más frecuencia de una vez cada 5 minutos.
| Nombre | Tipo | Ejemplo | |
|---|---|---|---|
| Token | String | xxx | requerido |
{
"data":[
{
"sn":"DA2BED94",
"values":[
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"
}
],
"successful":true,
"message":null
}
Recupera los valores de kWh por hora/día para la generación del inversor y el intercambio con la red (tanto exportados como importados).
Método: get
Límite:
groupby = day: 90 días de datos (90 datos)
groupby = hour: 7 días de datos (168 datos)
| Nombre | Tipo | Descripción | Ejemplo | |
|---|---|---|---|---|
| Token | String | token de la cuenta | xxx | requerido |
| place_ID | number | ID del lugar | requerido | |
| startTime | string | hora de inicio que devuelve esta API | 2023-09-01 | requerido |
| endTime | string | hora de finalización que devuelve esta API | 2023-09-07 | requerido |
| groupby | enum | seleccionar intervalo de datos devueltos (hora/día) | day/hour | requerido |
place_ID: Mis Lugares → Editar
place_id: 1360
startTime=2024-05-05
endTime=2024-05-07
groupby=day
{
"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,
"message": null
}
place_id: 2393
startTime=2024-05-05
endTime=2024-05-07
groupby=day
{
"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,
"message": null
}
place_id: 2393
startTime=2024-05-05
endTime=2024-05-06
groupby=hour
{
"data": [{
"time": "2024/5/5 0:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "2024/5/5 1:00:00",
"yield": 0,
"fromGrid": 0,
"toGrid": 0,
"specialLoad": 0,
"selfUse": 0
},
{
"time": "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
}
API del medidor de energía WiFi
¿Qué capacidades ofrece IAMMETER?
¿Qué tipo de medidor eléctrico se adapta mejor a tus necesidades?
Cómo encontrar el medidor de potencia según tus requisitos
Medidor de energía Wi-Fi trifásico (WEM3080T)
Medidor de energía Wi-Fi monofásico (WEM3080)
Medidor de energía Wi-Fi trifásico (WEM3046T)
Medidor de energía Wi-Fi trifásico (WEM3050T)