macOS HTTP server

On Mac, DataJot can expose a local HTTP server for scripts and external tools. This feature is optional and is not a cloud API.

Enable the server

1. Open DataJot settings on macOS.
2. Enable the HTTP server.
3. Keep local-only access if requests come from the same Mac.
4. Enable local network access only if another device needs to reach the server.
5. Check the service with GET /health.

The default local address is:

http://127.0.0.1:17654

When network access is enabled, the same port is exposed on the Mac local IPv4 address.

Security: the server does not use authentication. Local network access therefore makes the service available to devices on that network. Use it only on an appropriate network and disable it when it is not needed.

Available endpoints

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

The legacy endpoints POST /series/{uuid-or-name}/values and POST /series/{uuid-or-name}/measures should no longer be used.

Identify a series

A request must provide either seriesId or seriesName, but not both.

seriesId remains stable when the series is renamed. seriesName is more readable but becomes ambiguous when several series share the same case-insensitive name.

Add a measure

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

If the date is omitted, DataJot uses the current date. To send several measures, use values, an array of objects that each contain value and an optional date, instead of value.

The response gives the number of entries created and the targeted series. During the first integration, check the measure list in DataJot afterward.

Read measures

GET /measures requires a series and a granularity. Available granularities are raw, hour, day, week, and month.

Raw measures are sorted by descending date and support cursor pagination. Aggregated responses are sorted by ascending period start.

Request builder

The macOS HTTP Measure Request Builder prepares a POST /measures request without requiring you to write JSON manually:

1. Select a series and enter a value.
2. Add a date if needed.
3. Copy the generated JSON or curl command.
4. Run the request from your local tool.

The builder requires an existing series and does not prepare read requests.