- 基本情報
- OData と参照について
- 列挙型
- 認証
- エンドポイントごとの権限
- API リクエストを構築する
- 応答コード
- 健全性チェックのエンドポイント
- 認証
- Swagger の定義
- Orchestrator API
- プラットフォーム管理 API
OData と参照について
Orchestrator API の実装は、OData プロトコルに基づいています。OData (Open Data Protocol) は、ISO/IEC 認定を受けた OASIS 標準です。RESTful API の構築と利用に関するさまざまなベスト プラクティスを定義しています。
Open Data Protocol (OData) では、REST ベースのデータ サービスを作成できます。これらのサービスでは、URL で特定され、データ モデルで定義されたリソースを Web クライアントがシンプルな HTTP メッセージを使用してパブリッシュしたり、編集したりすることができます。この仕様は、プロトコルのコア セマンティックと動作に関する部分を定義するものです。
https://{yourDomain}/odata
です。既定の形式を XML に変更するには、この URL に /?$format=xml
を追加します。
The Orchestrator API provides custom methods for querying stats about various entities registered in Orchestrator. Each logical resource is an OData entity. All entities (such as Robot, Process, Queue) have properties, relationships, and operations.
この種類の操作は、ほとんどの論理リソースで使用可能です。CRUD 操作には、GET、POST、PUT、DELETE のリクエストがあります。ただし、技術的および業務上の理由により、全論理リソースでこれらすべての動詞が使用されるわけではありません。
GET 操作と組み合わせて OData 固有のパラメーターを使用することで、特定の情報を特定のリソースに要求できます。
情報のクエリ、フィルター処理、並べ替え、選択、展開が可能です。詳細については、OData の公式ドキュメントをご覧ください。
The following custom actions and actions which are not tied to a logical resource are available in the Orchestrator API:
- Stats メソッドは、さまざまなエンティティに関する集計情報を提供します。
- Account メソッドは、Orchestrator に認証方法を提供します。
- Queues メソッドは、ロボットがキューにアクセスするために使用しますが、外部システムでは代わりに
QueueDefinitions
エンドポイントを API 経由で使用する必要があります。 - QueueProcessingRecords メソッドは、キューに関する統計情報と集計情報を提供します。
- RobotsService リソースは、Orchestrator がロボットと通信するために使用できます。