Serveur HTTP macOS

Sur Mac, DataJot peut exposer un serveur HTTP local optionnel. Cette fonction s’adresse surtout aux utilisateurs qui veulent connecter DataJot à des scripts ou outils externes.

À quoi sert le serveur HTTP

Le serveur permet d’ajouter des mesures et de lire des mesures depuis une requête HTTP.

Par exemple, un script local peut ajouter une valeur à une série “Poids” ou récupérer les mesures d’une série sur une période donnée.

Cette fonction est optionnelle. Si vous utilisez seulement l’application, les widgets et Raccourcis, vous n’avez pas besoin de l’activer.

Réglages disponibles

Sur Mac, les réglages permettent d’activer ou désactiver le serveur, de choisir entre un accès local uniquement ou un accès sur le réseau local, et de contrôler son comportement en barre de menu ou en arrière-plan selon le toggle dédié.

Par défaut, l’adresse locale est :

http://127.0.0.1:17654

Si l’accès réseau local est autorisé, le même port peut être exposé sur l’adresse IPv4 locale préférée du Mac.

Endpoints disponibles

Le contrat HTTP v1 confirme les endpoints suivants :

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

Les anciens endpoints POST /series/{uuid-or-name}/values et POST /series/{uuid-or-name}/measures ne doivent pas être utilisés.

Identifier la bonne série

Une requête qui cible une série doit fournir exactement un identifiant de série ou un nom de série.

seriesId est recommandé, car il reste stable même si vous renommez la série. seriesName est plus pratique à écrire, mais il peut devenir ambigu si plusieurs séries portent le même nom sans tenir compte de la casse.

Ajouter une mesure

Voici un exemple minimal :

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

Si la date est omise, le serveur utilise la date courante.

Lire des mesures

GET /measures utilise des paramètres de requête. Il faut fournir une série et une granularité.

Les granularités confirmées sont raw, hour, day, week et month.

Les requêtes brutes sont triées par date descendante et peuvent utiliser une pagination par curseur. Les réponses agrégées sont triées par date de période ascendante.

Générateur de requête

L’outil macOS “HTTP Measure Request Builder” aide à générer l’URL, les champs de payload, le JSON et une commande curl. Utilisez-le lorsque vous voulez préparer une requête sans écrire tout le JSON à la main.