GET /api/my-devices

Returns a list of all devices assigned to the authenticated user. Each device includes online status, current actuator state, hardware capability flags derived from device properties, and the latest humidity reading (sensor_type_id=1).

Returns every device owned by the authenticated user. Device properties stored in the database (e.g. has_pump, has_humidity, has_light) are resolved into a structured capabilities object. The last_humidity value is taken from the most recent SensorData row where sensor_type_id = 1.

Field	Value
Method	GET
Path	`/api/my-devices`
Auth	Bearer token required (`Authorization: Bearer YOUR_TOKEN`)

Request

No query parameters or request body.

curl -X GET http://localhost/api/my-devices \
  -H "Authorization: Bearer YOUR_TOKEN"

Response (200 OK)

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "Invernadero A",
      "is_online": true,
      "current_state": "STANDBY",
      "capabilities": {
        "has_pump": true,
        "has_humidity": true,
        "has_light_sensor": false
      },
      "last_humidity": 73.5
    }
  ]
}

status

string

Always "success" for a 200 response.

data

array

Array of device objects belonging to the authenticated user.

Show data[]

data[].id

integer

Unique device identifier.

data[].name

string

Human-readable display name of the device (e.g. "Invernadero A").

data[].is_online

boolean

Whether the device has communicated with the backend recently.

data[].current_state

string

The current actuator command. One of: ON, OFF, STANDBY.

data[].capabilities

object

Hardware capability flags derived from device_properties.

Show capabilities

has_pump

boolean

true if the device has a pump actuator (has_pump property = "true").

has_humidity

boolean

true if the device has a soil humidity sensor (has_humidity property = "true").

has_light_sensor

boolean

true if the device has a light sensor (has_light property = "true").

data[].last_humidity

number | null

The most recent reading_value where sensor_type_id = 1. Returns null if no readings exist yet.

GET /api/my-devices/

Returns detailed information about a single device owned by the authenticated user. The response includes the device’s current settings, capability flags, and up to 20 recent sensor history entries.

Field	Value
Method	GET
Path	`/api/my-devices/{id}`
Auth	Bearer token required

Path Parameters

integer

required

The unique ID of the device to retrieve. The device must belong to the authenticated user.

Request

curl -X GET http://localhost/api/my-devices/1 \
  -H "Authorization: Bearer YOUR_TOKEN"

Response (200 OK)

{
  "status": "success",
  "data": {
    "id": 1,
    "name": "Invernadero A",
    "is_online": true,
    "state": "STANDBY",
    "settings": {
      "auto_water": false,
      "humidity_threshold": 40
    },
    "capabilities": {
      "has_pump": true,
      "has_humidity": true
    },
    "history": [
      {"value": 73.5, "type": "humedad_suelo", "date": "2024-01-15T10:30:00.000000Z"}
    ]
  }
}

status

string

Always "success" for a 200 response.

data

object

Detailed device object.

Show data

data.id

integer

Unique device identifier.

data.name

string

Human-readable display name.

data.is_online

boolean

Whether the device is currently online.

data.state

string

Current actuator command: ON, OFF, or STANDBY.

data.settings

object

Automation configuration resolved from device_properties.

Show settings

auto_water

boolean

Whether automatic watering is enabled. Defaults to false.

humidity_threshold

integer

Humidity percentage at which the pump triggers. Defaults to 40.

data.capabilities

object

Hardware capability flags.

Show capabilities

has_pump

boolean

true if a pump actuator is configured.

has_humidity

boolean

true if a humidity sensor is configured.

data.history

array

Up to 20 most recent sensor readings for this device. Each entry includes the raw value, the sensor metric key, and the timestamp.

Show history[]

value

number

The sensor reading value.

type

string

The metric key from the associated SensorType (e.g. "humedad_suelo").

date

string

ISO 8601 timestamp when the reading was recorded.

Response (404 Not Found)

Returned when no device with the given id belongs to the authenticated user.

{
  "status": "error",
  "message": "Dispositivo no encontrado"
}

Authentication

Devices

Sensor Data

GET /api/my-devices — List Authenticated User's Devices

GET /api/my-devices

Request

Response (200 OK)

GET /api/my-devices/

Path Parameters

Request

Response (200 OK)

Response (404 Not Found)

Build docs developers (and LLMs) love

Authentication

Devices

Sensor Data

Documentation Index

​GET /api/my-devices

​Request

​Response (200 OK)

​GET /api/my-devices/

​Path Parameters

​Request

​Response (200 OK)

​Response (404 Not Found)

Build docs developers (and LLMs) love

GET /api/my-devices

Request

Response (200 OK)

GET /api/my-devices/

Path Parameters

Request

Response (200 OK)

Response (404 Not Found)