Registra uma nova leitura para um sensor específico

POST /sensors/{sensor_id}/readings

Cria uma nova leitura para um sensor específico. O utilizador só pode registrar leituras para seus próprios sensores.

Path parameters

  • sensor_id integer Required

    ID do sensor para o qual a leitura será registrada.

application/json

Body Required

  • value number(float)

    O valor da leitura do sensor.

Responses

  • 201 application/json

    Leitura registrada com sucesso.

    Hide response attribute Show response attribute object
  • 400 application/json

    Erro de validação (valor inválido ou ausente).

    Hide response attribute Show response attribute object
  • 403 application/json

    Não autorizado, o utilizador não tem permissão para registrar leituras neste sensor.

    Hide response attribute Show response attribute object
POST /sensors/{sensor_id}/readings 
curl \
 --request POST 'http://localhost:8000/sensors/1/readings' \
 --header "Content-Type: application/json" \
 --data '{"value":23.5}'
Request examples 
{
  "value": 23.5
}
Response examples (201) 
{
  "message": "Leitura registrada com sucesso."
}
Response examples (400) 
{
  "error": "O valor da leitura é obrigatório e deve ser numérico."
}
Response examples (403) 
{
  "message": "Unauthorized."
}