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
| 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}
Avanzado(meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
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 |
Definición de valores: voltaje, corriente, potencia activa, Kwh importados, Kwh exportados.
{
"datos": {
"valores": [
[
230.220,
1.300,
119.000,
1766.590,
0.000
]
],
"hora local": "28/8/2020 15:27:33",
"gmtTime": "2020/8/28 5:27:33"
},
"exitoso": cierto,
"mensaje": nulo
}Definición de valores: voltaje, corriente, potencia activa.Factor de potencia,Kwh importados, Kwh exportados
{
"datos":{
"valores":[
[
233,41,
0,718,
111,
0,66,
5724,85,
0
]
],
"hora local": "2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"exitoso": cierto,
"mensaje": nulo
}Las tres matrices envaloresrepresentan la Fase A, la Fase B y la Fase C.
Definición del elemento: voltaje, corriente, potencia activa,Factor de potencia,Kwh importados, Kwh exportados
{
"datos": {
"valores": [
[
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
]
],
"hora local": "28/8/2020 15:30:48",
"gmtTime": "2020/8/28 5:30:48"
},
"exitoso": cierto,
"mensaje": nulo
}{
"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
}
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)
| 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
API del medidor de energía WiFi
Medidor de energía Wi-Fi trifásico
Medidor de energía Wi-Fi monofásico