Documentation

Serveur HTTP macOS

Utiliser le serveur HTTP local sur Mac pour ajouter et lire des mesures depuis un outil externe.

Mis à jour le 6 septembre 2026

Sur Mac, DataJot peut exposer un serveur HTTP local pour communiquer avec des scripts et des outils externes. Cette fonction est optionnelle et ne constitue pas une API cloud.

Activer le serveur

  1. Ouvrez les réglages de DataJot sur macOS.
  2. Activez le serveur HTTP.
  3. Conservez l’accès local si les requêtes partent du même Mac.
  4. Activez l’accès au réseau local uniquement si un autre appareil doit joindre le serveur.
  5. Vérifiez le service avec GET /health.

L’adresse locale par défaut est :

http://127.0.0.1:17654

Lorsque l’accès réseau est activé, le même port est exposé sur l’adresse IPv4 locale du Mac.

Sécurité : le serveur n’utilise pas d’authentification. L’accès réseau local rend donc le service accessible aux appareils du réseau concerné. Utilisez-le uniquement sur un réseau approprié et désactivez-le lorsqu’il n’est pas nécessaire.

Endpoints disponibles

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 plus être utilisés.

Identifier une série

Une requête doit fournir soit seriesId, soit seriesName, mais pas les deux.

seriesId reste stable lorsque la série est renommée. seriesName est plus lisible, mais devient ambigu lorsque plusieurs séries partagent le même nom sans tenir compte de la casse.

Ajouter une mesure

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, DataJot utilise la date courante. Pour envoyer plusieurs mesures, utilisez values, un tableau d’objets contenant chacun value et éventuellement date, à la place de value.

La réponse indique le nombre d’entrées créées et la série ciblée. Vérifiez ensuite la liste des mesures dans DataJot lors de la première intégration.

Lire des mesures

GET /measures nécessite une série et une granularité. Les granularités disponibles sont raw, hour, day, week et month.

Les mesures brutes sont triées par date descendante et peuvent être parcourues avec une pagination par curseur. Les réponses agrégées sont triées par début de période croissant.

Générateur de requête

L’outil macOS HTTP Measure Request Builder prépare une requête POST /measures sans écrire le JSON manuellement :

  1. Sélectionnez une série et saisissez une valeur.
  2. Ajoutez une date si nécessaire.
  3. Copiez le JSON ou la commande curl.
  4. Exécutez la requête depuis l’outil local de votre choix.

Le générateur nécessite une série existante et ne prépare pas les requêtes de lecture.