APIサービス
FlightHub Sync APIは、FlightHubとサードパーティー製クラウドプラットフォーム間の連携用APIを管理します。
注記:FlightHub Sync APIは、段階的にFlightHub Sync OpenAPIへ移行されます。新規ユーザーは、FlightHub SyncおよびEventAPIを直接使用してください。
FlightHub Sync APIを使用する際は、次の点に注意してください。
- ユーザーは、リクエストにX-Organization-Keyヘッダーを含める必要があります。このキーは組織の認証情報として機能します。
- ユーザーは
Get the List of Projects Under the Organization、Get the List of Devices for a Specific Project、Get Task DetailsAPIを呼び出して、タスクや機器に関する関連情報を取得できます。 - ユーザーがFlightHub 2のプロジェクト一覧ページにアクセスした際のURLから、組織IDを取得できます。
FlightHub Sync Webhook
ファイルが生成されると、FlightHub 2は設定されたWebhook URLを介してサードパーティのクラウドプラットフォームに通知を送信します。
注記:FlightHub Syncでは、新しいEventAPIサービスを導入しており、より幅広いイベントタイプに対応し、より柔軟なルール設定が可能となりました。詳細については、EventAPIを参照してください。
New File Generated Notification API:
{
"notify_type": "file_uploaded",
"notify_time": "2023-11-07T12:00:00.582627+00:00",
"data": {
"organization_id": "Organization ID",
"workspace_id": "Project ID",
"file": {
"id": "File ID",
"name": "File Name",
"object_key": "Object Storage Key",
"type": 5 // 5-飛行ルートファイル,7-3Dマッピングファイル
}
}
}
FlightHub Sync API
次のAPIは、段階的にFlightHub Sync OpenAPIへ移行されます。
| インターフェースピン | 移行ステータス |
|---|---|
| AI警告リストとスナップショットを取得 | EventAPIへ移行済み |
| 組織下のプロジェクト一覧を取得 | 移行中 |
| 特定プロジェクトの機器一覧を取得 | 移行中 |
| 通知を公開し、マップ要素を作成 | 移行中 |
| プロジェクトの一時アップロード認証情報を取得 | 移行中 |
| 飛行ルートアップロード通知 | 移行中 |
| 生成ファイル情報とダウンロードURLを取得 | 移行中 |
| 迂回ストリーミングAPI | 移行中 |
| タスク割り当てAPI | 移行中 |
他のリクエストの詳細については、FlightHub Sync API概要を参照してください。
注記:FlightHub Syncはパブリックベータテストを完了し、FlightHub Syncへとアップグレードされました。ストリーム転送機能は、現在の組織のライブ配信時間数(分)を消費します。トランスコーダーが作成(ストリーム転送が開始)されると、消費が開始します。各トランスコーダーは個別にカウントされます。トランスコーダーを削除(ストリーム転送を停止)すると、消費が終了します。