快速上手
从安装到第一次发行成功,大约十分钟。
1. 安装并授予健康权限
首次启动时,Courier 会申请运动与睡眠的只读权限。勾选你愿意让它看到的 类别。
iOS 会隐瞒答案
苹果不允许 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 自动化——快捷指令。