Hjälpcenter HealthyApps
Svenska
Hjälpcenter
Huvudwebbplats ↗

Sök bland hjälpämnen

Deep Link-automatisering

Skapa en REST API-automatisering genom att öppna en URL på din iPhone eller iPad.

Senast uppdaterad: 31 oktober 2026

På denna sida
URL-format
Parameterreferens Parameterreferens Grundläggande inställningarHälsomåttTräningspassKadens och aviseringar
Autentisering och kodning
Exempel Exempel Valda mått, summerade per timmeTräningspass med rutter
FelsökningRelaterad dokumentation

Skapa en REST API-automatisering genom att öppna en URL på din iPhone eller iPad. Deep links konfigurerar inte andra destinationer.

URL-format

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export

url är obligatoriskt. Ange ett beskrivande name; om det utelämnas är standardvärdet Automation. Parameternamn skiljer inte mellan stora och små bokstäver. URL-koda parametervärden som innehåller mellanslag eller reserverade tecken.

Öppna URL:en på din enhet, eller använd Öppna URL:er i Genvägar. Granska den skapade automatiseringen i Health Auto Export innan du aktiverar den.

Parameterreferens

Booleska värden accepterar true/false, 1/0 eller yes/no. Ange datatype före dess dataspecifika inställningar och format före aggregatedata, så att senare val inte ersätter tidigare inställningar.

Grundläggande inställningar

Parameter Värden eller betydelse Standard
url Slutpunkts-URL som är nåbar från din enhet Obligatorisk
name Icke-tomt automatiseringsnamn Automation
enabled Aktivera automatiska körningar false
datatype Datatyp listad nedan healthMetrics
format json, csv, markdown eller md json
exportversion v1, v2, 1 eller 2 v2
period none, lastsync, today, yesterday, previous7days none
requesttimeout Heltalssekunder, 60–86400 60
headers Kommaseparerade nyckel/värde-par Ingen
batchrequests Boolesk; endast JSON false

Giltiga datatyper är healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking och medications. Sinnesstämning kräver iOS 18 eller senare; läkemedelsexporter kräver iOS 26 eller senare.

Se Datumintervall för betydelser av datumintervall. Alla deep links skapar REST API-automatiseringar; det finns ingen exportDestination-parameter.

Hälsomått

Parameter Värden eller betydelse Standard
metrics Kommaseparerade exakta måttnamn, såsom Step Count,Heart Rate Alla tillgängliga mått
aggregatedata Boolesk; använd false för enskilda mätvärden där det stöds true
interval none, minutes, hours, days, weeks, months, years none
aggregatesleep Boolesk som styr sömnsummering true

metrics, aggregatedata och interval gäller för hälsomått. CSV-val slår på summering; använd JSON för enskilda mätvärden. Ange önskad summering uttryckligen när du genererar länkar.

Träningspass

Parameter Värden eller betydelse Standard när datatype=workouts
includeroutes Boolesk true
includeworkoutmetadata Boolesk true
workoutsmetadatainterval minutes eller seconds; Version 2 minutes
workouttypes Kommaseparerade osignerade Apple-träningstypidentifierare Alla typer

Inkludera inte aggregeringsinställningar för hälsomått i en träningslänk.

Kadens och aviseringar

Parameter Värden eller betydelse Standard
syncinterval minutes, hours, days, weeks minutes
syncquantity Positivt heltalsantal intervaller 5
notifyonupdate Boolesk; meddela efter dataförberedelse true
notifywhenrun Boolesk; meddela efter en lyckad destinationsåtgärd true

Kadensen är fortfarande underställd bakgrunds- och hälsodatagränser; det är inte ett exakt schema.

Autentisering och kodning

Värdet headers består av växlande nycklar och värden:

headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY

Varje nyckel kräver ett värde. Komman separerar par, så undvik huvudvärden som innehåller komman i det här länkformatet. Koda mellanslag som %20, plustecken som %2B och et-tecken som %26. Koda den fullständiga slutpunkts-URL:en när den har egna frågeparametrar.

Exempel

Valda mått, summerade per timme

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fmetrics&name=Steps%20and%20Heart%20Rate&datatype=healthMetrics&format=json&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours

Träningspass med rutter

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fworkouts&name=Workout%20Export&datatype=workouts&format=json&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes

Båda exemplen lämnar automatiska körningar inaktiverade tills du granskar och aktiverar automatiseringen.

Felsökning

  • URL- eller parameterfel: Börja med den minimala URL:en, kontrollera stavning och kodning och lägg sedan till inställningar en i taget.
  • Ogiltigt mått: Använd det exakta måttnamnet, inklusive mellanslag och stora/små bokstäver.
  • Aggregeringsfel: Använd inställningar för hälsomått bara med datatype=healthMetrics.
  • Fel i träningsinställningar: Använd träningsinställningar med datatype=workouts; sekundgruppering kräver Version 2.
  • Batchningsfel: Ange format=json, eller inaktivera batchrequests.
  • Ogiltig kadens/timeout: Använd de stödda intervallen, en positiv mängd och en timeout från 60 till 86400 sekunder.
  • URL för lång: Minska listan över mått/huvuden, eller konfigurera övriga inställningar i appen.

Efter skapande använder du REST API — Exportera historiska eller missade data för att ladda upp ett valt intervall eller kontrollera din konfiguration.

Relaterad dokumentation