快速上手
從安裝到第一次發行成功,大約十分鐘。
1. 安裝並授予健康權限
首次啟動時,Courier 會申請運動與睡眠的唯讀權限。勾選你願意讓它看到的 類別。
iOS 會隱瞞答案
Apple 不允許 App 查詢「讀」權限到底給沒給——被拒絕和「沒有資料」看起來一模 一樣。如果 Courier 一直顯示本版待印,去 健康 App → 頭像 → 隱私權 → App → Courier 檢查類別開關。編輯部 → 資料來源頁有直達連結。
2. 翻翻今刊
今刊標籤頁展示當期內容:昨晚睡眠(階段、時數、睡眠分數、體徵)與昨日運動 (地圖、心率、配速、海拔)。如果 iPhone 剛從 Apple Watch 同步完,下拉重新 整理一下。
3. 新增第一個訂戶
訂戶就是接收你資料的端點。第一次測試不需要真的伺服器:
- 在電腦上打開 webhook.site,複製你的專屬 URL。
- 在 Courier 裡:編輯部 → 訂戶 → 新增。
- 取個名字(比如
測試),貼上 URL,方法保持POST。 - 選擇這個訂戶接收的資料類型:運動、睡眠、批註或天氣。 選運動或睡眠——看你手頭有哪種資料。
- 儲存。webhook.site 不需要驗證,選 無 即可。
一個訂戶只接收一種資料。想同時發運動和睡眠,就建兩個訂戶(URL 可以 相同)。
4. 發點什麼
訂戶編輯頁的測試按鈕會立刻傳送一條樣本——HTTP 回應直接顯示在 App 裡。 然後去 webhook.site 看:canonical JSON 紀錄已經躺在那裡了。這個 JSON 的 結構見JavaScript 轉換腳本——不掛腳本時,你的 伺服器收到的就是它。
要發真實資料,打開編輯部 → 批次發行,選個日期區間手動發;或者乾脆等: 自動發行預設開啟,下一次運動或下一晚睡眠會自己送達。
5. 讓它自己跑
- 背景投遞:Apple 健康收到新資料後,iOS 會短暫喚醒 Courier 自動發行。 時機受系統節流——幾分鐘到一小時上下,最壞要到下次打開 App 才發。這是 iOS 的限制,Courier 對此如實相告。
- 通知:編輯部 → 通知,可選始終通知或僅失敗時。
- 失敗:發不出去的項目會帶著原因進待處理,等你手動重試——不會 悄悄丟棄,也不會背著你重發。
6. 錦上添花
- 把小工具加到主畫面或鎖定畫面——小工具。
- 口述你對這一天的想法——批註。
- 為伺服器自訂請求主體——JavaScript 轉換腳本。
- 搭配 Siri 自動化——捷徑。