REST API へ Apple Health データを同期
ヘルスデータを REST API エンドポイントに送信します。
最終更新: 2026年10月31日
このページの内容
HTTP POST リクエストを受け付けるエンドポイントへヘルスエクスポートを送信します。
重要 — 自動化の制限事項: ヘルスデータを読み取るにはデバイスのロック解除が必要で、iOS は選んだ頻度でのバックグラウンド実行を保証しません。自動エクスポートに頼る前に 自動化の制限事項 を確認してください。
自動化を開く
iPhone では エクスポート → 自動化 を、iPad ではサイドバーの 自動化 を開きます。新規自動化 を選ぶか、既存の自動化を開いて編集します。
名前、状態、通知
この自動化を識別する名前を入力します。有効 は自動実行を許可します。準備ができるまではオフのままにします。
必要な実行通知を選びます:
- キャッシュ更新時に通知 はエクスポートデータの準備完了を報告します。
- 実行時に通知 はエンドポイントへのアップロード成功を報告します。
求められたら通知を許可します。これらの通知はアクティビティを報告するだけで、実行をスケジュールしません。
エンドポイントのセットアップ
- 自動化の種類 として REST API を選びます。
- iPhone または iPad から到達可能な URL を入力します(例:
https://api.example.com/health-data)。 - HTTP ヘッダー の下に必要な認証を追加します。たとえば、キーに
Authorization、値にBearer YOUR_TOKENを使います。 - エンドポイントに適した リクエストタイムアウト を選びます。
各ヘッダーにはキーと値の両方が必要です。別デバイス上のサーバーには、localhost ではなく到達可能なネットワークアドレスを使います。
データタイプ設定
この自動化の データタイプ を 1 つ選びます: ヘルス指標、ワークアウト、症状、ECG、心拍数通知、心の状態、周期トラッキング、または薬。心の状態は iOS 18 以降、薬は iOS 26 以降と個別の薬アクセスが必要です。
ヘルス指標
ヘルス指標 を選び、ヘルス指標を選択 を開いて必要な測定値を選びます。
特定のアプリやデバイスの測定値に限定するには、優先ソース を開き、指標を選んでソースを選択します。すべて は除外されていないすべてのソースを許可します。除外ソース で、この自動化のヘルス指標全体からソースを無視できます。除外が優先されます。優先ソースにデータがない場合でも、未選択のソースは代用されません。保存 でソース選択を適用し、キャンセル で破棄します。
ワークアウト
ワークアウト を選ぶと、ワークアウト記録をエクスポートします。ルートデータを含める は利用可能なルートポイントを JSON ワークアウトデータに追加します。別個の GPX アップロードは作成しません。
バージョン 2 では、ワークアウト指標を含める をオンにして心拍数、アクティブエネルギー、歩数などの測定値を追加します。ワークアウト指標の 時間グループ化 で 分 または 秒 を選びます。秒の方が詳細でエクスポートが大きくなります。バージョン 1 は常にワークアウト指標を含めます。
エクスポート設定
エクスポート形式
- JSON は連携と分析向けに構造化データを保持します。
- CSV は表計算向けの表形式ファイルを作成します。
- Markdown はメモとアーカイブ向けの読みやすい見出しと表を作成します。
エクスポートバージョン
現在のデータ構造には バージョン 2 を選びます。既存のワークフローが古い形式に依存する場合は バージョン 1 を使います。
日付範囲
| 選択 | 含まれるデータ |
|---|---|
| デフォルト | 前日と、実行時刻までの本日 |
| 前回の同期以降 | 前回の同期から実行時刻まで |
| 今日 | 実行時刻までの本日 |
| 昨日 | 直前の 1 全日 |
| 過去 7 日 | 直前の 7 全日 |
データの要約と時間グループ化
JSON + ヘルス指標 では、データを要約 をオンにして測定値を時間グループにまとめるか、対応する場合はオフにして個別測定値にします。要約は指標によって異なります。たとえば歩数は合計され、体重の測定値は平均されます。CSV のヘルス指標エクスポートは要約データを使います。
時間グループ化 が利用できる場合は、保持する詳細度を選びます。時間または日のグループは、分または秒のグループより行数が少なくなります。利用できる選択肢は日付範囲と形式によって異なります。ワークアウトの時間グループ化はワークアウト設定で別途行います。
バッチリクエストと大きなペイロード
REST API + JSON では、バッチリクエスト をオンにして複数のリクエストに分けてデータを送信します。エンドポイントが大きな本文を拒否する場合や、大きなリクエストがタイムアウトする場合に使います。受信サービスは各リクエストを個別に処理する必要があります。
バッチは CSV と Markdown では利用できません。個別リクエストのサイズは減りますが、デバイスが読み取るヘルスデータの量は減りません。準備が遅い場合は パフォーマンス を参照してください。
スケジュールリマインダー
ロック解除とアプリ起動の促しが必要な場合は、リマインダーを有効にする をオンにします。毎時、毎日、または 選択した曜日 を選び、必要に応じて分、時刻、曜日を設定します。求められたら通知アクセスを許可し、拒否されている場合は 通知設定を開く を使います。
リマインダーは自動化を実行せず、同期成功も確認しません。タップして自動化を開くか、通知の 開いて同期 で実行を要求します。自動化は有効である必要があります。成功したバックグラウンド実行のあともリマインダーが表示されることがあります。リマインダーの変更は保存時に適用されます。
同期間隔と保存
同期間隔 で数値と 分、時間、日、または 週 を選びます(例: 15 分ごと)。これは希望するバックグラウンドの間隔であり、保証されたスケジュールではありません。
ヘルスデータの読み取り時はデバイスのロック解除が必要です。Health Auto Export のバックグラウンド App の更新を有効にし、自動実行のため低電力モードをオフにします。デバイスが非アクティブだった場合やシステムリソースが限られている場合、iOS が実行を遅らせることがあります。
自動実行の準備ができたら 有効 をオンにし、更新 で自動化を保存します。下記の手順ですぐに選択した日付範囲をアップロードできます。
リクエストヘッダー
アプリは選択した形式の Content-Type を設定し、次を含めます:
| ヘッダー | 意味 |
|---|---|
automation-name |
自動化名 |
automation-id |
自動化識別子 |
automation-aggregation |
選択した時間グループ化 |
automation-period |
選択した日付範囲 |
session-id |
リクエスト識別子 |
履歴または漏れたデータをエクスポートする
自動化の初回設定時に履歴データをエクスポートする、またはあとから自動同期で漏れた日付を補うために 手動アップロード を使います。設定確認にも使えます。
- 自動化を開き、既存データをエクスポート の下で 手動アップロード を選びます。
- 開始 と 終了 の日付を設定し、エクスポートを開始 を選びます。
- エンドポイントが受信したリクエスト、ヘッダー、本文を確認します。
トラブルシューティング
- リクエストが届かない: URL、ネットワーク到達性、サーバーログを確認します。
- 認証エラー: ヘッダーキー、トークン、エンドポイントの権限を確認します。
- ペイロード拒否またはタイムアウト: サーバーのサイズ制限を確認し、JSON でバッチを使うか、エクスポートサイズを減らします。
自動化を開き アクティビティログを表示 で実行を確認します。警告 はデータ取得の遅延などの潜在的な問題を示し、エラー は失敗したステップを示します。問題の報告方法は ヘルプを得る を参照してください。