IAMMETER-cloud fornece algumas APIs, e o desenvolvedor pode usar essas APIs para fazer alguns trabalhos interessantes, como integrar os dados do IAMMETER a algum sistema de terceiros. Acabamos de abrir essas APIs para nossos parceiros de negócios e alguns grandes clientes, mas decidimos abri-las para todos os nossos clientes agora.
Bem-vindo a nos contar sua opinião em nosso fórum.https://imeter.club
A API não pode ser visitada ilimitadamente, limitaremos a contagem diária de chamadas para cada API. Por favor, não chame a API com mais frequência.
Se a contagem de chamadas exceder o limite horário ou diário, a API não retornará nada.
| Não. | API | tipo de limite | de hora em hora | Diário | descrição |
|---|---|---|---|---|---|
| 1 | /login de usuário | IP | 5 | 30 | um IP só pode chamar esta API 5 vezes por hora |
| 2 | /site/meterdata/ | SN | 12 | um SN só pode chamar esta API 12 vezes por hora | |
| 3 | /site/powerAnalysis | SN | 5 | um SN só pode chamar esta API 5 vezes ao dia | |
| 4 | /site/offlineAnálise | SN | 5 | um SN só pode chamar esta API 5 vezes ao dia |
Devolva o token da conta. O token será usado em quase toda a API.
Você não precisa chamar essa API, a menos que queira atualizar o token.Não chame esta API mais de 5 vezes em uma hora e não mais de 30 vezes em um dia.
Obtenha o token da conta que é usado em todas as APIs.
URL:https://www.iammeter.com/api/v1/user/login
Método:publicar
Esta API pode ser testada online emIAMMETER SwaggerUI obtém token
| Não. | parâmetro | observação | exemplo |
|---|---|---|---|
| 1 | nome de usuário | Nome de usuário IAMMETER | teste |
| 2 | senha | senha do IAMMETER | 123456 |
O valor do token será usado em todas as APIs abaixo.
{
"dados": {
"id": 2025,
"token": "349dfxxxxxxac5169",
"refreshToken": "8adf75e5da10424985f3b83855133982"
},
"bem sucedido": verdadeiro,
"mensagem": nulo
}Esse token também pode ser lido diretamente após você efetuar login no sistema.
Obtenha os últimos dados de upload com o SN considerado.
Não chame esta API mais de 12 vezes em uma hora.
Básico (dados medidos): https://www.iammeter.com/api/v1/site/meterdata/{sn}
Esta API pode ser testada online emIAMMETER SwaggerUI
Avançado (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}
Esta API pode ser testada online emDados do medidor IAMMETER SwaggerUIeIAMMETER SwaggerUI meterdata2
Método: PEGAR
Limite: não solicite esta API mais de 288 vezes por dia (intervalo de 5 minutos).
A diferença entre básico e avançado:
Básico: sem PF (fator de potência)
Avançado: com PF (fator de potência)
| Nome | Tipo | Exemplo | |
|---|---|---|---|
| Símbolo | Corda | xxx | obrigatório |
| tempo real | corda | 2025-6-16 | opcional |
definição de valores: tensão, corrente, potência ativa, kWh importado, kWh exportado
{
"dados": {
"valores": [
[
230.220, //tensão
1.300, //corrente
119.000, //potência ativa
1766.590, //kWh importados
0.000 //kWh exportados
]
],
"HoraLocal": "28/08/2020 15:27:33",
"HoraGMT": "28/08/2020 5:27:33"
},
"sucesso": verdadeiro,
"mensagem": nulo
}definição de valores: tensão, corrente, potência ativa,fator de potência,kWh importado, kWh exportado.
Embora reconheçamos que a colocação do fator de potência entre a potência ativa e a energia importada não é ideal, o formato atual já está configurado dessa forma - esteja ciente desse arranjo
{
"dados":{
"valores":[
[
233,41, //tensão
0,718, //corrente
111, //potência ativa
0,66, //fator de potência
5724,85, //energia importada
0 //energia exportada
]
],
"localTime":"2023/11/21 14:30:22",
"gmtTime":"2023/11/21 6:30:22"
},
"sucesso":verdadeiro,
"mensagem":nulo
}As três matrizes emvaloresrepresentam Fase A, fase B e Fase C.
definição de valores: tensão, corrente, potência ativa, kWh importado, kWh exportado
{
"dados": {
"valores": [
[
242.600,//tensão
1.000,//corrente
216.000,//potência ativa
32354.600,//energia importada
0.000//energia 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",
"gmtTime": "2020/8/28 5:30:48"
},
"sucesso": verdadeiro,
"mensagem": nulo
}Definição do elemento: tensão, corrente, potência ativa,fator de potência,kWh importado, kWh exportado
{
"dados":{
"valores":[
[//fase A
233,8,//tensão
0,03,//corrente
4,//potência ativa
0,57,//fator de potência
222,53,//kWh importado
0 //kWh exportado
],
[//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"
},
"sucesso":true,
"mensagem":null
}
O RTC (Real-Time Clock) também é um parâmetro na solicitação HTTP GET, conforme mostrado abaixo:
https://www.iammeter.com/api/v1/site/meterdata/59C9AB8D?token=336c9cbebcbf49139f0be060cc7ba7fd&rtctime=2025-6-16Esta solicitação retornará o valor dos dados do medidor carregado mais próximo da data especificada (2025-6-16), ou seja, o ponto de tempo registrado mais próximo.
Nota: essas APIs são as mesmas do capítulo anterior, apenas adicionam mais alguns parâmetros
Retorne os dados históricos no intervalo e intervalo de tempo definidos.
Os dados instantâneos estão em intervalo de 1 minuto. Existem 60*24=1440 dados por dia. Se você solicitar os dados históricos em intervalos de 1 minuto, poderá solicitar apenas os dados de 1,39 (2000/1440) dias. Mas se você solicitar os dados em intervalos de 5 minutos, poderá solicitar os dados de quase 7 dias.
Básico (meterdatalista): https://www.iammeter.com/api/v1/site/meterdatalist/
**Avançado(meterdatalist2):**https://www.iammeter.com/api/v1/site/meterdatalist2/{sn}
A diferença entre básico e avançado:
Básico: sem PF (fator de potência)
Avançado: com PF (fator de potência)
Esta API pode ser testada online emDados do medidor IAMMETER SwaggerUIeIAMMETER SwaggerUI meterdata2
| Nome | Tipo | Exemplo | |
|---|---|---|---|
| Símbolo | Corda | xxx | obrigatório |
| intervalo | número | 300 | obrigatório, unidade: segundo |
| hora de início | corda | 2023-09-01 | obrigatório |
| Fim do tempo | corda | 2023-09-07 | obrigatório |
Dados:[tensão, corrente, potência, importação de energia, exportação de energia, hora UTC, hora local]
{
"dados": [
[
227,73,
1,45,
172,
13121,56,
0,
"2023/9/12 0:00:34",
"2023/09/11 14:00:34"
],
[
229,43,
1,45,
172,
13121,56,
0,
"2023/9/12 0:01:33",
"2023/09/11 14:01:33"
]
],
"bem sucedido": verdadeiro,
"mensagem": nulo
}{
"dados": [
[
230, // tensão fase A
0, // atual
0, //potência ativa
468,41, // kWh importado
0, // kWh exportado
230, //Fase B
0,
0,
236,58,
290,77,
230,//Fase C
0,
0,
258,62,
0,
"2023/9/12 0:00:15",
"2023/09/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/09/11 16:02:08"
]
],
"bem sucedido": verdadeiro,
"mensagem": nulo
}{
"dados":[
{ //primeiros dados
"rtcTime":"2023/9/1 0:00:22",
"gmtTime":"2023/8/31 16:00:22",
"valores":[
[ //fase A
235,2,//tensão
0,03,//corrente
4,//potência ativa
0,57,//fator de potência
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 dado
"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,
0
]
]
},
{ //terc dado
"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
]
]
}
],
"sucesso":verdadeiro,
"mensagem":nulo
}
Retorne o resultado da análise de potência no tempo especificado.
Por favor, não chame esta API mais de 5 vezes em um dia.
URL:https://www.iammeter.com/api/v1/site/powerAnalysis
Método: pegar
Limite: Por favor, não solicite esta API por SN mais de 5 vezes por dia.
| Nome | Tipo | Exemplo | |
|---|---|---|---|
sn |
Corda | xxx | obrigatório |
hora de início |
Corda | 2023-09-01 | opcional |
Fim do tempo |
Corda | 2023-09-07 | opcional |
Observação:
média: leitura de potência média durante este intervalo de tempo.
AverageDaytime: leitura média de potência diurna (8h00-20h00) durante esse intervalo de tempo.
mínimo: leitura de potência mínima durante este intervalo de tempo.
máximo: leitura de potência máxima durante este intervalo de tempo.
{
"dados": {
"hora de início": "01/09/2023",
"horário final": "07/09/2023",
"média": 862,6,
"média diurna": 836,9,
"mínimo": 259,0,
"máximo": 3999,0
},
"bem sucedido": verdadeiro,
"mensagem": nulo
}Retorne o resultado da análise de potência dos últimos 7 dias.
Retornar o resultado da análise de potência do dia especificado
Retorna o status de desconexão com o SN considerado no tempo especificado.
Por favor, não chame esta API mais de 5 vezes em um dia.
URL：https://www.iammeter.com/api/v1/site/offlineAnalysis
Método：Pegar
Limite: Por favor, não solicite esta API por SN mais de 5 vezes por dia.
| Nome | Tipo | Exemplo | |
|---|---|---|---|
sn |
Corda | xxxx | obrigatório |
hora de início |
Corda | 2023-09-01 | opcional |
Fim do tempo |
Corda | 2023-09-07 | opcional |
intervalo(unidade: minuto) |
Número | 5 | opcional |
Observação:
Há um total de 10.080 minutos neste intervalo de tempo.
O tempo off-line total é de 906 minutos nesse intervalo de tempo.
O intervalo offline superior a 5 minutos é listado na matriz.
{
"dados": {
"hora de início": "05/09/2023",
"horário final": "11/09/2023",
"contagem off-line": 906,
"contagem total": 10080,
"lista": [
{
"startTime": "2023/9/5 0:00:00",
"horário final": "2023/9/5 15:06:14",
"duração": 906
}
]
},
"bem sucedido": verdadeiro,
"mensagem": nulo
}Retornar o resultado da análise offline do dia especificado
Retorne o valor mais recente de todos os medidores de energia desta conta.
URL：https://www.iammeter.com/api/v1/site/metersdata?token=xxx
Método：Pegar
Limite: certifique-se de não fazer solicitações a esta API com mais frequência do que uma vez a cada 5 minutos.
| Nome | Tipo | Exemplo | |
|---|---|---|---|
| Símbolo | Corda | xxx | obrigatório |
{
"dados":[
{
"sn":"DA2BED94",
"valores":[
223,71,
1,74,
225,
14761.03,
0
],
"gmtTime":"2024/02/22 3:46:20"
},
{
"sn":"B384789C",
"valores":[
[
248,9,
13,9,
3356,
21228,
0,
nulo,
nulo
],
[
248,9,
13,9,
-2747,
8.988,48,
18489,44,
nulo,
nulo
],
[
nulo,
nulo,
nulo,
nulo,
nulo,
nulo,
nulo
],
[
248,9,
13,9,
-2747,
8.988,48,
18489,44,
nulo,
nulo
]
],
"gmtTime":"2024/02/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/02/22 3:45:50"
},
{
"sn":"59C9AB8D",
"valores":[
[
245,3,
6,5,
1604,
46055,7,
0,
nulo,
nulo
],
[
245,3,
6,5,
-910,
15726,73,
8.956,56,
nulo,
nulo
],
[
nulo,
nulo,
nulo,
nulo,
nulo,
nulo,
nulo
],
[
245,3,
6,5,
-910,
15726,73,
8.956,56,
nulo,
nulo
]
],
"gmtTime":"2024/02/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"
}
],
"bem sucedido":verdadeiro,
"mensagem": null
}
Recuperar os valores kWh horários/diários para geração de inversores e troca de rede (exportados e importados)
URL：https://www.iammeter.com/api/v1/site/energyhistory/?hora de início={2024-05-05}&Fim do tempo={2024-07-07}&agrupar por=&Símbolo={2be6d1xxxxxxcc688}
Método: pegar
Limite：
groupby = dia: dados de 90 dias (dados de 90 unidades)
groupby = hora: dados de 7 dias (dados de 168 unidades)
| Nome | Tipo | Des | Exemplo | |
|---|---|---|---|---|
| Símbolo | Corda | token da conta | xxx | obrigatório |
| local_ID | número | ID do lugar | obrigatório | |
| hora de início | corda | hora de início deste retorno da API | 2023-09-01 | obrigatório |
| Fim do tempo | corda | hora de parada deste retorno da API | 2023-09-07 | obrigatório |
| grupo | enumeração | selecione o intervalo de dados de retorno (hora/dia) | dia/hora | obrigatório |
ID do local: Meus lugares->Editar
id_local:1360
hora de início=05/05/2024
hora final = 07/05/2024
groupby=dia
{
"dados": [{
"horário": "2024/5/5 0:00:00",
"rendimento": 0,
"da grade": 9,62,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/6 0:00:00",
"rendimento": 0,
"da grade": 9,16,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
}
],
"bem sucedido": verdadeiro,
"mensagem": nulo
}id_local:2393
hora de início=05/05/2024
hora final = 07/05/2024
groupby=dia
{
"dados": [{
"horário": "2024/5/5 0:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/6 0:00:00",
"rendimento": 0,1,
"da grade": 0,22,
"para grade": 7,15,
"carga especial": 0,
"selfUse": 0
}
],
"bem sucedido": verdadeiro,
"mensagem": nulo
}id_local:2393
hora de início=05/05/2024
hora final = 06/05/2024
groupby = hora
{
"dados": [{
"horário": "2024/5/5 0:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 1:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 2:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 3:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 4:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 5:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 6:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 7:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 8:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 9:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 10:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 11:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 12:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 13:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 14:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 15:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 16:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 17:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 18:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 19:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 20:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 21:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"hora": "2024/5/5 22:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
},
{
"horário": "2024/5/5 23:00:00",
"rendimento": 0,
"fromGrid": 0,
"paraGrid": 0,
"carga especial": 0,
"selfUse": 0
}
],
"bem sucedido": verdadeiro,
"mensagem": nulo
}API do medidor de energia WiFi
Quais recursos o IAMMETER oferece?
Qual tipo de medidor elétrico melhor atende às suas necessidades?
Como encontrar o medidor de energia em relação às suas necessidades
Medidor de energia Wi-Fi trifásico (WEM3080T)
Medidor de energia Wi-Fi monofásico (WEM3080)
Medidor de energia Wi-Fi trifásico (WEM3046T)
Medidor de energia Wi-Fi trifásico (WEM3050T)