ThingsConnect REST API

既存の業務システム・自動化ツール（n8n、Power Automate など）・スクリプトから、エッジPC・デバイスの状態、センサの計測値、AI アプリのイベント、保存したクエリの結果を読み出し、カメラの配信や首振りを操作するための REST API です。AI エージェントからは MCP で接続してください。

ベース URL

https://api.thingsconnect.app/api/v1

MCP と同じホストで、管理ダッシュボード（dashboard.thingsconnect.app）とは別です。

認証

組織設定の「API・MCP」タブで発行した API トークンを Authorization ヘッダに付けます。トークンを発行できるのはオーナーと管理者です。

Authorization: Bearer tcn_xxxxxxxx

呼べる範囲はトークンのスコープで決まります。足りないときは 403 を返します。

ダッシュボードにログインしたときのセッションでは呼べません。

呼び出してみる

「データ参照」のトークンで、エッジPC の一覧を取得します。

curl -H "Authorization: Bearer $THINGSCONNECT_API_TOKEN" https://api.thingsconnect.app/api/v1/edge-pcs

返ってきた id を使ってデバイスを絞り込み（/devices?edgePcId=...）、センサのデバイスなら計測値の履歴（/devices/{id}/metrics）を取得できます。カメラに追加した AI アプリの結果は、デバイスではなく AI アプリのインスタンス（/ai-app-instances）から取得します。

エラー

エラーは常に次の形で返ります。

{ "error": "Device not found" }

互換性

/api/v1 の中では、既存のフィールドを消したり意味を変えたりしません。フィールドを足すことはあるので、知らないフィールドは無視してください。

制限

主な上限値は制限値と既定値にまとめています。

エッジPC

組織のエッジPC と接続状態。

• GET
  エッジPC の一覧を取得する/edge-pcs

デバイス

カメラ・センサと、その操作。

• GET
  デバイスの一覧を取得する/devices
• GET
  デバイスの詳細を取得する/devices/{id}
• PATCH
  デバイスの名前・メモ・機器情報を変更する/devices/{id}
• GET
  計測値の履歴を取得する/devices/{id}/metrics
• POST
  RTMP 配信を始める/devices/{id}/streaming
• DELETE
  RTMP 配信を止める/devices/{id}/streaming
• POST
  カメラの向きを変える（PTZ）/devices/{id}/ptz

AI アプリ

カメラに追加した AI アプリ（インスタンス）の結果とイベント。

• GET
  AI アプリのインスタンスの一覧を取得する/ai-app-instances
• GET
  AI アプリのインスタンスの最新の結果を取得する/ai-app-instances/{id}
• GET
  AI アプリの結果の履歴を取得する/ai-app-instances/{id}/metrics
• GET
  AI アプリのイベントを取得する/events

データ

保存したクエリ。

• GET
  保存したクエリの一覧を取得する/queries
• POST
  保存したクエリを実行する/queries/{id}/run

撮影

撮影ジョブの実行と結果。

• GET
  撮影ジョブの一覧を取得する/capture/jobs
• POST
  撮影ジョブを実行する/capture/jobs/{id}/run
• GET
  撮影ジョブの実行結果を取得する/capture/runs/{id}
• GET
  撮影ログを取得する/capture/deliveries