macOS HTTP server

On Mac, DataJot can expose an optional local HTTP server. This feature is mainly for people who want to connect DataJot to scripts or external tools.

What the HTTP server is for

The server lets you add measures and read measures through HTTP requests.

For example, a local script can add a value to a “Weight” series or retrieve measures from a series over a selected period.

This feature is optional. If you only use the app, widgets, and Shortcuts, you do not need to enable it.

Available settings

On Mac, settings let you enable or disable the server, choose between local-only access and local network access, and control its menu bar or background behavior according to the dedicated toggle.

By default, the local address is:

http://127.0.0.1:17654

If local network access is allowed, the same port can be exposed on the Mac preferred local IPv4 address.

Available endpoints

The HTTP v1 contract confirms these endpoints:

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

The old endpoints POST /series/{uuid-or-name}/values and POST /series/{uuid-or-name}/measures should not be used.

Identify the right series

A request targeting a series must provide exactly one series identifier or series name.

seriesId is recommended because it remains stable even if you rename the series. seriesName is easier to write, but it can become ambiguous if several series have the same name case-insensitively.

Add a measure

Minimal example:

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, the server uses the current date.

Read measures

GET /measures uses query parameters. You must provide a series and a granularity.

Confirmed granularities are raw, hour, day, week, and month.

Raw requests are sorted by descending date and can use cursor pagination. Aggregated responses are sorted by ascending period date.

Request builder

The macOS “HTTP Measure Request Builder” helps generate the URL, payload fields, JSON, and a curl command.

Use it when you want to prepare a request without writing all the JSON by hand.