Synkronisera Apple Health-data till REST API

REST API-automatiseringar gör att du automatiskt kan exportera dina hälsodata till vilken webbtjänst som helst som accepterar HTTP POST-förfrågningar. Detta är idealiskt för att integrera med anpassade backends, tredjeparts-API:er eller webhooks.

Översikt

REST API-automatiseringar skickar dina hälsodata till en angiven URL-endpoint med hjälp av HTTP POST-förfrågningar. Automatiseringen kan skicka data i JSON- eller CSV-format, med konfigurerbara headers för autentisering och anpassade metadata.

Användningsfall:

• Integrering med anpassade backend-tjänster
• Skicka data till webhooks
• Synkronisering med tredjeparts-API:er
• Bygga anpassade dashboards eller analysplattformar

Huvudfunktioner:

• Stöder både JSON- och CSV-format
• Anpassade HTTP-headers för autentisering
• Konfigurerbar förfrågnings-timeout
• Manuell export av historiska data

Begränsningar

• Åtkomst till hälsodata: Appar får inte komma åt hälsodata medan iPhone är låst. Automatiseringar körs endast under perioder när din enhet är upplåst. Detta kan påverka datafärskhet. Se instruktioner för manuell synkronisering för att hålla data uppdaterade.

• Bakgrundsbehandling: iOS begränsar bakgrundsbehandling för att bevara batteritiden. Automatiseringar är beroende av Appuppdatering i bakgrunden och kan inte köras omedelbart om:

  • Appuppdatering i bakgrunden är inaktiverad för appen
  • Enheten är i energisparläge
  • Enheten har varit inaktiv under längre perioder
  • Systemresurser är begränsade
  • Flera appar tävlar om bakgrundskörningstid

Förutsättningar

• En giltig URL-endpoint som accepterar HTTP POST-förfrågningar
• Autentiseringsuppgifter (om krävs av din endpoint)
• Nätverksanslutning för att nå din endpoint

Konfiguration

Navigera till skärmen Automatiserade export från huvudnavigeringen, tryck sedan på "Ny automatisering" och välj "REST API" som Automatiserings typ.

Automatiseringsnamn

Ange ett beskrivande namn för din automatisering (t.ex. "Min Backend API", "Webhook-integration").

Notifikationer

Konfigurera när du vill ta emot notifikationer:

• Meddela vid cacheuppdatering - Ta emot en notifikation när cachade data uppdateras
• Meddela vid körning - Ta emot en notifikation varje gång automatiseringen körs

URL-konfiguration

Ange den fullständiga URL:en där du vill skicka dina hälsodata. Detta bör vara en fullständig URL inklusive protokollet (http:// eller https://).

Exempel-URL:er:

• https://api.example.com/health-data
• https://webhook.site/your-unique-id
• http://localhost:3000/api/health

Obs: URL:en måste vara giltig och tillgänglig från din enhet. Ogiltiga URL:er förhindrar att automatiseringen körs.

Förfrågnings-timeout

Välj ett timeout-intervall för HTTP-förfrågningar. Detta avgör hur länge appen väntar på ett svar innan förfrågan anses ha misslyckats.

HTTP-headers

Lägg till anpassade HTTP-headers för autentisering eller metadata. Vanliga användningsfall inkluderar:

• API-nycklar: X-API-Key: your-api-key
• Auktoriseringstoken: Authorization: Bearer your-token
• Content-type-överskrivningar: Content-Type: application/json

För att lägga till headers:

1. Tryck på "Lägg till headers"
2. Ange header-nyckeln i vänsterfältet
3. Ange header-värdet i högerfältet
4. Upprepa för ytterligare headers

Viktigt: Varje header-nyckel måste ha ett motsvarande värde. Tomma headers ignoreras.

Datatypinställningar

Datatyp

Välj vilken typ av hälsodata som ska exporteras:

• Hälsoindikatorer - Steg, hjärtfrekvens, sömn och andra hälso mätningar
• Träningar - Tränings- och fitnessaktiviteter
• Symptom - Hälsosymptom och tillstånd
• EKG - Elektrokardiogramavläsningar
• Hjärtfrekvensnotifikationer - Hög/låg hjärtfrekvenshändelser
• Sinnestillstånd - Humör- och mentala tillståndsposter (iOS 18.0+)
• Cykelspårning - Menstruationscykel- och reproduktiv hälso data
• Läkemedel - Läkemedelsloggar och följsamhet (iOS 26.0+)

Konfiguration av hälsoindikatorer

När Hälsoindikatorer är valt:

Välj hälsoindikatorer - Välj vilka specifika indikatorer som ska inkluderas. Du kan välja alla tillgängliga indikatorer eller välja specifika.

Tips: Att välja endast de indikatorer du behöver kan förbättra bearbetningstiden och minska datastorleken.

Föredragna källor - Konfigurera vilka datakällor som har prioritet när flera källor tillhandahåller samma indikator.

Träningskonfiguration

När Träningar är valt:

Inkludera rutdata - Växla PÅ för att inkludera rutter för träningar som har platsdata.

Inkludera träningsindikatorer - Växla PÅ för att inkludera hälsoindikatorer som samlas in under träningar (hjärtfrekvens, kalorier, etc.).

Tidsgruppering (träningsindikatorer) - När du använder Exportversion 2 och Inkludera träningsindikatorer är aktiverat:

• Minuter - Grupperar träningsindikatorer per minut
• Sekunder - Grupperar träningsindikatorer per sekund

Exportinställningar

Exportformat

Välj formatet för dina exporterade data:

• JSON-format - Ger detaljerade datastrukturer med kapslade objekt. Bäst för API:er, databaser och applikationer som behöver strukturerade data. JSON-format inkluderar mer detaljerad information för komplexa datatyper som sömnfaser och AFib-avläsningar.

• CSV-format - Ger tabelldata som enkelt kan importeras till kalkylprogram. Bäst för enkel dataanalys eller när din endpoint förväntar sig CSV-data.

Obs: Content-Type-headern sätts automatiskt till application/json för JSON-export och multipart/form-data för CSV-export.

Exportversion

Välj en Exportversion. Versionshantering gör att du kan övergå mellan uppdaterade versioner av exporten i din egen takt och minimerar ändringar som bryter arbetsflöden.

• Version 1 - Äldre format, använd om du har befintliga arbetsflöden som är beroende av detta format
• Version 2 - Aktuellt format med förbättrade träningsdata och mer detaljerade metadataalternativ

Datumintervall

Välj när data ska exporteras:

• Standard - Synkroniserar data för hela föregående dag plus data fram till aktuellt datum och tid
• Sedan senaste synkronisering - Vid varje synkronisering exporteras all data sedan senaste gången exporten kördes fram till aktuellt datum och tid
• Idag - Synkroniserar all data för aktuellt datum fram till aktuell tid
• Igår - Synkroniserar all data för hela föregående dag
• Senaste 7 dagarna - Synkroniserar data för de senaste sju dagarna

Sammanfatta data

När du använder JSON-format med datatyp Hälsoindikatorer, växla Sammanfatta data PÅ eller AV.

• PÅ - Ger aggregerade datasammanfattningar
• AV - Ger desaggregerade data där det är möjligt, visar individuella datapunkter

Obs: Denna inställning gäller endast JSON-format med Hälsoindikatorer. Data aggregeras alltid när du använder CSV-format eller när flera indikatorer är valda.

Tidsgruppering

När du använder JSON-format med Sammanfatta data aktiverat, välj hur data ska aggregeras.

Obs: CSV-format aggregerar alltid data. Aggregering på minut- och sekundnivå kan avsevärt öka bearbetningstiden och datastorleken.

Batch-förfrågningar

När du använder JSON-format, växla Batch-förfrågningar PÅ för att skicka data i batchar över flera förfrågningar istället för en enda nyttolast.

• PÅ - Sprider data över flera förfrågningar för att undvika oöverkomligt stora nyttolaster
• AV - Skickar all data i en enda förfrågan

Synkroniseringsfrekvens

Konfigurera hur ofta automatiseringen ska ladda upp data:

Välj ett nummer och intervall.

Testning och verifiering

Manuell testning

1. Tryck på "Manuell export" i automationskonfigurationsskärmen
2. Välj ett datumintervall
3. Tryck på "Exportera" för att skicka en testförfrågan
4. Kontrollera din endpoint för att bekräfta att data mottogs

Visa aktivitetsloggar

1. Tryck på "Visa aktivitetsloggar" i automationskonfigurationsskärmen
2. Granska senaste automationskörningar
3. Kontrollera efter fel eller varningar
4. Verifiera förfrågnings tidsstämplar och svarsstatus

Verifiera dataformat

Appen inkluderar automatiskt dessa headers i varje förfrågan:

• Content-Type - Satt baserat på exportformat
• automation-name - Namnet på din automatisering
• automation-id - Unik identifierare för automatiseringen
• automation-aggregation - Den valda tidsgrupperingen
• automation-period - Det valda datumintervallet
• session-id - Unik identifierare för varje förfrågan

Felsökning

Vanliga problem

Data mottas inte vid endpoint

• Verifiera att endpoint-URL:en är korrekt
• Kontrollera att din endpoint accepterar POST-förfrågningar
• Granska autentiseringsheaders
• Kontrollera endpoint-loggar för inkommande förfrågningar
• Verifiera nätverksanslutning

Tips och bästa praxis

1. Prestanda:

   • Använd lämplig tidsgruppering för att balansera detalj vs. datastorlek
   • Välj endast de indikatorer du behöver

2. Tillförlitlighet:

   • Sätt lämpliga timeout-värden baserat på din endpoints svarstid
   • Övervaka aktivitetsloggar regelbundet

3. Dataformat:

   • Använd JSON för strukturerade data och API:er
   • Använd CSV för enkel dataanalys eller kalkylprogramintegration
   • Överväg batch-förfrågningar för stora dataset eller separat bearbetning