¶ 🔗 Detalles del Endpoint (Rango de Medidas)
- Método:
GET - Ruta:
/measures - Base URL:
https://api.fdxcloud.com/client - Content-Type:
application/json - Autenticación: Header
x-api-tokenrequerido
¶ 💡 Cuándo utilizar este endpoint
Este endpoint se utiliza para obtener un listado completo y detallado de mediciones de forma estructurada. Resulta adecuado para construir tablas paginadas, grillas de datos o reportes detallados, ya que soporta paginación (page y length) e incluye información asociada a cada medición, como metadatos del dispositivo, estado de batería, valores sin procesar, valores interpretados y nivel de señal. Debido al tamaño de la respuesta, no se recomienda para la carga masiva de datos destinados a gráficos o series temporales.
⚠️ Atención: Este endpoint está pensado exclusivamente para el consumo desde interfaces visuales (UI). No debe utilizarse para la automatización de procesos externos, sincronizaciones periódicas ni extracción masiva de datos.
¶ 🧾 Parámetros de Consulta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
measurement_point |
integer |  |
ID del punto de medición |
device |
integer |  |
ID del dispositivo asociado (opcional) |
since |
string | |
Fecha inicio (Y-m-d) |
to |
string | |
Fecha fin (Y-m-d) |
length |
integer | |
Cantidad de resultados (máx 500, por defecto 10) |
page |
integer | |
Página de resultados (mín 1, por defecto 1) |
¶ 📤 Ejemplo de Solicitud
GET /measures?measurement_point=16&device=6&since=2025-10-01&to=2025-10-29&length=100&page=1
Host: fdxcloud.com/client
x-api-token: tu_token
Content-Type: application/json
¶ ✅ Respuesta Exitosa 200 OK
{
"data": [
{
"device": {
"id": integer,
"serial": string
},
"measurementPoint": {
"id": integer,
"name": string
},
"signlvl": null,
"measureDate": string (ISO 8601),
"batteryCharge": integer,
"transmissionDate": string (ISO 8601),
"directValue": number,
"directValueUnit": string,
"adjustedValue": number,
"adjustedValueUnit": string,
"interpretedValue": number,
"interpretedValueUnit": string,
"networkMode": string
}
// ...más medidas
]
}
¶ ❌ Respuesta de Error 404 Not Found
"string"
¶ 🧱 Modelo de Datos
| Campo | Tipo | Descripción |
|---|---|---|
device.id |
integer | ID del dispositivo |
device.serial |
string | Número de serie del dispositivo |
measurementPoint.id |
integer | ID del punto de medición |
measurementPoint.name |
string | Nombre del punto de medición |
signlvl |
null | Porcentaje de nivel de señal |
measureDate |
string | Fecha/hora de la medición (ISO 8601) |
batteryCharge |
integer | Porcentaje de batería del dispositivo |
transmissionDate |
string | Fecha/hora de transmisión (ISO 8601) |
directValue |
number | Valor sin procesar enviado por el dispositivo |
directValueUnit |
string | Unidad del valor directo (m, etc.) |
adjustedValue |
number | Valor ajustado según configuración |
adjustedValueUnit |
string | Unidad del valor ajustado |
interpretedValue |
number | Valor procesado según modo de uso configurado |
interpretedValueUnit |
string | Unidad del valor interpretado |
networkMode |
string | Modo de red que se conecto el dispositivo |