ヘルプセンター HealthyApps
日本語
ヘルプセンター
メインサイト ↗

ヘルプを検索

REST API へ Apple Health データを同期

ヘルスデータを REST API エンドポイントに送信します。

最終更新: 2026年10月31日

このページの内容
自動化を開く名前、状態、通知エンドポイントのセットアップ
データタイプ設定 データタイプ設定 ヘルス指標ワークアウト
エクスポート設定 エクスポート設定 エクスポート形式エクスポートバージョン日付範囲データの要約と時間グループ化
バッチリクエストと大きなペイロードスケジュールリマインダー同期間隔と保存リクエストヘッダー履歴または漏れたデータをエクスポートするトラブルシューティング

HTTP POST リクエストを受け付けるエンドポイントへヘルスエクスポートを送信します。

重要 — 自動化の制限事項: ヘルスデータを読み取るにはデバイスのロック解除が必要で、iOS は選んだ頻度でのバックグラウンド実行を保証しません。自動エクスポートに頼る前に 自動化の制限事項 を確認してください。

自動化を開く

iPhone では エクスポート → 自動化 を、iPad ではサイドバーの 自動化 を開きます。新規自動化 を選ぶか、既存の自動化を開いて編集します。

名前、状態、通知

この自動化を識別する名前を入力します。有効 は自動実行を許可します。準備ができるまではオフのままにします。

必要な実行通知を選びます:

  • キャッシュ更新時に通知 はエクスポートデータの準備完了を報告します。
  • 実行時に通知 はエンドポイントへのアップロード成功を報告します。

求められたら通知を許可します。これらの通知はアクティビティを報告するだけで、実行をスケジュールしません。

エンドポイントのセットアップ

  1. 自動化の種類 として REST API を選びます。
  2. iPhone または iPad から到達可能な URL を入力します(例: https://api.example.com/health-data)。
  3. HTTP ヘッダー の下に必要な認証を追加します。たとえば、キーに Authorization、値に Bearer YOUR_TOKEN を使います。
  4. エンドポイントに適した リクエストタイムアウト を選びます。

各ヘッダーにはキーと値の両方が必要です。別デバイス上のサーバーには、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 リクエスト識別子

履歴または漏れたデータをエクスポートする

自動化の初回設定時に履歴データをエクスポートする、またはあとから自動同期で漏れた日付を補うために 手動アップロード を使います。設定確認にも使えます。

  1. 自動化を開き、既存データをエクスポート の下で 手動アップロード を選びます。
  2. 開始 と 終了 の日付を設定し、エクスポートを開始 を選びます。
  3. エンドポイントが受信したリクエスト、ヘッダー、本文を確認します。

トラブルシューティング

  • リクエストが届かない: URL、ネットワーク到達性、サーバーログを確認します。
  • 認証エラー: ヘッダーキー、トークン、エンドポイントの権限を確認します。
  • ペイロード拒否またはタイムアウト: サーバーのサイズ制限を確認し、JSON でバッチを使うか、エクスポートサイズを減らします。

自動化を開き アクティビティログを表示 で実行を確認します。警告 はデータ取得の遅延などの潜在的な問題を示し、エラー は失敗したステップを示します。問題の報告方法は ヘルプを得る を参照してください。