ACESSO À REST API (NETWORK SERVER)

Introdução

Para se conectar à REST-API de maneira a recuperar os dados através do banco de dados do Network Server, é necessário que a aplicação faça uma requisição HTTP (Hypertext Transfer Protocol) do tipo GET. É através desta requisição em determinada URL (Uniform Resource Locator, isto é, endereço de recurso disponível) que será permitida a recuperação dos dados para se realizar um gráfico de histórico, bem como uma gravação de backup para o banco de dados da própria aplicação.

Protocolo URL

Através da requisição, deverá ser realizado um comando do tipo GET na seguinte URL:

https://smartcampus.maua.br/api/index.php/{appSkey}/{#requisições}/{dev_EUI}

Em que os parâmetros descritos devem ser preenchidos segundo o exemplo abaixo:

appSkey: string de 32 bytes referente à chave da aplicação gerada na ativação do end-node. Neste caso, segundo a criação do end-node Hidrometro-01 na aplicação Hidrometros, a chave corresponde a 2b7e151628aed2a6abf7158809cf4f3c;
#requisições: variável (do tipo inteiro) de registros a serem recuperados do banco de dados em ordem decrescente;
dev_EUI: Número correspondente ao end-device unique identifier de cada end-node cadastrado no Network Server.

Como um exemplo de requisição para o end-node Hidrometro-01 de maneira a recuperar o último registro enviado do end-node ao servidor, tem-se: https://smartcampus.maua.br/api/index.php/2b7e151628aed2a6abf7158809cf4f3c/1/0004a30b001a5ea1

Retorno json

Como resultado desta requisição, obtém-se o seguinte retorno, no formato catacterístico JSON:

logs:
- 0:
  - created_at: “2018-03-07 13:34:44.961006-03“,
  - dev_eui: “0004a30b001a5ea1“,
  - fCnt: 196,
  - fPort: 100,
  - rx_info_set:
    - 0:
      - mac: “7276ff00080801db“,
      - rssi: -108,
      - size: 20,
      - time: “0001-01-01T00:00:00Z“,
      - channel: 3,
      - loRaSNR: 8.2,
      - rfChain: 0,
      - codeRate: “4/5”,
      - dataRate:
        
        bandwidth: 125,
        
        modulation: “LORA“,
        
        spreadFactor: 7
      - crcStatus: 1,
      - frequency: 902900000,
      - timestamp: 3308224083,
  - phy_payload: “40d242ba0680c4006468ff8328c3614d583b1500”,
  - data_payload: “0b023d900c0cc9”

Os campos úteis que trazem consigo informações do pacote de informações enviado pelo end-node são os campos created_at data da criação do registro no servidor), fCnt (frame count, isto é, contador de frames enviados do node ao servidor) e data_payload em que efetivamente se tem o dado enviado pelo end-node. A este campo deve-se recuperar o dado equivalente de maneira idêntica ao enviado pelo end-node. No caso de se enviar um dado e padronizá-lo junto ao Smart Campus, deve-se ter conhecimento o padrão do Protocolo IoT Mauá.