Ingestion HTTP

L’ingestion HTTP permet à n’importe quel matériel capable de faire un POST d’envoyer des mesures à Bee Thing.

Authentification

La requête utilise le jeton de la balance dans l’en-tête Authorization.

Authorization: Bearer <scale_token>

Message v1

Le message v1 contient un identifiant de message et les premières métriques supportées par Bee Thing.

{
  "schema_version": "1",
  "message_id": "example-0001",
  "device": {
    "network": {
      "type": "wifi"
    },
    "firmware": "0.1.0",
    "hardware": "esp32"
  },
  "measurements": {
    "weight_kg": 42.3,
    "temperature_c": 18.7,
    "humidity_pct": 62.5,
    "battery_pct": 91,
    "battery_voltage_v": 4.05
  }
}

Toutes les mesures sont optionnelles, mais le message doit en contenir au moins une.

Notes

L’heure de réception côté serveur sert de référence. Le matériel n’a donc pas besoin d’avoir une horloge fiable pour commencer.

Pour le débogage, les messages récemment reçus sont visibles dans l’application depuis la page Balances, dans l’onglet activité d’une balance.

Les anciens messages d’activité pourront être purgés régulièrement. Les mesures métier restent conservées.

Les envois doivent rester raisonnablement espacés. Bee Thing recommande un intervalle minimal de 15 minutes entre deux mesures envoyées par une balance. Le service est conçu pour recevoir des mesures périodiques de terrain, pas un flux continu à haute fréquence.