Como usar a nuvem IAMMETER com mais eficiência pela API

Premissa

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

Limite de API

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.

Obtenha o token da conta

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.

URL e método

Obtenha o token da conta que é usado em todas as APIs.

URL:https://www.iammeter.com/api/v1/user/login

Método:publicar

Dados

Resposta

O valor do token será usado em todas as APIs abaixo.

{
    "dados": {
        "id": 2025,
        "token": "349dfxxxxxxac5169",
        "refreshToken": "8adf75e5da10424985f3b83855133982"
    },
    "bem sucedido": verdadeiro,
    "mensagem": nulo
}

Obtenha o token diretamente do sistema web

Esse token também pode ser lido diretamente após você efetuar login no sistema.

Obtenha os dados de upload mais recentes e a hora UTC

Obtenha os últimos dados de upload com o SN considerado.

Não chame esta API mais de 12 vezes em uma hora.

URL e método

Básico (dados medidos): https://www.iammeter.com/api/v1/site/meterdata/{sn}

Avançado (meterdata2): https://www.iammeter.com/api/v1/site/meterdata2/{sn}

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)

Parâmetros

Resposta: monofásico -meterdata (sem fator de potência)

definição de valores: tensão, corrente, potência ativa, Kwh importado, Kwh exportado

{
    "dados": {
        "valores": [
            [
                230.220,
                1.300,
                119.000,
                1766.590,
                0,000
            ]
        ],
        "hora local": "2020/8/28 15:27:33",
        "gmtTime": "2020/8/28 5:27:33"
    },
    "bem sucedido": verdadeiro,
    "mensagem": nulo
}

Resposta: monofásico -meterdata2 (sem fator de potência)

definição de valores: tensão, corrente, potência ativa,fator de potência, Kwh importado, Kwh exportado

{
    "dados":{
        "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"
    },
    "bem sucedido":verdadeiro,
    "mensagem": null
}

Resposta: meterdata trifásico (sem fator de potência)

As três matrizes emvaloresrepresentam Fase A, fase B e Fase C.

Definição do elemento: tensão, corrente, potência ativa,fator de potência, Kwh importado, Kwh exportado

{
    "dados": {
        "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": "2020/8/28 15:30:48",
        "gmtTime": "2020/8/28 5:30:48"
    },
    "bem sucedido": verdadeiro,
    "mensagem": nulo
}

Resposta: trifásico -meterdata2 (com fator de potência)

{
    "dados":{
        "valores":[
            [//fase A
                233,8, // tensão
                0,03, // atual
                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
            ]
        ],
        "hora local":"2023/11/21 14:39:36",
        "gmtTime":"2023/11/21 6:39:36"
    },
    "bem sucedido":verdadeiro,
    "mensagem": null
}

Exemplo

Obtenha o registro do histórico

Retorne os dados históricos no intervalo e intervalo de tempo definidos.

• intervalo de tempo: último mês
• comprimento máximo de dados: 2.000 peças

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.

URL e método

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)

Parâmetros

Resposta: monofásico - meterdatalist

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
}

Resposta: trifásica - meterdatalist

{
    "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
}

Resposta: trifásica - meterdatalist2

{
    "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, // atual
                    4, //potência ativa
                    0,57, //fator de potência
                    210.21, //importar kWh
                    0 //Kwh exportado
                ],
                [//fase B
                    5,5,
                    0,
                    0,
                    0,
                    0,
                    0
                ],
                [ //fase C
                    3.3,
                    0,
                    0,
                    0,
                    0,
                    0
                ]
            ]
        },
        { //segundos dados
            "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
                ]
            ]
        },
        { //terceiros dados
            "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
                ]
            ]
        }
    ],
    "bem sucedido":verdadeiro,
    "mensagem": null
}

Exemplo

https://www.iammeter.com/api/v1/Site/MeterDataList/{yourSN}?token={yourToken}&startTime=2023-09-01&endTime=2023-09-07&interval=300

Análise de leitura poderosa

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 e método

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.

Parâmetros

Observação:

1. O intervalo de tempo máximo é de 7 dias no último mês.
2. O parâmetro time é opcional, caso não utilize o parâmetro a API retornará o resultado dos últimos 7 dias.

Resposta

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
}

Exemplo

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

https://www.iammeter.com/api/v1/site/powerAnalysis?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

Análise de status off-line

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 e método

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.

Parâmetros

Observação:

1. O intervalo de tempo máximo é de 7 dias no último mês.
2. O parâmetro time é opcional, caso não utilize o parâmetro a API retornará o resultado dos últimos 7 dias.
3. Se você não especificar o intervalo, o padrão será 5 minutos.

Resposta

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
}

Exemplo

Retornar o resultado da análise offline do dia especificado

https://www.iammeter.com/api/v1/site/offlineAnalysis?token={YourToken}&sn={YourSN}&starttime=2023-09-21&endtime=2023-09-21

Referência

API do medidor de energia WiFi

Medidor de energia WiFi trifásico

Use o medidor de energia trifásico da maneira que preferir