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
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 inaktiverabatchrequests. - 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.