> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agroop.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter leituras do equipamento

> Devolve uma lista de leituras de um equipamento num determinado período. Todos os valores de data e hora, incluindo timestamps, são expressos em UTC.



## OpenAPI

````yaml GET /devices/{profile}/{serial}/readings
openapi: 3.0.3
info:
  title: Agroop API
  description: Demonstração da Agroop API
  version: 1.0.0
servers:
  - url: https://device.agroop.net/api
security:
  - apiKeyAuth: []
paths:
  /devices/{profile}/{serial}/readings:
    get:
      tags:
        - devices
      summary: Obter leituras do equipamento pelo identificador único
      description: >-
        Devolve uma lista de leituras de um equipamento num determinado período.
        Todos os valores de data e hora, incluindo timestamps, são expressos em
        UTC.
      operationId: getReadingsBySerial
      parameters:
        - name: serial
          in: path
          description: Identificação única do equipamento.
          required: true
          schema:
            type: string
            example: M05DE3832415251205715
        - name: profile
          in: path
          description: Seleção do fornecedor do equipamento.
          required: true
          schema:
            type: string
            enum:
              - PYCNO
              - REAL_WEATHER_STATION
              - YDOC
              - TALKPOOL
              - BMETERS
            example: PYCNO
        - name: connectorId
          in: query
          description: >-
            Identificador do conector cujas leituras pretende obter. Na maioria
            dos equipamentos, utilize 'ORIGIN'. Nas gateways, cada equipamento
            ligado envia um identificador próprio para a gateway, que deve ser
            utilizado como 'connectorId'. Os conectores e as respetivas
            interfaces podem ser consultados através do endpoint de informação
            do equipamento.
          required: false
          schema:
            type: string
            default: ORIGIN
        - name: interfaces
          in: query
          description: Seleção das interfaces do equipamento cujas leituras pretende obter.
          required: true
          schema:
            type: array
            items:
              type: string
              enum:
                - AirTemp
                - AirHum
                - WindDir
                - WindSpeedRaw
                - WindSpeed
                - Sunlight
                - SolarIrradiance
                - Precipitation
                - Flowmeter
                - FlowmeterTotal
                - FlowmeterAvg
                - DewPoint
                - Pressure
                - SMraw10
                - SMmm10
                - SMraw15
                - SMmm15
                - SMraw20
                - SMmm20
                - SMraw25
                - SMmm25
                - SMraw30
                - SMmm30
                - SMraw40
                - SMmm40
                - SMraw50
                - SMmm50
                - SMraw55
                - SMmm55
                - SMraw60
                - SMmm60
                - SMraw70
                - SMmm70
                - SMraw80
                - SMmm80
                - SMraw85
                - SMmm85
                - SoilTemp10
                - SoilTemp15
                - SoilTemp20
                - SoilTemp30
                - SoilTemp40
                - SoilTemp45
                - SoilTemp50
                - SoilTemp60
                - SoilTemp70
                - SoilTemp75
                - SoilTemp80
                - SoilSalinity10
                - SoilSalinity20
                - SoilSalinity30
                - SoilSalinity40
                - SoilSalinity50
                - SoilSalinity60
                - SoilSalinity70
                - SoilSalinity80
                - TicksAvg
                - TicksTotal
                - TicksCount
                - WaterEntrance10
                - WaterEntrance15
                - WaterEntrance20
                - WaterEntrance25
                - WaterEntrance30
                - WaterEntrance40
                - WaterEntrance50
                - WaterEntrance55
                - WaterEntrance60
                - WaterEntrance70
                - WaterEntrance80
                - WaterEntrance85
                - WaterLoss10
                - WaterLoss15
                - WaterLoss20
                - WaterLoss25
                - WaterLoss30
                - WaterLoss40
                - WaterLoss50
                - WaterLoss55
                - WaterLoss60
                - WaterLoss70
                - WaterLoss80
                - WaterLoss85
                - Bat
                - Rssi
                - GustSpeedRaw
                - GustSpeed
                - UltraViolet
        - name: startDate
          in: query
          description: Data e hora inicial do período, em UTC.
          required: true
          schema:
            type: string
            format: date-time
            example: '2025-01-01T00:00:00Z'
        - name: endDate
          in: query
          description: Data e hora final do período, em UTC.
          required: true
          schema:
            type: string
            format: date-time
            example: '2025-12-31T23:59:59Z'
        - name: aggregation
          in: query
          description: >-
            Seleção do método de agregação aplicado às leituras das interfaces
            escolhidas.
          required: false
          schema:
            type: string
            enum:
              - none
              - hour
              - day
              - week
              - month
              - auto
            default: none
      responses:
        '200':
          description: Lista de leituras devolvida com sucesso
          content:
            application/json:
              example:
                - timestamp: 1722206400000
                  AirTemp: 22.4
                  AirHum: 67.1
                - timestamp: 1722292800000
                  AirTemp: 21.8
                  AirHum: 70.3
        '400':
          description: Erro no pedido
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      name: Authorization
      in: header
      description: 'Formato obrigatório: `ApiKey YOUR_KEY`'

````