Integração de dados na Tekon IoT Platform por REST API - Códigos de estado

Para cada pedido realizado, o servidor processa a informação e devolve uma resposta adequada ao resultado do pedido. Com a integração de dados na Tekon IoT Platform por REST API, as respostas possíveis da parte do servidor diferenciam-se da seguinte forma:

    •  201 – Recurso criado com sucesso (Created);
    •  400 – Erro do cliente (Bad Request);
    •  500 – Erro do servidor (Internal server error);

A devolução do código de estado 201 informa o cliente que o pedido foi aceite com sucesso. Neste contexto, esta resposta indica que os dados foram inseridos na base de dados e disponibilizados no datasource da Tekon IoT Platform.

Exemplo de uma resposta de sucesso:

{
   "idDataSource": 4,
   "idData": "fca38d5d-7898-4576-bd2b-c35dbe8260e4"
}

As respostas devolvidas com o código de estado 400 indicam a existência de um erro dos parâmetros do pedido feito ao servidor. Os casos mais comuns que podem originar este tipo de resposta são a utilização de chaves API inválidas ou pedidos sem informação das variáveis.

Exemplo de uma resposta de erro, onde a chave API do utilizador não é válida:

{
   "userApiKey": [
   "Invalid key."
  ]
}

Os erros de código de estado 500 representam erros internos na parte da API. Este tipo de resposta nunca é originado por nenhuma inconformidade no pedido feito pelo cliente. É comum o cliente repetir o pedido sempre que é confrontado com esta resposta.

Nota: caso o problema persista, contacte o suporte técnico da Tekon Electronics e forneça o máximo de informação possível para ajudar a solucionar o problema.