딥 링크 자동화
iPhone 또는 iPad에서 URL을 열어 REST API 자동화를 만듭니다.
최근 업데이트: 2026년 10월 31일
이 페이지에서
iPhone 또는 iPad에서 URL을 열어 REST API 자동화를 만듭니다. 딥 링크는 다른 대상을 구성하지 않습니다.
URL 형식
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export
url은 필수입니다. 알아보기 쉬운 name을 지정하세요. 생략하면 기본값은 Automation입니다. 매개변수 이름은 대소문자를 구분하지 않습니다. 공백이나 예약 문자가 포함된 매개변수 값은 URL 인코딩하세요.
기기에서 URL을 열거나 단축어의 URL 열기를 사용합니다. 활성화하기 전에 Health Auto Export에서 생성된 자동화를 확인하세요.
매개변수 참조
불리언은 true/false, 1/0 또는 yes/no를 받습니다. 데이터별 옵션 앞에 datatype을 설정하고, format을 aggregatedata 앞에 설정해 이후 선택이 이전 설정을 바꾸지 않도록 합니다.
기본 설정
| 매개변수 | 값 또는 의미 | 기본값 |
|---|---|---|
url |
기기에서 도달 가능한 엔드포인트 URL | 필수 |
name |
비어 있지 않은 자동화 이름 | Automation |
enabled |
자동 실행 활성화 | false |
datatype |
아래 데이터 유형 | healthMetrics |
format |
json, csv, markdown 또는 md |
json |
exportversion |
v1, v2, 1 또는 2 |
v2 |
period |
none, lastsync, today, yesterday, previous7days |
none |
requesttimeout |
정수 초, 60–86400 | 60 |
headers |
쉼표로 구분된 키/값 쌍 | 없음 |
batchrequests |
불리언. JSON만 | false |
유효한 데이터 유형은 healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking, medications입니다. 마음 상태는 iOS 18 이상, 약물 내보내기는 iOS 26 이상이 필요합니다.
날짜 범위 의미는 날짜 범위를 참조하세요. 모든 딥 링크는 REST API 자동화를 만듭니다. exportDestination 매개변수는 없습니다.
건강 지표
| 매개변수 | 값 또는 의미 | 기본값 |
|---|---|---|
metrics |
Step Count,Heart Rate처럼 쉼표로 구분된 정확한 지표 이름 |
사용 가능한 모든 지표 |
aggregatedata |
불리언. 지원되는 경우 개별 측정값에는 false |
true |
interval |
none, minutes, hours, days, weeks, months, years |
none |
aggregatesleep |
수면 요약을 제어하는 불리언 | true |
metrics, aggregatedata, interval은 건강 지표에 적용됩니다. CSV를 선택하면 요약이 켜집니다. 개별 측정값에는 JSON을 사용하세요. 링크를 만들 때 원하는 요약을 명시하세요.
운동
| 매개변수 | 값 또는 의미 | datatype=workouts일 때 기본값 |
|---|---|---|
includeroutes |
불리언 | true |
includeworkoutmetadata |
불리언 | true |
workoutsmetadatainterval |
minutes 또는 seconds. 버전 2 |
minutes |
workouttypes |
쉼표로 구분된 부호 없는 Apple 운동 유형 식별자 | 모든 종류 |
운동 링크에 건강 지표 집계 옵션을 포함하지 마세요.
주기 및 알림
| 매개변수 | 값 또는 의미 | 기본값 |
|---|---|---|
syncinterval |
minutes, hours, days, weeks |
minutes |
syncquantity |
양의 정수 간격 수 | 5 |
notifyonupdate |
불리언. 데이터 준비 후 알림 | true |
notifywhenrun |
불리언. 대상 작업 성공 후 알림 | true |
주기는 백그라운드 및 건강 데이터 제한의 적용을 받으며 정확한 일정이 아닙니다.
인증 및 인코딩
headers 값은 키와 값이 번갈아 나옵니다:
headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY
각 키에는 값이 필요합니다. 쉼표가 쌍을 구분하므로 이 링크 형식에서는 쉼표가 포함된 헤더 값을 피하세요. 공백은 %20, 플러스는 %2B, 앰퍼샌드는 %26으로 인코딩합니다. 엔드포인트 URL에 자체 쿼리 매개변수가 있으면 URL 전체를 인코딩하세요.
예
선택한 지표, 시간 단위로 요약
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
경로가 있는 운동
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
두 예 모두 자동화를 검토하고 활성화할 때까지 자동 실행은 비활성 상태입니다.
문제 해결
- URL 또는 매개변수 오류: 최소 URL부터 시작해 철자와 인코딩을 확인한 뒤 옵션을 하나씩 추가하세요.
- 잘못된 지표: 공백과 대소문자를 포함해 정확한 지표 이름을 사용하세요.
- 집계 오류: 건강 지표 옵션은
datatype=healthMetrics에서만 사용하세요. - 운동 설정 오류: 운동 옵션은
datatype=workouts와 함께 사용하고, 초 그룹화에는 버전 2가 필요합니다. - 일괄 오류:
format=json으로 설정하거나batchrequests를 끄세요. - 잘못된 주기/타임아웃: 지원되는 간격, 양의 수량, 60–86400초 타임아웃을 사용하세요.
- URL이 너무 김: 지표/헤더 목록을 줄이거나 나머지 설정은 앱에서 하세요.
생성 후에는 REST API — 기록 또는 놓친 데이터 내보내기로 선택한 범위를 업로드하거나 설정을 확인하세요.