Messwerte senden

Token anlegen

Du brauchst ein eigenes Schnittstellen-Token. Es darf nur Messwerte an /api/ingest schicken. Lesen kann es nichts, und andere Routen erreicht es nicht. Ein MCP-Token oder das Token der App funktioniert hier nicht.

1. Öffne im Kontobereich „Verbindungen“.
2. Klicke bei „Eigene Messwerte“ auf „Schnittstellen-Token erzeugen“ und gib ihm einen Namen, etwa den der Waage oder der Automation.
3. Kopier das Token. Es steht nur einmal im Klartext da. Verlierst du es, widerrufst du es und legst ein neues an.

Ein Token je Gerät oder Automation hat einen Vorteil: Fällt eines in falsche Hände, widerrufst du nur dieses.

Anfrage

Ein POST mit JSON im Körper. Das Token steht im Header Authorization, mit „Bearer “ davor. Ein Aufruf darf bis zu 100 Messungen enthalten.

Authorization: Bearer DEIN_TOKEN
Content-Type: application/json
Accept: application/json

{
  "measurements": [
    {
      "measured_at": "2026-10-05T07:12:00+02:00",
      "device": "Tanita RD-545",
      "context": "morning_fasted",
      "weight_kg": 96.05,
      "body_fat_pct": 30.1,
      "muscle_mass_kg": 63.4,
      "body_water_pct": 50.2,
      "bone_mass_kg": 3.3,
      "visceral_fat": 14,
      "bmr_kcal": 2034,
      "metabolic_age": 52,
      "segments": {
        "trunk": { "fat_pct": 34.6, "muscle_mass_kg": 33.1 },
        "left_leg": { "fat_pct": 24.0, "muscle_mass_kg": 10.9 }
      }
    }
  ]
}

Antwort

Der Server prüft jede Messung für sich. Eine fehlerhafte kippt nicht die ganze Lieferung: Du bekommst je Messung einen Status in der Reihenfolge, in der du sie geschickt hast, dazu eine Zusammenfassung.

received

neu angenommen

updated

dieselbe Messung mit geänderten Werten, fortgeschrieben

known

genau so schon vorhanden, nichts geändert

rejected

abgelehnt, der Grund steht in reason

{
  "results": [
    { "index": 0, "status": "received", "measured_at": "2026-10-05T05:12:00Z" },
    { "index": 1, "status": "rejected", "reason": "weight_kg is 960, outside 20 to 400." }
  ],
  "summary": { "received": 1, "rejected": 1 }
}

HTTP-Status

200

Die Lieferung wurde verarbeitet. Ob einzelne Messungen abgelehnt wurden, steht in results.

401

Kein oder ein widerrufenes Token.

403

Das Token gilt für diese Route nicht, oder die Einwilligung zur Verarbeitung von Gesundheitsdaten ist widerrufen (code consent_revoked).

422

measurements fehlt, ist leer oder hat mehr als 100 Einträge.

429

Mehr als 120 Aufrufe in der Minute. Warte die Zeit aus Retry-After ab.

Regeln

• Wiederholbar: Dieselbe Messung zweimal ergibt einen Datensatz. Erkannt wird sie an external_id, ohne Kennung an Zeitpunkt und Gerät. Schick ruhig nach jedem Lauf deiner Automation den ganzen Tag noch einmal.
• Fortschreiben ergänzt: Eine geänderte Messung überschreibt die geschickten Werte. Werte, die du diesmal weglässt, bleiben stehen.
• Zeitpunkt mit Zone: measured_at braucht eine Zeitzone. Messungen mehr als zehn Minuten in der Zukunft lehnt der Server ab, das ist fast immer eine falsch gestellte Uhr.
• Grenzen: höchstens 100 Messungen je Aufruf und 120 Aufrufe in der Minute. Zahlen werden auf zwei Nachkommastellen gerundet.
• Nur schreiben: Über die Schnittstelle kommt nichts zurück. Gelesen werden die Werte über MCP (body-metrics) mit Quelle „ingest“ und dem Gerät aus device.

Beispiele

curl -X POST https://api.training-mcp.app/api/ingest/v1/body \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"measurements":[{"measured_at":"2026-10-05T07:12:00+02:00","device":"Tanita RD-545","weight_kg":96.05,"body_fat_pct":30.1}]}'

# configuration.yaml
rest_command:
  training_mcp_body:
    url: https://api.training-mcp.app/api/ingest/v1/body
    method: POST
    headers:
      Authorization: !secret training_mcp_token   # "Bearer DEIN_TOKEN"
      Accept: application/json
    content_type: application/json
    payload: >
      {"measurements":[{
        "measured_at": "{{ now().isoformat() }}",
        "device": "Withings Body+",
        "weight_kg": {{ states('sensor.waage_gewicht') | float }},
        "body_fat_pct": {{ states('sensor.waage_fett') | float }}
      }]}

# automations.yaml
- alias: Waage an training mcp
  trigger:
    - platform: state
      entity_id: sensor.waage_gewicht
  action:
    - service: rest_command.training_mcp_body

import requests

r = requests.post(
    "https://api.training-mcp.app/api/ingest/v1/body",
    headers={"Authorization": "Bearer DEIN_TOKEN", "Accept": "application/json"},
    json={"measurements": [{
        "measured_at": "2026-10-05T07:12:00+02:00",
        "device": "Tanita RD-545",
        "weight_kg": 96.05,
        "body_fat_pct": 30.1,
    }]},
    timeout=10,
)
r.raise_for_status()
print(r.json()["summary"])

https://api.training-mcp.app/api/ingest/v1/openapi.json

Datenschutz

Körperwerte sind Gesundheitsdaten. Sie liegen auf Servern in Deutschland und gehen nur an das Sprachmodell, das du selbst verbindest. Widerrufst du die Einwilligung zur Verarbeitung von Gesundheitsdaten, nimmt die Schnittstelle nichts mehr an. Löschst du dein Konto, sind auch diese Werte weg.