Helpcentrum HealthyApps
Nederlands
Helpcentrum
Hoofdwebsite ↗

Zoek in helponderwerpen

Apple Health-gegevens synchroniseren met MQTT

Publiceer gezondheidsgegevens naar een MQTT-broker.

Laatst bijgewerkt: 31 oktober 2026

Op deze pagina
De automatisering openenNaam, status en meldingenDe verbinding instellen
Instellingen gegevenstype Instellingen gegevenstype GezondheidsmetriekenTrainingen
Exportinstellingen Exportinstellingen ExportversieDatumbereikGegevens samenvatten en tijdgroepering
Herinneringen plannenSynchronisatiefrequentie en opslaanHistorische of gemiste gegevens exporterenProblemen oplossen

Publiceer gezondheidsexporten als JSON naar een onderwerp op je MQTT-broker.

Belangrijk — beperkingen van automatiseringen: Je apparaat moet ontgrendeld zijn om gezondheidsgegevens te lezen, en iOS garandeert geen achtergronduitvoeringen met de door jou gekozen frequentie. Lees de beperkingen van automatiseringen voordat je op automatische exporten vertrouwt.

De automatisering openen

Open Exporteren → Geautomatiseerd op iPhone, of Automatiseringen in de iPad-zijbalk. Selecteer Nieuwe automatisering, of open een bestaande om te bewerken.

Naam, status en meldingen

Voer een naam in die deze automatisering identificeert. Ingeschakeld staat automatische uitvoeringen toe; laat dit uit tot je klaar bent.

Kies de uitvoeringsmeldingen die je wilt:

  • Melden bij cache-update meldt dat exportgegevens zijn voorbereid.
  • Melden bij uitvoering meldt een geslaagde publicatie naar de broker.

Sta meldingen toe wanneer daarom wordt gevraagd. Deze meldingen rapporteren activiteit; ze plannen geen uitvoering.

De verbinding instellen

  1. Kies MQTT als Automatiseringstype.
  2. Voer de hostnaam of het IP-adres en de poort van je broker in. De standaardpoort is 1883.
  3. Voer het onderwerp in, bijvoorbeeld health/metrics.
  4. Stel een unieke client-ID in voor elke automatisering en voer een gebruikersnaam en wachtwoord in als de broker dat vereist.

De broker moet bereikbaar zijn vanaf je apparaat. Abonnees moeten het exacte onderwerp gebruiken, inclusief hoofdletters. Een client-ID opnieuw gebruiken kan ervoor zorgen dat brokerverbindingen elkaar vervangen.

Instellingen gegevenstype

Selecteer één gegevenstype voor deze automatisering: Gezondheidsmetrieken, Trainingen, Symptomen, ECG, Hartslagmeldingen, Gemoedstoestand, Cyclustracking of Medicijnen. Gemoedstoestand vereist iOS 18 of nieuwer; Medicijnen vereist iOS 26 of nieuwer en aparte medicijnentoegang.

Gezondheidsmetrieken

Kies Gezondheidsmetrieken, open Gezondheidsmetrieken selecteren en selecteer de metingen die je nodig hebt.

Om metingen te beperken tot bepaalde apps of apparaten, open je Voorkeursbronnen, kies je een metriek en selecteer je de bronnen. Alles staat elke bron toe die niet is uitgesloten. Gebruik Uitgesloten bronnen om een bron voor de gezondheidsmetrieken van deze automatisering te negeren. Uitsluitingen hebben voorrang; een niet-geselecteerde bron wordt niet vervangen wanneer een voorkeursbron geen gegevens heeft. Selecteer Bewaar om de bronkeuzes toe te passen of Annuleer om ze te verwerpen.

Trainingen

Kies Trainingen om trainingsrecords te exporteren. Routgegevens opnemen voegt beschikbare routepunten toe aan JSON-trainingsgegevens. Het maakt geen aparte GPX-uploads.

Voor Versie 2 schakel je Trainingsmetrieken opnemen in om metingen zoals hartslag, actieve energie en stappen toe te voegen. Kies Minuten of Seconden voor de tijdgroepering van trainingsmetrieken; seconden leveren meer detail en grotere exporten. Versie 1 bevat altijd trainingsmetrieken.

Exportinstellingen

MQTT publiceert alleen JSON. Berichten gebruiken QoS 0 voor voorgrondpublicatie en QoS 1 voor achtergrondpublicatie. Berichten worden niet bewaard (retained).

Exportversie

Kies Versie 2 voor de huidige gegevensstructuur. Gebruik Versie 1 wanneer een bestaande workflow van het oudere formaat afhangt.

Datumbereik

Selectie Opgenomen gegevens
Standaard De vorige dag en vandaag tot de uitvoeringstijd
Sinds laatste synchronisatie Sinds de vorige synchronisatie tot de uitvoeringstijd
Vandaag Vandaag tot de uitvoeringstijd
Gisteren De volledige vorige dag
Vorige 7 dagen De vorige zeven volledige dagen

Gegevens samenvatten en tijdgroepering

Voor JSON + Gezondheidsmetrieken schakel je Gegevens samenvatten in om metingen in tijdgroepen te combineren, of uit voor individuele metingen waar beschikbaar. De samenvatting hangt af van de metriek—bijvoorbeeld stappen worden opgeteld en gewichtsmetingen gemiddeld. CSV-exporten van gezondheidsmetrieken gebruiken samengevatte gegevens.

Wanneer Tijdgroepering beschikbaar is, kies je hoeveel detail je wilt behouden. Groepen per uur of dag leveren minder rijen op dan minuut- of secondengroepen. Beschikbare keuzes hangen af van het datumbereik en formaat. Tijdgroepering van trainingen wordt apart geconfigureerd onder Trainingen.

Herinneringen plannen

Als je een melding wilt om te ontgrendelen en de app te openen, schakel dan Herinneringen inschakelen in. Kies Elk uur, Elke dag of Geselecteerde dagen, en stel de minuut, tijd en dagen in. Sta meldingen toe wanneer daarom wordt gevraagd; als toegang is geweigerd, gebruik Meldingsinstellingen openen.

Een herinnering voert de automatisering niet uit en bevestigt geen geslaagde synchronisatie. Tik erop om de automatisering te openen, of gebruik Openen en synchroniseren op de melding om een uitvoering aan te vragen. De automatisering moet ingeschakeld zijn; een herinnering kan nog verschijnen na een geslaagde achtergronduitvoering. Wijzigingen in herinneringen gelden wanneer je opslaat.

Synchronisatiefrequentie en opslaan

Kies een getal en Minuten, Uren, Dagen of Weken onder Synchronisatiefrequentie—bijvoorbeeld elke 15 minuten. Dit is een gewenste achtergrondcadans, geen gegarandeerd schema.

Je apparaat moet ontgrendeld zijn wanneer gezondheidsgegevens worden gelezen. Schakel Achtergrond-app verversen in voor Health Auto Export en schakel de energiebesparingsmodus uit voor automatische uitvoeringen. iOS kan uitvoeringen nog steeds vertragen wanneer het apparaat inactief is geweest of systeembronnen beperkt zijn.

Schakel Ingeschakeld in wanneer je klaar bent voor automatische uitvoeringen, en selecteer Werk bij om de automatisering op te slaan. Je kunt meteen een geselecteerd datumbereik uploaden met de stappen hieronder.

Historische of gemiste gegevens exporteren

Gebruik Handmatige upload wanneer je de automatisering voor het eerst instelt om historische gegevens te exporteren, of later om datums te dekken die de automatische synchronisatie heeft gemist. Je kunt dit ook gebruiken om je installatie te controleren.

  1. Koppel een MQTT-abonnee aan je broker en abonneer je op het geconfigureerde onderwerp.
  2. Open in Health Auto Export de automatisering en selecteer Handmatige upload onder Bestaande gegevens exporteren.
  3. Stel de datums Start en Einde in en selecteer Export starten.
  4. Controleer de ontvangen JSON en de datums.

De payload volgt het JSON-exportformaat. Bijvoorbeeld:

{
  "data": {
    "metrics": [
      {
        "name": "step_count",
        "units": "count",
        "data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
      }
    ]
  }
}

Problemen oplossen

  • Verbinding mislukt: Controleer de host, poort, netwerktoegang en verbindingsvereisten van de broker.
  • Authenticatie mislukt: Controleer de referenties en de toestemming om naar het onderwerp te publiceren.
  • Geen bericht: Bevestig dat de abonnee dezelfde broker en het exacte onderwerp gebruikt, en bekijk daarna de activiteitslogboeken.
  • Bericht te groot: Selecteer minder metrieken, een korter bereik of grovere tijdgroepering.

Open de automatisering en selecteer Activiteitslogboeken weergeven om een uitvoering te bekijken. Waarschuwingen markeren mogelijke problemen zoals trage gegevensopvraging; fouten identificeren mislukte stappen. Voor hulp bij het melden van een probleem zie Hulp krijgen.