Enviando Dados*

*Aguarde — ainda estamos trabalhando nisso!

Visão Geral

HTTPs

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

dica

A API docs é uma referência essencial para ser usada junto com estas instruções.

HTTPs via Data Source Token

Este método permite adicionar pontos de dados a um Data Source (dispositivo ou entidade) autenticando com o 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 a serem inseridos no dispositivo no corpo JSON.
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 placeholders (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. Por exemplo: Bearer us1:xxxxx
   • Incorrect host: Certifique-se de que o host correto está sendo usado. No exemplo acima, o host é us1. Você pode determinar o host a partir do Data Source Token (ex.: us1:xxxxx).
   • Data format: Se o payload não estiver no formato Valeiot Data Point, você deve configurar um Payload Parser para adaptar os dados recebidos antes da inserção.

HTTPs via Network Token

Este método permite adicionar pontos de dados a um Data Source dentro de uma Network (grupo de Data Sources) autenticando com o Network Token.

1. Obtenha o Network Token ao qual o dispositivo 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 a serem inseridos no dispositivo no corpo JSON.
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 placeholders (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. Por 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 usado. No exemplo acima, o host é us1. Você pode determinar o host a partir do Device Token (ex.: us1:xxxxx).
   • Data format: Se o payload não estiver no formato Valeiot Data Point, você deve configurar um Payload Parser para adaptar os dados recebidos antes da inserção.

MQTT

Por padrão, dispositivos na Valeiot suportam protocolos MQTT nativamente. Siga os passos abaixo para enviar dados usando MQTT.

MQTT via Device Token

1. *Aguarde — ainda estamos trabalhando nisso!

MQTT via Network Token

1. *Aguarde — ainda estamos trabalhando nisso!

Outros Protocolos de Comunicação

Se seu caso de uso requer integração com outro protocolo de comunicação, será necessário implementar um Middleware para realizar a ponte. Para orientações detalhadas sobre como integrar devices com protocolos personalizados, veja o guia aqui.