Apple Health Skill
Chat with your Apple Health data using AI. Ask about your workouts, heart rate trends, activity rings, VO2 Max, and more. Powered by Transition, which syncs with Apple Health to give AI agents access to your fitness data.
Setup
- 1. Download Transition and grant Apple Health access
- Go to Settings > API Keys and tap Generate New Key
- Set the environment variable:
CODEBLOCK0
No Auth Required
Workout of the Day
Generate a random structured workout — no account needed.
CODEBLOCK1
Parameters:
- -
sport — run, bike, swim, or strength (default: run) - INLINECODE6 — minutes, 10-300 (default:
45)
Authenticated Endpoints
Base URL: https://api.transition.fun
Auth: Pass X-API-Key header on every request.
AI Coach Chat
Ask questions about your Apple Health data. The AI coach has full context on your workouts and health metrics.
CODEBLOCK2
Example questions:
- - "How many workouts did I do this week?"
- "What's my VO2 Max trend?"
- "How has my sleep been trending this week?"
- "Compare my running pace this month vs last month"
- "Should I take a rest day based on my recent training?"
Get Workouts
Retrieve scheduled workouts for a date range.
CODEBLOCK3
Parameters:
- -
start — Start date (YYYY-MM-DD, required) - INLINECODE11 — End date (YYYY-MM-DD, required)
- Maximum range between
start and end is 90 days.
Performance Management Chart (PMC)
Get CTL (fitness), ATL (fatigue), and TSB (form) calculated from your Apple Health workouts.
CODEBLOCK4
Performance Stats
Get FTP, threshold paces, heart rate zones, and other metrics derived from your Apple Health data.
CODEBLOCK5
Athlete Profile
CODEBLOCK6
Chat History
CODEBLOCK7
Rate Limits
| Tier | Read Endpoints | AI Endpoints |
|---|
| Free | 100/day | 3/day |
| Paid |
10,000/day | 100/day |
Tips for Agents
- 1. Use coach chat as the primary interface. It has full context on the user's Apple Health workouts, heart rate, and performance — just ask natural questions.
- 2. Check fatigue before recommending hard workouts. Call
GET /api/v1/performance/pmc and look at TSB. If TSB is below -20, the athlete is fatigued.
- 3. Use the free WOD endpoint for quick workouts. No auth needed — great for users who just want a workout suggestion.
- 4. Date format is always YYYY-MM-DD for all date parameters.
Apple Health 技能
使用AI与您的Apple Health数据对话。询问您的锻炼、心率趋势、活动圆环、最大摄氧量等信息。由Transition提供支持，该应用与Apple Health同步，使AI代理能够访问您的健身数据。
设置
- 1. 下载Transition并授予Apple Health访问权限
- 前往设置 > API密钥，点击生成新密钥
- 设置环境变量：
bash
export TRANSITIONAPIKEY=trlivexxxxxxxxxxxxxxxxxxxxx
无需认证
每日训练
生成一个随机结构化训练计划——无需账户。
bash
curl https://api.transition.fun/api/v1/wod?sport=run&duration=45
参数：
- - sport — run（跑步）、bike（骑行）、swim（游泳）或strength（力量）（默认：run）
- duration — 分钟数，10-300（默认：45）
需要认证的端点
基础URL： https://api.transition.fun
认证： 每次请求需传递X-API-Key标头。
AI教练聊天
询问关于您Apple Health数据的问题。AI教练掌握您锻炼和健康指标的完整上下文。
bash
curl -X POST -H X-API-Key: $TRANSITIONAPIKEY \
-H Content-Type: application/json \
-d {message: 过去一个月我的静息心率如何变化？} \
https://api.transition.fun/api/v1/coach/chat
示例问题：
- - 这周我做了多少次锻炼？
- 我的最大摄氧量趋势如何？
- 这周我的睡眠趋势如何？
- 比较我这个月与上个月的跑步配速
- 根据我最近的训练，我是否应该休息一天？
获取锻炼记录
检索指定日期范围内的计划锻炼。
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15
参数：
- - start — 开始日期（YYYY-MM-DD，必填）
- end — 结束日期（YYYY-MM-DD，必填）
- start和end之间的最大范围为90天。
绩效管理图表（PMC）
获取根据您Apple Health锻炼数据计算得出的CTL（体能）、ATL（疲劳）和TSB（状态）。
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/performance/pmc
绩效统计
获取根据您Apple Health数据得出的FTP、阈值配速、心率区间及其他指标。
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/performance/stats
运动员档案
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/profile
聊天记录
bash
curl -H X-API-Key: $TRANSITIONAPIKEY \
https://api.transition.fun/api/v1/coach/history
速率限制
10,000次/天 | 100次/天 |
代理使用技巧
- 1. 将教练聊天作为主要界面。 它拥有用户Apple Health锻炼、心率和绩效的完整上下文——只需用自然语言提问即可。
- 2. 在推荐高强度训练前检查疲劳程度。 调用GET /api/v1/performance/pmc并查看TSB。如果TSB低于-20，说明运动员处于疲劳状态。
- 3. 使用免费的WOD端点获取快速训练计划。 无需认证——非常适合只想获得训练建议的用户。
- 4. 所有日期参数的格式始终为YYYY-MM-DD。
