REST API・Webhook・CSVの違い｜環境モニタリングデータの連携方法

温度、湿度、CO₂などの環境データを、クラウド画面で確認するだけでなく、社内の設備管理システム、BIツール、品質管理データベースへ連携したいケースが増えています。代表的な方法が、REST API、Webhook、CSVです。

三つは同じデータを扱える場合がありますが、取得のタイミングと運用方法が異なります。

• REST API：必要なときにシステム側からデータを取得する
• Webhook：イベント発生時にサービス側からデータを送信する
• CSV：一定期間のデータをファイルとして受け渡す

本記事では、それぞれの特徴と使い分け、導入時の注意点、UbiBotの環境モニタリングデータを外部システムへ連携する方法を解説します。

1．REST API・Webhook・CSVの基本的な違い

デジタル庁のAPIテクニカルガイドブックでは、Web APIをRESTに基づいて設計することが推奨され、CSVは表計算ソフトで利用しやすい形式として整理されています。

2．REST APIとは

REST APIは、HTTPを利用してデータや機能へアクセスする仕組みです。

環境モニタリングでは、外部システムがクラウドへリクエストを送り、指定した期間や機器の測定データを取得します。

例えば、次のような処理に利用できます。

• 全拠点の最新温度を30分ごとに取得する
• 指定した冷凍庫の過去24時間の履歴を取得する
• 温湿度データを社内BIツールへ取り込む
• 設備IDとセンサーチャネルを関連付ける
• 日次レポートを自動作成する

REST APIのメリット

• 必要な機器・期間・測定項目を指定しやすい
• 社内システムから取得タイミングを管理できる
• 過去データの再取得に対応しやすい
• JSONなど、プログラムで処理しやすい形式を利用できる

REST APIの注意点

• APIキーなどの認証情報を安全に管理する必要がある
• 呼び出し回数やデータ量に制限がある場合がある
• 同じ期間を繰り返し取得すると重複登録が発生する
• タイムアウトや一時的なエラーへの再試行が必要
• タイムゾーンと測定時刻の扱いを統一する必要がある

環境データを定期取得する場合は、「最後に正常保存した測定時刻」を記録し、次回はその続きから取得する設計が有効です。

3．Webhookとは

Webhookは、指定したイベントが発生したときに、サービス側から外部システムのURLへデータを送る連携方式の一般的な呼び方です。

利用側が定期的に状態を確認するのではなく、データ提供側からHTTP POSTなどで通知します。

Webhookが適する用途

• 温度が上限値を超えた
• CO₂濃度が管理値を超えた
• 漏水を検知した
• センサーがオフラインになった
• 新しい測定データがクラウドへ到着した

Webhook型の連携では、受信後すぐに次の処理へつなげられます。

• チャットや業務アプリへ通知する
• 保守管理システムにチケットを登録する
• データベースへ測定値を保存する
• 異常対応ワークフローを開始する

Webhookの注意点

Webhookは「送信した」ことと「業務システムへ正常に保存された」ことが必ずしも同じではありません。

次の仕組みを設計します。

• HTTPSによる暗号化
• 送信元を確認する認証
• 受信データの形式・値・文字数の検証
• HTTPステータスコードによる成否判定
• タイムアウト時の再送
• 同じデータが再送された場合の重複排除
• 受信できなかったデータを後から補完する方法
• エラーログと監視通知

Webhookだけに依存すると、受信サーバー停止中のデータを見落とす可能性があります。REST APIによる定期的な差分確認と組み合わせると、欠損を検出しやすくなります。

4．CSVとは

CSVは、表形式のデータを文字列として保存するファイル形式です。

プログラム開発を行わなくても、Excelなどの表計算ソフトで開けるため、環境モニタリングデータの確認、分析、報告に広く利用できます。

CSVが適する用途

• 月次の温湿度報告書を作成する
• 複数センサーの履歴を比較する
• 品質管理部門へ測定記録を提出する
• 統計ソフトで研究データを解析する
• システム移行時にデータを受け渡す
• 長期記録を社内ストレージへ保存する

CSVの注意点

• 手動作業ではダウンロード忘れが起こり得る
• リアルタイム通知には向かない
• ファイル名や保存場所が統一されていないと履歴を追いにくい
• 表計算ソフトで開く際に日時や数値形式が変換される場合がある
• センサーID、単位、タイムゾーンが欠けるとデータの意味が不明確になる
• 編集可能なため、原本と加工後ファイルを分けて管理する必要がある

品質管理や研究で利用する場合は、少なくとも次の情報を残します。

• 機器・チャンネルID
• 測定項目と単位
• 測定時刻とタイムゾーン
• 測定値
• データ出力日時
• 出力した期間
• ファイル作成者または処理システム
• 加工前の原本

5．三つの方法はどう使い分けるか

実務では、Webhookで異常を素早く通知し、REST APIで履歴を定期同期し、CSVで報告書用データを保存する構成が考えられます。

6．公開研究に見るCSVによる環境データ連携

ケンブリッジ大学とFetch.aiの研究チームは、生鮮食品を想定した自律型サプライチェーンのプロトタイプを構築しました。

研究では、UbiBot WS1とスマートフォンのGPSアプリを自転車へ搭載し、英国ケンブリッジ市内で次のデータを収集しています。

• 温度
• 相対湿度
• 照度
• 経度・緯度
• 標高

取得した環境・位置データは校正後にCSVへ保存され、サプライチェーンのプロトタイプ上で、配送中に到着するデータのように時系列で再生されました。

この事例は、CSVが単なる報告書用ファイルではなく、次の用途にも利用できることを示しています。

1. 異なる機器から取得したデータを統合する
2. 実測データを研究システムへ取り込む
3. 同じデータで処理を繰り返し検証する
4. 通信状態に左右されず再現試験を行う

ただし、この研究では走行中のデータをUbiBotのWebhookやREST APIでリアルタイム送信したわけではありません。実測値をCSVへ保存し、後からプロトタイプ内で再生した研究です。

参考：Xu et al., “On implementing autonomous supply chains: A multi-agent system approach,” Computers in Industry, 2024

7．UbiBotで利用できるデータ連携方法

RESTful API

UbiBot IoTプラットフォームでは、収集・保存されたセンサーデータや機器情報をHTTP上のRESTful APIから取得できます。

日本公式API資料では、次の認証情報が案内されています。

• アカウント単位で使用するaccount_key
• チャンネル単位で使用するapi_key
• 読み取り専用キー
• 読み書き可能なキー

APIには呼び出し回数、ファイルサイズなどの制限が設定されているため、大量データを取得する場合は、期間の分割、差分取得、再試行を含めて設計する必要があります。

HTTP POSTによるデータ転送

UbiBotでは「Channel Feeds Data Forwarding」と呼ばれる機能が提供されています。

これは、UbiBotデバイスからプラットフォームへ届いた元のフィードデータのコピーを、指定したURLへJSON形式のHTTP POSTで転送する機能です。一般的にはWebhookに近いPush型の連携として利用できます。

利用には、UbiBotプラットフォーム側での機能有効化と、JSONデータを受信・処理するエンドポイントの開発が必要です。

「Webhook」という名称の一般機能と、UbiBotのデータ転送サービスの仕様が完全に同じとは限りません。再送条件、応答形式、利用料金、対象データなどは最新ドキュメントで確認してください。

CSV／PDFエクスポート

UbiBot管理コンソールでは、期間を指定したデータをCSVまたはPDF形式で出力できます。

CSVは編集・分析可能な生データ、PDFはグラフやレポートを確認したい場合に利用しやすい形式です。出力件数、完全データのエクスポート回数、利用可能期間は契約プランによって異なる場合があります。

UbiBot APIには、CSVファイルからフィードデータをチャンネルへインポートする機能もあります。ただし「CSVエクスポート」と「CSVインポート」は用途が異なるため、混同しないようにしてください。

8．REST APIとWebhookを安全に運用する

APIやデータ転送を利用する場合は、接続できることだけでなく、次の項目を確認します。

認証情報の管理

• APIキーをソースコードへ直接記載しない
• 公開リポジトリや共有資料へ掲載しない
• 読み取りだけなら読み取り専用キーを使用する
• 不要になったキーを失効させる
• 用途や接続先ごとにキーを分ける

通信とアクセス制御

• HTTPSを使用する
• 接続元や署名を確認できる場合は検証する
• 必要なURLだけを外部公開する
• データベースや管理画面を直接公開しない
• 受信データを信用せず、形式と値を検証する

障害と再処理

• API取得に失敗した期間を記録する
• 指数バックオフなどで再試行する
• Webhook型転送の重複を許容できる設計にする
• 測定時刻と受信時刻を分けて保存する
• REST APIで履歴と照合する
• 件数や連番により欠測を検出する

IPAのAPI標準設計ガイドでは、API仕様、認証、エラー、利用制限、データ保護、利用規約などを設計段階で明確にする重要性が示されています。

9．導入前チェックリスト

• リアルタイム通知と履歴取得のどちらが必要か整理した
• データ連携先と更新頻度を決めた
• 機器ID、測定項目、単位を統一した
• タイムゾーンと時刻形式を決めた
• APIの呼び出し制限を確認した
• 読み取り専用キーを選べるか確認した
• Webhook型転送の再送・重複処理を設計した
• 受信停止を検知できるようにした
• 欠測期間をAPIまたはCSVで補完できる
• CSV原本と加工後ファイルを分けて保存する
• クラウドプランとエクスポート条件を確認した
• 契約終了時のデータ取得方法を確認した

よくある質問

REST APIとWebhookはどちらがリアルタイムですか

一般的には、イベント発生時に送信するWebhook型連携の方が、短い間隔でAPIを繰り返し呼び出さなくても迅速に処理できます。ただし、送信・受信サーバーの状態や再送仕様によって遅延する場合があります。

WebhookがあればREST APIは不要ですか

必ずしも不要ではありません。Webhookの受信に失敗した場合や、一定期間の履歴を再取得したい場合にはREST APIが役立ちます。

CSVだけで環境モニタリングを運用できますか

定期的な報告や少数機器の分析であれば可能です。一方、即時アラート、自動同期、多拠点監視にはAPIやWebhook型転送の方が適する場合があります。

REST APIとCSVではデータの内容は同じですか

同じ測定値を扱う場合でも、列名、時刻形式、集計方法、出力対象が異なる可能性があります。API仕様書とCSVの出力項目を確認してください。

UbiBotのデータ転送はWebhookですか

指定URLへJSON形式でHTTP POSTするため、一般的にはWebhookに近いPush型連携として利用できます。ただし、正式名称はChannel Feeds Data Forwardingであり、一般的なWebhook製品と同じ仕様とは限りません。

プログラム開発なしでデータを利用できますか

管理コンソールからCSVやPDFを出力すれば、プログラムを開発せずに確認・集計できます。自動取得や外部システムへの即時連携には、APIまたはデータ転送を受けるシステムの開発が必要です。

まとめ

REST API、Webhook、CSVは、環境モニタリングデータを外部で利用するための異なる手段です。

REST APIは、必要な機器や期間のデータを外部システムから取得する用途に適しています。Webhook型の転送は、異常や新しいデータを迅速に別システムへ伝える用途に向いています。CSVは、分析、報告、長期保管、研究データの受け渡しに利用しやすい方法です。

UbiBotでは、RESTful API、指定URLへのフィードデータ転送、CSV／PDFエクスポートを用途に応じて選択できます。

まずはCSVでデータ項目と運用方法を確認し、自動化が必要になった段階でREST APIやデータ転送を追加する方法も有効です。導入前には、API制限、料金プラン、認証情報、再送、重複、欠測補完まで含めて設計してください。

参考資料

1. UbiBot日本公式「クイックスタートと制限」
2. UbiBot Help Center「チャンネル・フィード データ転送」
3. UbiBot日本公式「チャンネルフィード概要取得」
4. UbiBot日本公式「CSVからのフィードインポート」
5. UbiBot日本公式「データのインポート／エクスポート方法」
6. IPA「API標準設計ガイド・基礎編」
7. デジタル庁「APIテクニカルガイドブック」
8. Xu et al., “On implementing autonomous supply chains: A multi-agent system approach,” Computers in Industry, 2024

※API、データ転送、CSV／PDF出力の仕様、利用上限、料金、保存期間は変更される場合があります。公開またはシステム開発前に、UbiBot日本公式サイトと最新APIドキュメントをご確認ください。