Documentación

Servidor HTTP de macOS

Usa el servidor HTTP local del Mac para añadir y consultar medidas desde una herramienta externa.

Actualizado el 7 de septiembre de 2026

En el Mac, DataJot puede exponer un servidor HTTP local para scripts y herramientas externas. Esta función es opcional y no es una API en la nube.

Activar el servidor

  1. Abre los ajustes de DataJot en macOS.
  2. Activa el servidor HTTP.
  3. Mantén el acceso exclusivamente local si las solicitudes proceden del mismo Mac.
  4. Activa el acceso desde la red local solo si otro dispositivo necesita conectarse al servidor.
  5. Comprueba el servicio con GET /health.

La dirección local predeterminada es:

http://127.0.0.1:17654

Cuando el acceso por red está activado, el mismo puerto queda expuesto en la dirección IPv4 local del Mac.

Seguridad: el servidor no utiliza autenticación. Por tanto, el acceso desde la red local pone el servicio a disposición de los dispositivos de esa red. Úsalo únicamente en una red adecuada y desactívalo cuando no lo necesites.

Endpoints disponibles

GET  /
GET  /health
GET  /series
POST /measures
GET  /measures

Ya no deben utilizarse los endpoints antiguos POST /series/{uuid-or-name}/values y POST /series/{uuid-or-name}/measures.

Identificar una serie

Una solicitud debe proporcionar seriesId o seriesName, pero no ambos.

seriesId no cambia al renombrar la serie. seriesName es más legible, pero resulta ambiguo cuando varias series tienen el mismo nombre sin distinguir entre mayúsculas y minúsculas.

Añadir una medida

curl -X POST http://127.0.0.1:17654/measures \
  -H 'Content-Type: application/json' \
  -d '{"seriesName":"Peso","value":72.4}'

Si se omite la fecha, DataJot utiliza la fecha actual. Para enviar varias medidas, utiliza values, una matriz de objetos que contengan value y, opcionalmente, date, en lugar de value.

La respuesta indica el número de entradas creadas y la serie de destino. Durante la primera integración, comprueba después la lista de medidas en DataJot.

Consultar medidas

GET /measures requiere una serie y una granularidad. Las granularidades disponibles son raw, hour, day, week y month.

Las medidas sin procesar se ordenan por fecha descendente y admiten paginación mediante cursor. Las respuestas agregadas se ordenan por el inicio del periodo en orden ascendente.

Generador de solicitudes

El Generador de solicitudes HTTP de medidas de macOS prepara una solicitud POST /measures sin que tengas que escribir el JSON manualmente:

  1. Selecciona una serie e introduce un valor.
  2. Añade una fecha si es necesario.
  3. Copia el JSON o el comando curl generado.
  4. Ejecuta la solicitud desde tu herramienta local.

El generador requiere una serie existente y no prepara solicitudes de consulta.