Automatizare Deep Link

Creați o automatizare REST API deschizând un URL pe iPhone sau iPad. Deep link-urile nu configurează alte destinații.

Format URL

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

url este obligatoriu. Furnizați un name descriptiv; dacă este omis, valoarea implicită este Automation. Numele parametrilor nu țin cont de majuscule. Codificați URL valorile parametrilor care conțin spații sau caractere rezervate.

Deschideți URL-ul pe dispozitiv, sau folosiți Open URLs în Shortcuts. Examinați automatizarea creată în Health Auto Export înainte de a o activa.

Referință parametri

Booleenele acceptă true/false, 1/0 sau yes/no. Setați datatype înaintea opțiunilor sale specifice datelor, și format înaintea aggregatedata, astfel încât selecțiile ulterioare să nu înlocuiască setările anterioare.

Setări de bază

Parametru	Valori sau semnificație	Implicit
url	URL endpoint accesibil de pe dispozitiv	Obligatoriu
name	Nume de automatizare nevid	Automation
enabled	Activează rulările automate	false
datatype	Tipul de date listat mai jos	healthMetrics
format	json, csv, markdown sau md	json
exportversion	v1, v2, 1 sau 2	v2
period	none, lastsync, today, yesterday, previous7days	none
requesttimeout	Secunde întregi, 60–86400	60
headers	Perechi cheie/valoare separate prin virgulă	Niciuna
batchrequests	Boolean; doar JSON	false

Tipurile de date valide sunt healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking și medications. Stare de spirit necesită iOS 18 sau ulterior; exporturile de medicamente necesită iOS 26 sau ulterior.

Pentru semnificațiile intervalelor de date, consultați Interval de date. Toate deep link-urile creează automatizări REST API; nu există un parametru exportDestination.

Metrici de sănătate

Parametru	Valori sau semnificație	Implicit
metrics	Nume exacte de metrici separate prin virgulă, cum ar fi Step Count,Heart Rate	Toate metricile disponibile
aggregatedata	Boolean; folosiți false pentru citiri individuale unde este suportat	true
interval	none, minutes, hours, days, weeks, months, years	none
aggregatesleep	Boolean care controlează rezumarea somnului	true

metrics, aggregatedata și interval se aplică metricilor de sănătate. Selecția CSV activează rezumarea; folosiți JSON pentru citiri individuale. Specificați explicit rezumarea dorită când generați linkuri.

Antrenamente

Parametru	Valori sau semnificație	Implicit când datatype=workouts
includeroutes	Boolean	true
includeworkoutmetadata	Boolean	true
workoutsmetadatainterval	minutes sau seconds; Versiunea 2	minutes
workouttypes	Identificatori unsigned Apple workout-type separați prin virgulă	Toate tipurile

Nu includeți opțiuni de agregare a metricilor de sănătate într-un link de antrenament.

Cadență și notificări

Parametru	Valori sau semnificație	Implicit
syncinterval	minutes, hours, days, weeks	minutes
syncquantity	Număr întreg pozitiv de intervale	5
notifyonupdate	Boolean; notifică după pregătirea datelor	true
notifywhenrun	Boolean; notifică după o acțiune reușită la destinație	true

Cadența rămâne supusă limitelor de fundal și de date de sănătate; nu este un program exact.

Autentificare și codificare

Valoarea headers constă din chei și valori alternate:

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

Fiecare cheie necesită o valoare. Virgulele separă perechile, deci evitați valorile de antet care conțin virgule în acest format de link. Codificați spațiile ca %20, semnele plus ca %2B și ampersandurile ca %26. Codificați URL-ul complet al endpointului când are propriii parametri de interogare.

Exemple

Metrici selectate, rezumate orar

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

Antrenamente cu rute

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

Ambele exemple lasă rulările automate dezactivate până examinați și activați automatizarea.

Depanare

• Eroare URL sau parametru: Începeți cu URL-ul minimal, verificați ortografia și codificarea, apoi adăugați opțiunile individual.
• Metrică invalidă: Folosiți numele exact al metricii, inclusiv spațiile și majusculele.
• Eroare de agregare: Folosiți opțiunile de metrici de sănătate doar cu datatype=healthMetrics.
• Eroare setări antrenament: Folosiți opțiunile de antrenament cu datatype=workouts; gruparea pe secundă necesită Versiunea 2.
• Eroare batching: Setați format=json sau dezactivați batchrequests.
• Cadență/timeout invalid: Folosiți intervalele suportate, o cantitate pozitivă și un timeout de la 60 la 86400 de secunde.
• URL prea lung: Reduceți lista de metrici/antete sau configurați setările rămase în aplicație.

După creare, folosiți REST API — Exportați date istorice sau ratate pentru a încărca un interval selectat sau a verifica configurarea.

Documentație conexă

• Ghid automatizare REST API
• Prezentare generală automatizări