시작하기
설치부터 첫 발행 성공까지 약 10분이면 충분합니다.
1. 설치하고 건강 접근 권한 부여하기
첫 실행 시 Courier는 운동과 수면에 대한 읽기 전용 접근을 요청합니다. 보여 주고 싶은 카테고리를 허용해 주세요.
iOS는 답을 숨깁니다
Apple은 앱이 읽기 접근의 허용/거부 여부를 조회하는 것을 허용하지 않습니다 — 거부는 그저 "데이터 없음"처럼 보일 뿐입니다. Courier가 계속 인쇄 대기 상태라면 건강 앱 → 프로필 → 개인정보 보호 → 앱 → Courier에서 해당 카테고리가 켜져 있는지 확인하세요. Courier의 편집부 → 데이터 소스 페이지에서 바로 이동할 수 있습니다.
2. 오늘의 호 살펴보기
오늘 탭에는 현재 호가 표시됩니다: 어젯밤의 수면(단계, 시간, 점수, 신체 지표)과 어제의 운동(지도, 심박수, 페이스, 고도). iPhone이 방금 Apple Watch에서 동기화했다면 당겨서 새로고침하세요.
3. 첫 구독자 추가하기
구독자는 데이터를 받는 엔드포인트입니다. 첫 테스트에는 서버가 필요 없습니다.
- 아무 컴퓨터에서나 webhook.site를 열고 고유 URL을 복사합니다.
- Courier에서: 편집부 → 구독자 → 추가.
- 이름을 붙이고(예:
Test), URL을 붙여넣고, 메서드는POST그대로 둡니다. - 이 구독자가 받을 데이터 종류를 선택합니다: 운동, 수면, 주석, 날씨. 데이터가 있는 쪽으로 운동 또는 수면을 고르세요.
- 저장합니다. webhook.site에는 인증을 없음으로 두어도 됩니다.
하나의 구독자는 정확히 한 종류의 데이터만 받습니다. 운동과 수면을 모두 보내려면 구독자를 두 개 추가하세요(같은 URL을 공유해도 됩니다).
4. 무언가 발행해 보기
구독자 편집기의 테스트 버튼으로 샘플을 즉시 보낼 수 있습니다 — HTTP 응답이 앱 안에 표시됩니다. 그다음 webhook.site를 확인하면 canonical JSON 레코드가 도착해 있습니다. 이 JSON 형태는 JavaScript 변환에 문서화되어 있으며, 변환 스크립트가 없을 때 서버가 받는 내용과 정확히 같습니다.
실제 데이터를 보내려면 편집부 → 일괄 발행에서 날짜 범위를 골라 수동으로 발행하거나, 그냥 기다리세요. 자동 발행이 켜져 있으면(기본값) 다음 운동 이나 수면이 저절로 배달됩니다.
5. 알아서 돌아가게 두기
- 백그라운드 배달: Apple 건강에 새 데이터가 들어오면 iOS가 Courier를 잠깐 깨우고, Courier가 자동으로 발행합니다. 타이밍은 시스템이 제한합니다 — 몇 분에서 한 시간 정도, 최악의 경우 다음에 앱을 열 때입니다. 이것은 iOS의 제약이며, Courier는 이를 솔직하게 알려 줍니다.
- 알림: 편집부 → 알림에서 항상 알림 또는 실패 시에만을 선택할 수 있습니다.
- 실패: 배달되지 못한 것은 모두 사유와 함께 주의 필요에 들어가 수동 재시도를 기다립니다 — 아무것도 조용히 버려지지 않고, 아무것도 몰래 재시도되지 않습니다.
6. 선택적인 편의 기능
- 홈 화면이나 잠금 화면에 위젯을 추가하세요 — 위젯.
- 하루에 대한 생각을 받아쓰기하세요 — 주석.
- 서버에 맞게 페이로드를 다듬으세요 — JavaScript 변환.
- Siri로 자동화하세요 — 단축어.