HTTPs

Por padrão, devices na Valeiot suportam protocolos HTTPs nativamente. Siga os passos abaixo para enviar dados utilizando HTTPs.

dica

A API Docs é uma referência essencial para ser utilizada junto com estas instruções. Atualmente ela não está disponível publicamente. Para solicitar acesso, envie um e-mail para support@valeiot.com.

HTTPs via Data Source Token

Este método permite adicionar data points a um data source (device ou entity) autenticando-se com seu Data Source Token.

1. Obtenha o Data Source Token (ex.: us1:v6MdpTWrvH508Y72o5D4sz3aMWR);
2. Na API Docs, localize o endpoint POST /datasource/datapoints;
3. Configure sua requisição:
   • Adicione o Authorization header com o Data Source Token (ex.: Bearer us1:v6MdpTWrvH508Y72o5D4sz3a).
   • Inclua os dados que serão inseridos no device no corpo JSON da requisição.
4. Envie a requisição. Se for bem-sucedida, você receberá uma resposta de confirmação semelhante ao exemplo abaixo:

Você também pode copiar e colar o exemplo de cURL abaixo em sua ferramenta de gerenciamento de API. Substitua os valores de exemplo (here) pelos seus próprios valores.

curl --request POST \
  --url https://api-here.valeiot.com/api/v1/datasource/datapoints \
  --header 'Authorization: Bearer here' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "value": "10",
    "variable": "temperature"
  }
]'

5. [EXTRA] Se a requisição não retornar uma resposta de sucesso, verifique os seguintes problemas comuns:
   • Authorization header: O token deve ser prefixado com Bearer. Exemplo: Bearer us1:xxxxx
   • Incorrect host: Certifique-se de que o host correto está sendo utilizado. No exemplo acima, o host é us1. Você pode determinar o host a partir do Data Source Token (ex.: us1:xxxxx).
   • Data format: Caso o seu payload não siga o formato de Valeiot Data Point, será necessário configurar um Payload Parser para adaptar os dados antes da inserção.

HTTPs via Network Token

Este método permite adicionar data points a um Data Source dentro de uma Network (grupo de Data Sources) autenticando-se com o Network Token.

1. Obtenha o Network Token da network à qual o device pertence (ex.: us1:R3dEnYKixxc99K25pp4gNcdg0zvL7gzmqvSGm3d6lOR4yxABfSaBFtqVKEY9eW);
2. Na API Docs, localize o endpoint POST /network/datasource/datapoints;
3. Configure sua requisição:
   • Adicione o Authorization header com o Network Token (ex.: Bearer us1:v6MdpTWrvH508Y72o5D4sz3a).
   • Adicione o DNID header.
   • Inclua os dados que serão inseridos no device no corpo JSON da requisição.
4. Envie a requisição. Se for bem-sucedida, você receberá uma resposta de confirmação semelhante ao exemplo abaixo:

Você também pode copiar e colar o exemplo de cURL abaixo em sua ferramenta de gerenciamento de API. Substitua os valores de exemplo (here) pelos seus próprios valores.

curl --request POST \
  --url https://api-here.valeiot.com/api/v1/network/datasource/datapoints \
  --header 'Authorization: Bearer here' \
  --header 'Content-Type: application/json' \
  --header 'DNID: here' \
  --data '[
  {
    "value": "11",
    "variable": "temperature"
  }
]'

5. [EXTRA] Se a requisição não retornar uma resposta de sucesso, verifique os seguintes problemas comuns:
   • Authorization header: O token deve ser prefixado com Bearer. Exemplo: Bearer us1:xxxxx
   • DNID header: O DNID deve corresponder ao DNID definido para o Data Source.
   • Incorrect host: Certifique-se de que o host correto está sendo utilizado. No exemplo acima, o host é us1. Você pode determinar o host a partir do Device Token (ex.: us1:xxxxx).
   • Data format: Caso o seu payload não siga o formato de Valeiot Data Point, será necessário configurar um Payload Parser para adaptar os dados antes da inserção.