IAMMETER-cloud proporciona algunas API y el desarrollador puede utilizar estas API para realizar algún trabajo interesante, como integrar los datos de IAMMETER a algún sistema de terceros. Antes abrimos estas API a nuestros socios comerciales y a algunos clientes importantes, pero ahora decidimos abrirlas a todos nuestros clientes.
Bienvenido a dejarnos saber su opinión en nuestro foro.https://imeter.club
La API no se puede visitar de forma ilimitada, limitaremos el recuento de llamadas diarias para cada API. No llame a la API con más frecuencia.
Si el recuento de llamadas excede la limitación horaria o diaria, la API no devolverá nada.
| No. | API | tipo de límite | Cada hora | Diario | Descripción |
|---|---|---|---|---|---|
| 1 | /inicio de sesión de usuario | IP | 5 | 30 | A una IP solo se le permitirá llamar a esta API 5 veces por hora. |
| 2 | /sitio/meterdata/ | SN | 12 | A un SN solo se le permitirá llamar a esta API 12 veces por hora. | |
| 3 | /sitio/análisis de potencia | SN | 5 | un SN solo podrá llamar a esta API 5 veces al día | |
| 4 | /sitio/análisis fuera de línea | SN | 5 | un SN solo podrá llamar a esta API 5 veces al día |
Devuelve el token de la cuenta. El token se utilizará en casi toda la API.
No es necesario llamar a esta API a menos que desee actualizar el token.No llame a esta API más de 5 veces en una hora y no más de 30 veces en un día.
Obtenga el token de la cuenta que se utiliza en todas las API.
URL:https://www.iammeter.com/api/v1/user/login
Método:correo
Esta API se puede probar en línea enIAMMETER SwaggerUI obtiene token
| No. | parámetro | Observación | Ejemplo |
|---|---|---|---|
| 1 | nombre de usuario | Nombre de usuario de IAMMETER | prueba |
| 2 | Contraseña | contraseña de IAMMETER | 123456 |
El valor del token se utilizará en todas las API siguientes.
{
"datos": {
"identificación": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"exitoso": cierto,
"mensaje": nulo
}Este token también se puede leer directamente después de iniciar sesión en el sistema.
Obtenga los últimos datos cargados con el SN considerado.
No llame a esta API más de 12 veces en una hora.
Básico (datos del medidor): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Esta API se puede probar en línea enIAMMETER SwaggerUI
Avanzado(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Esta API se puede probar en línea enDatos del medidor SwaggerUI de IAMMETERyIAMMETER SwaggerUI meterdata2
Método: CONSEGUIR
Límite: no solicite esta API más de 288 veces al día (intervalo de 5 minutos).
La diferencia entre básico y avanzado:
Básico: sin PF(Factor de potencia)
Avanzado: con PF (factor de potencia)
| nombre | Tipo | Ejemplo | |
|---|---|---|---|
| Simbólico | Cadena | xxx | requerido |
| tiempo de respuesta | Cadena | 2025-6-16 | opcional |
Definición de valores: voltaje, corriente, potencia activa, Kwh importados, Kwh exportados.
{
"datos": {
"valores": [
[
230.220, //voltaje
1.300, //corriente
119.000, //potencia activa
1766.590, //kWh importados
0.000 //kWh exportados
]
],
"hora local": "2020/8/28 15:27:33",
"hora gmt": "2020/8/28 5:27:33"
},
"éxito": verdadero,
"mensaje": nulo
}Definición de valores: voltaje, corriente, potencia activa.Factor de potencia,kWh importados, kWh exportados.
Si bien reconocemos que ubicar 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; tenga en cuenta este acuerdo.
{
"datos":{
"valores":[
[
233.41, //voltaje
0.718, //corriente
111, //potencia activa
0.66, //factor de potencia
5724.85, //energía importada
0 //energía exportada
]
],
"hora local":"2023/11/21 14:30:22",
"hora gmt":"2023/11/21 6:30:22"
},
"éxito":verdadero,
"mensaje":nulo
}Las tres matrices envaloresrepresentan la Fase A, la Fase B y la Fase C.
Definición de valores: voltaje, corriente, potencia activa, Kwh importados, Kwh exportados.
{
"datos": {
"valores": [
[
242.600,//tensión
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
]
],
"horalocal": "2020/8/28 15:30:48",
Hora GMT: 28/8/2020 5:30:48
},
"Correcto": verdadero,
"Mensaje": nulo
}Definición del elemento: voltaje, corriente, potencia activa,Factor de potencia,Kwh importados, Kwh exportados
{
"datos":{
"valores":[
[//fase A
233,8,//voltaje
0,03,//actual
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
]
],
"Hora local": "2023/11/21 14:39:36",
"gmtTime":"2023/11/21 6:39:36"
},
"exitoso": cierto,
"mensaje": nulo
}
El RTC (reloj de 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-16Esta solicitud devolverá el valor de los datos del medidor cargado más cercano a la fecha especificada (2025-6-16), es decir, el punto de tiempo registrado más cercano.
Nota: estas API son las mismas que las del capítulo anterior, solo agregan algunos parámetros más.
Devuelve los datos históricos en el intervalo y rango de tiempo establecidos.
Los datos instantáneos están en un intervalo de 1 minuto. Hay 60*24=1440 datos por día. Si solicita los datos históricos en un intervalo de 1 minuto, solo podrá solicitar los datos de 1,39 (2000/1440) días. Pero si solicita los datos en un intervalo de 5 minutos, puede solicitar los datos de casi 7 días.
Básico (lista de datos del medidor):https://www.iammeter.com/api/v1/site/meterdatalist/
**Avanzado(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
La diferencia entre básico y avanzado:
Básico: sin PF(Factor de potencia)
Avanzado: con PF (factor de potencia)
Esta API se puede probar en línea enDatos del medidor SwaggerUI de IAMMETERyIAMMETER SwaggerUI meterdata2
| nombre | Tipo | Ejemplo | |
|---|---|---|---|
| Simbólico | Cadena | xxx | requerido |
| intervalo | número | 300 | requerido, unidad: segundo |
| hora de inicio | Cadena | 2023-09-01 | requerido |
| hora de finalización | Cadena | 2023-09-07 | requerido |
Datos: [voltaje, corriente, potencia, importación de energía, exportación de energía, hora utc, hora local]
{
"datos": [
[
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"
]
],
"exitoso": cierto,
"mensaje": nulo
}{
"datos": [
[
230,//voltaje faseA
0,//actual
0,//potencia activa
468,41,//kWh importados
0,//kWh exportados
230,//FaseB
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"
]
],
"exitoso": cierto,
"mensaje": nulo
}{
"datos":[
{ //primeros datos
"rtcTime": "2023/9/1 0:00:22",
"gmtTime": "2023/8/31 16:00:22",
"valores":[
[ //fase A
235,2,//voltaje
0,03,//actual
4,//potencia activa
0,57,//factor de potencia
210,21,//importación Kwh
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",
"valores":[
[
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",
"valores":[
[
235,6,
0,03,
4,
0,57,
210.27,
0
],
[
5.5,
0,
0,
0,
0,
0
],
[
3.4,
0,
0,
0,
0,
0
]
]
}
],
"exitoso": cierto,
"mensaje": nulo
}
Devuelve el resultado del análisis de potencia en el tiempo especificado.
No llame a esta API más de 5 veces en un día.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Método: CONSEGUIR
Límite: No solicite esta API por SN más de 5 veces al día.
| nombre | Tipo | Ejemplo | |
|---|---|---|---|
SN |
Cadena | xxx | requerido |
hora de inicio |
Cadena | 2023-09-01 | opcional |
hora de finalización |
Cadena | 2023-09-07 | opcional |
Nota:
Average: lectura de potencia promedio durante este rango de tiempo.
AverageDaytime: lectura de energía promedio durante el día (8:00 a. m. a 8:00 p. m.) durante este rango de tiempo.
mínimo: lectura de potencia mínima durante este rango de tiempo.
máximo: lectura de potencia máxima durante este rango de tiempo.
{
"datos": {
"hora de inicio": "2023-09-01",
"hora final": "2023-09-07",
"promedio": 862,6,
"promedio diurno": 836,9,
"mínimo": 259,0,
"máximo": 3999,0
},
"exitoso": cierto,
"mensaje": nulo
}Devuelve el resultado del análisis de potencia de los últimos 7 días.
Devuelve el resultado del análisis de energía del día especificado.
Devuelve el estado de desconexión con el SN considerado en el tiempo especificado.
No llame a esta API más de 5 veces en un día.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Método：Conseguir
Límite: No solicite esta API por SN más de 5 veces al día.
| nombre | Tipo | Ejemplo | |
|---|---|---|---|
SN |
Cadena | xxxx | requerido |
hora de inicio |
Cadena | 2023-09-01 | opcional |
hora de finalización |
Cadena | 2023-09-07 | opcional |
intervalo(unidad: minuto) |
número | 5 | opcional |
Nota:
Hay un total de 10080 minutos en este rango de tiempo.
El tiempo total sin conexión es de 906 minutos en este rango de tiempo.
El intervalo sin conexión que es superior a 5 minutos aparece en la matriz.
{
"datos": {
"hora de inicio": "2023-09-05",
"hora final": "2023-09-11",
"Recuento fuera de línea": 906,
"Cuentatotal": 10080,
"lista": [
{
"hora de inicio": "2023/9/5 0:00:00",
"Hora de finalización": "2023/9/5 15:06:14",
"duración": 906
}
]
},
"exitoso": cierto,
"mensaje": nulo
}Devolver el resultado del análisis fuera de línea del día especificado
Devuelve el valor más reciente de todos los medidores de energía de esta cuenta.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Método：Conseguir
Límite: Asegúrese de no realizar solicitudes a esta API con más frecuencia que una vez cada 5 minutos.
| nombre | Tipo | Ejemplo | |
|---|---|---|---|
| Simbólico | Cadena | xxx | requerido |
{
"datos":[
{
"sn": "DA2BED94",
"valores":[
223,71,
1,74,
225,
14761.03,
0
],
"gmtTime":"2024/2/22 3:46:20"
},
{
"sn": "B384789C",
"valores":[
[
248,9,
13.9,
3356,
21228,
0,
nulo,
nulo
],
[
248,9,
13.9,
-2747,
8988,48,
18489,44,
nulo,
nulo
],
[
nulo,
nulo,
nulo,
nulo,
nulo,
nulo,
nulo
],
[
248,9,
13.9,
-2747,
8988,48,
18489,44,
nulo,
nulo
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn": "674B1E5D",
"valores":[
[
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",
"valores":[
[
245,3,
6.5,
1604,
46055.7,
0,
nulo,
nulo
],
[
245,3,
6.5,
-910,
15726,73,
8956.56,
nulo,
nulo
],
[
nulo,
nulo,
nulo,
nulo,
nulo,
nulo,
nulo
],
[
245,3,
6.5,
-910,
15726,73,
8956.56,
nulo,
nulo
]
],
"gmtTime":"2024/2/22 3:45:15"
},
{
"sn": "3FE34ABE",
"valores":[
[
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"
}
],
"exitoso": cierto,
"mensaje": nulo
}
Recuperar los valores de kWh horarios/diarios para la generación del inversor y el intercambio de red (tanto exportados como importados)
URL:https://www.iammeter.com/api/v1/site/energyhistory/?hora de inicio={2024-05-05}&hora de finalización={2024-07-07}&agrupar por=&Simbólico={2be6d1xxxxxxcc688}
Método: CONSEGUIR
Límite：
groupby = día: datos de 90 días (datos de 90 unidades)
groupby = hora: datos de 7 días (datos de 168 unidades)
| nombre | Tipo | des | Ejemplo | |
|---|---|---|---|---|
| Simbólico | Cadena | token de la cuenta | xxx | requerido |
| ID_lugar | número | identificación del lugar | requerido | |
| hora de inicio | Cadena | hora de inicio de esta devolución de API | 2023-09-01 | requerido |
| hora de finalización | Cadena | tiempo de parada de este retorno de API | 2023-09-07 | requerido |
| agrupar por | enumeración | seleccione el intervalo de datos de devolución (hora/día) | día/hora | requerido |
ID_lugar: Mis lugares->Editar
ID_lugar:1360
hora de inicio=2024-05-05
Hora de finalización = 2024-05-07
grupo por = día
{
"datos": [{
"hora": "2024/5/5 0:00:00",
"rendimiento": 0,
"desdeGrid": 9,62,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/6 0:00:00",
"rendimiento": 0,
"desdeGrid": 9.16,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
}
],
"exitoso": cierto,
"mensaje": nulo
}ID_lugar:2393
hora de inicio=2024-05-05
Hora de finalización = 2024-05-07
grupo por = día
{
"datos": [{
"hora": "2024/5/5 0:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/6 0:00:00",
"rendimiento": 0,1,
"fromGrid": 0,22,
"aGrid": 7.15,
"Carga especial": 0,
"Uso propio": 0
}
],
"exitoso": cierto,
"mensaje": nulo
}ID_lugar:2393
hora de inicio=2024-05-05
Hora de finalización = 2024-05-06
grupopor=hora
{
"datos": [{
"hora": "2024/5/5 0:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 1:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 2:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 3:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 4:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 5:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 6:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 7:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 8:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 9:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 10:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 11:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 12:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 13:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 14:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 15:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 16:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 17:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 18:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 19:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 20:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 21:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 22:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
},
{
"hora": "2024/5/5 23:00:00",
"rendimiento": 0,
"desdeGrid": 0,
"a la cuadrícula": 0,
"Carga especial": 0,
"Uso propio": 0
}
],
"exitoso": cierto,
"mensaje": nulo
}API del medidor de energía WiFi
¿Qué capacidades ofrece IAMMETER?
¿Qué tipo de contador eléctrico se adapta mejor a tus necesidades?
¿Cómo encontrar el medidor de potencia con respecto a sus 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)