APIリソース
次の API エンドポイントとリソースは、適切な承認によってアクセスできるように公開されます。
1. GetRolePermission
リソース権限コレクションを取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| 名前 | 弦 | 真実 | 役割名 |
応答
戻り値の種類: コレクション(リソース)
例:
http://botcenter.akabot.io/api/roles/{name} URL に GET リクエストを送信します。
ヘッダー:
応答:
image-20230307144502-3.png2。ユーザーの取得
ユーザーコレクションを取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| 組織単位ID | 整数 | 間違い | |
| 検索ユーザー | 弦 | 間違い | ログイン(ユーザー名) |
| ページ | 整数 | 間違い | 要求されたページのページ番号 |
| サイズ | 整数 | 間違い | ページのサイズ(上部) |
| 選別 | 弦 | 間違い | 形式の並べ替え基準: property(,asc |
応答
戻り値の種類: コレクション(ユーザー)
例:
http://botcenter.akabot.io/api/users URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:

3.ユーザーの作成
新しいユーザーを追加します。 HTTPメソッド:ポスト
パラメータ
| 名前 | タイプ | 説明 |
| ユーザーDTO | ユーザー |
応答
戻り値の種類: ユーザー
例:
http://botcenter.akabot.io/api/users URL に POST リクエストを送信します。
ヘッダー:
リクエスト:

応答:

4.役割の追加
ユーザーの役割を追加します。 HTTPメソッド:Put
パラメータ
| 名前 | タイプ | 説明 |
| ユーザーロールDTO | ユーザーロール |
応答
戻り値の種類: ステータスコード
例:
http://botcenter.akabot.io/api/user-add-role URL に PUT リクエストを送信します。
ヘッダー:
リクエスト:
応答:
レスポンスコード: 200
5.役割の削除
ユーザーから役割を削除します。 HTTPメソッド:Put
パラメータ
| 名前 | タイプ | 説明 |
| ユーザーロールDTO | ユーザーロール |
応答
戻り値の種類: ステータスコード
例:
http://botcenter.akabot.io/api/user-remove-role URL に PUT リクエストを送信します。
ヘッダー:
リクエスト:
応答:
レスポンスコード: 200
6.組織単位の追加
ユーザーの組織単位を追加します。 HTTPメソッド:Put
パラメータ
| 名前 | タイプ | 説明 |
| ユーザー組織単位DTO | ユーザーロール |
応答
戻り値の種類: ステータスコード
例:
http://botcenter.akabot.io/api/user-add-organizationUnit URL に PUT リクエストを送信します。
ヘッダー:
リクエスト:
応答:
レスポンスコード: 200
7.組織単位の削除
ユーザーから組織単位を削除します。 HTTPメソッド:Put
パラメータ
| 名前 | タイプ | 説明 |
| ユーザー組織単位DTO | ユーザーロール |
応答
戻り値の種類: ステータスコード
例:
http://botcenter.akabot.io/api/user-remove-organizationUnit URL に PUT リクエストを送信します。
ヘッダー:
リクエスト:
応答:
レスポンスコード: 200
8.ユーザーの更新
ユーザー情報を更新します。 HTTPメソッド:Put
パラメータ
| 名前 | タイプ | 説明 |
| ユーザーDTO | ユーザー |
応答
戻り値の種類: ユーザー
例:
http://botcenter.akabot.io/api/users URL に PUT リクエストを送信します。
リクエスト:

応答:

9.アクティブ化されたユーザー
ユーザーをアクティブ化または非アクティブ化します。 HTTPメソッド:Put
パラメータ
| 名前 | タイプ | 説明 |
| DTOをアクティブにする | 活性化 |
応答
戻り値の種類: ステータスコード
例:
http://botcenter.akabot.io/api/user-activated URL に PUT リクエストを送信します。
ヘッダー:
リクエスト:
応答:
レスポンスコード: 200
10.関連プロセスの取得
エージェントの使用可能なすべての関連プロセスのコレクションを返します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 説明 |
| ロボットキー | 弦 |
応答
戻り値の種類: コレクション(ワークフロー)
例:
http://botcenter.akabot.io/api/robotsservice/GetAssociatedProcesses URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:

11.ワークフロー
WorkFlow コレクションを取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| 組織単位ID | 整数 | 間違い | |
| 環境ID | 整数 | 間違い | エージェントグループID |
| 環境名 | 弦 | 間違い | エージェントグループ名 |
| ワークフローID | 整数 | 間違い | |
| ワークフロー名 | 弦 | 間違い | |
| ページ | 整数 | 間違い | 要求されたページのページ番号 |
| サイズ | 整数 | 間違い | ページのサイズ(上部) |
| 選別 | 弦 | 間違い | 形式の並べ替え基準: property(,asc |
応答
戻り値の種類: コレクション(ワークフロー)
例:
http://botcenter.akabot.io/api/work-flows URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:

12.ワークフローバージョン
Get WorkFlow version.サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| ワークフローID | 長さ | 真実 |
応答
戻り値の種類: 文字列
例:
http://botcenter.akabot.io/api/workflowversion URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:
1.0.12380.19828
13.ワークフローバージョンの更新
ワークフローのバージョンを更新します。サポートされているメソッド: Put
パラメータ
| 名前 | タイプ | 説明 |
| ID | 整数 | ワークフローID |
| バージョン | 弦 |
応答
戻り値の種類: ワークフロー
例:
http://botcenter.akabot.io/api/work-flows/{id}/version URL に PUT リクエストを送信します。
ヘッダー:
応答

14.パッケージのアップロード
パッケージをパッケージ リポジトリにアップロードします。サポートされているメソッド: 投稿
パラメータ
| 名前 | パラメータの種類 | タイプ | コンテンツタイプ |
| パッケージ | フォームデータ | ファイル | マルチパート/フォームデータ |
| 環境ID | フォームデータ | 配列[長い] | アプリケーション/json |
応答
戻り値の種類: パッケージ
例:
http://botcenter.akabot.io/api/packageupload URL に POST リクエストを送信します。
パラメータ:

ヘッダー:
応答
image-20230307144502-60.png15。環境
エージェントグループを取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| 組織単位ID | 整数 | 間違い | |
| 環境名 | 弦 | 間違い | エージェントグループ名 |
| ページ | 整数 | 間違い | 要求されたページのページ番号 |
| サイズ | 整数 | 間違い | ページのサイズ(上部) |
| 選別 | 弦 | 間違い | 形式の並べ替え基準: property(,asc |
応答
戻り値の種類: コレクション(環境)
例:
http://botcenter.akabot.io/api/environments URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:

16.ジョブの開始
新しいジョブを追加し、入力パラメータに基づいて各エージェントのジョブを保留状態に設定し、保留中のジョブについて各エージェントに通知します。 HTTPメソッド:ポスト
パラメータ
| 名前 | タイプ | 説明 |
| 仕事DTO | 仕事 |
応答
戻り値の種類: ジョブ
例:
http://botcenter.akabot.io/api/jobs-processing URL に POST リクエストを送信します。
ヘッダー:
リクエスト:
応答:
StopJob
指定したジョブをキャンセルまたは終了します。サポートされているメソッド: Put
パラメータ
| 名前 | タイプ | 説明 |
| ID | 整数 | ジョブID |
| 価値 | 文字列(STOP、KILL) |
応答
戻り値の種類: ジョブ
例:
http://botcenter.akabot.io/api/jobs-processing/{id}/{value} URL に PUT リクエストを送信します。
ヘッダー:
応答

17.ジョブを取得
求人情報を取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 説明 |
| ID | 整数 | ジョブID |
応答
戻り値の種類: ジョブ
例:
http://botcenter.akabot.io/api/jobs/{id} URL に GET リクエストを送信します。
ヘッダー:
応答

18.ジョブを取得
ジョブ コレクションを取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| 組織単位ID | 整数 | 間違い | |
| 環境ID | 整数 | 間違い | エージェントグループID |
| ロボットID | 整数 | 間違い | |
| スケジュールID | 整数 | 間違い | |
| 州 | 弦 | 間違い | (保留中、実行中、停止、失敗、成功)。 複数の状態をカンマで区切ってサポート |
| ページ | 整数 | 間違い | 要求されたページのページ番号 |
| サイズ | 整数 | 間違い | ページのサイズ(上部) |
| 選別 | 弦 | 間違い | 形式の並べ替え基準: property(,asc |
応答
戻り値の種類: コレクション(ジョブ)
例:
http://botcenter.akabot.io/api/jobs URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:

19. GetRobotMapping
ロボットのマッピング情報を取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 説明 |
| ライセンスキー | 弦 | エージェントキー |
| マシン名 | 弦 |
応答
戻り値の種類: RobotMappingVM
例:
http://botcenter.akabot.io/api/robotsservice/GetRobotMappings URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:
20.ロボットを入手
ロボットのコレクションを入手します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| 組織単位ID | 整数 | 間違い | |
| 環境ID | 整数 | 間違い | エージェントグループID |
| ロボットID | 整数 | 間違い | |
| ロボット_タイプ | 整数 | 間違い | 開発(0)、アシスタント(1)、ステージング(2)、プロダクション(3) |
| ロボット_ステータス | 整数 | 間違い | 利用可能(0)、ビジー(1)、切断(2)、応答なし(3) |
| 検索 | 弦 | 間違い | エージェント名(ロボット名) |
| ページ | 整数 | 間違い | 要求されたページのページ番号 |
| サイズ | 整数 | 間違い | ページのサイズ(上部) |
| 選別 | 弦 | 間違い | 形式の並べ替え基準: property(,asc |
応答
戻り値の種類: コレクション(ロボット)
例:
http://botcenter.akabot.io/api/robots URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:

21.送信ハートビート
エージェントのステータスを送信し、タスクのリストを取得するコマンド。サポートされているメソッド: 投稿
パラメータ
| 名前 | タイプ | 説明 |
| 心拍DTO | ハートビートDTO |
応答
戻り値の種類: ハートビートデータ
例:
http://botcenter.akabot.io/api/robotsservice/SubmitHeartbeat URL に POST リクエストを送信します。
リクエスト:
ヘッダー:
応答:

22.ジョブ状態の送信
エージェントからタスクのステータスを送信します。サポートされているメソッド: 投稿
パラメータ
| 名前 | タイプ | 説明 |
| 心拍DTO | ハートビートDTO |
応答
例:
http://botcenter.akabot.io/api/robotsservice/SubmitJobState URL に POST リクエストを送信します。
リクエスト:

ヘッダー:
応答:
23.プッシュログ
ログを中央にプッシュします。サポートされているメソッド: 投稿
パラメータ
| 名前 | タイプ | 説明 |
| ロボット名 | 弦 | |
| メッセージ | 配列(文字列) |
応答
戻り値の型: ブール値
例:
http://botcenter.akabot.io/api/logs/v1 URL に POST リクエストを送信します。
リクエスト:

ヘッダー:
応答:
真実
24.ログの取得
ログコレクションを取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| ロボット名 | 弦 | 間違い | |
| ワークフローID | 整数 | 間違い | |
| レベル | 整数 | 間違い | オフ(0)、致命的(1)、エラー(2)、警告(3)、情報(4)、デバッグ(5)、詳細(6) |
| ジョブID | 弦 | 間違い | |
| クエリ文字列 | 弦 | 間違い | ログメッセージからクエリするキーワード |
| ページ | 整数 | 間違い | 要求されたページのページ番号 |
| サイズ | 整数 | 間違い | ページのサイズ(上部) |
| 選別 | 弦 | 間違い | 形式の並べ替え基準: property(,asc |
応答
戻り値の種類: コレクション(ジョブ)
例:
http://botcenter.akabot.io/api/logs URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:

25.アセットの取得
資産情報を取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 説明 |
| 資産名 | 弦 | |
| ロボットキー | 弦 |
応答
戻り値の種類: AssetVM
例:
http://botcenter.akabot.io/api/studioservice/GetAsset URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:
26.資産を設定
資産の価値を更新します。サポートされているメソッド: 投稿
パラメータ
| 名前 | タイプ | 説明 |
| アセットVM | アセットVM |
応答
戻り値の型: ブール値
例:
http://botcenter.akabot.io/api/studioservice/SetAssetURL に POST リクエストを送信します。
リクエスト:
ヘッダー:
応答:
真実
27. GetQueue
キューのコレクションを取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| 名前 | 長さ | 間違い | キューID |
| キュー名 | 弦 | 間違い | キュー名 |
| ページ | 整数 | 間違い | 要求されたページのページ番号 |
| サイズ | 整数 | 間違い | ページのサイズ(上部) |
| 選別 | 弦 | 間違い | 形式の並べ替え基準: property(,asc |
応答
戻り値の種類: コレクション(キュー)
例:
http://botcenter.akabot.io/api/queue URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:
画像-20230307144502-117.png28。 GetQueuItems
QueueItem コレクションを取得します。サポートされているメソッド: 投稿
パラメータ
| 名前 | タイプ | 説明 |
| キュー名 | 弦 | |
| 参照 | 弦 | |
| フィルター戦略 | 文字列 (STARTSWITH、EQUALS) | 参考までに |
| 状態 | 文字列(新規、進行中、失敗、成功、放棄、再試行、削除、期限切れ) | キュー項目のステータス、フィルターの複数値のサポート |
| から | 日時 | 日付の作成 |
| に | 日時 | 日付の作成 |
| トップ | 内部 | アイテムの返品を制限する |
| スキップ | 内部 | オフセット |
応答
戻り値の種類: コレクション(QueueItem)
例:
http://botcenter.akabot.io/api/queue/getQueueItems URL に POST リクエストを送信します。
リクエスト:
ヘッダー:
応答:

29. GetQueueDetails
QueueItem コレクションを取得します。サポートされているメソッド: Get
パラメータ
| 名前 | タイプ | 必須 | 説明 |
| ID | 長さ | 真実 | キューID |
| 参照 | 弦 | 間違い | |
| 例外 | 整数 | 間違い | アプリケーション(0)、ビジネス(1) |
| 優先度 | 整数 | 間違い | 高(3)、標準(2)、低(1) |
| 状態 | 整数 | 間違い | 新規(0)、進行中(1)、失敗(2)、成功(3)、放棄(4)、再試行(5)、削除(6)、期限切れ(7) |
| 特定のデータ | 弦 | 間違い | 特定のデータからクエリするキーワード |
| 開始から | 日時 | 間違い | 開始時刻からのクエリ |
| 開始まで | 日時 | 間違い | 開始時刻からのクエリ |
| ページ | 整数 | 間違い | 要求されたページのページ番号 |
| サイズ | 整数 | 間違い | ページのサイズ(上部) |
| 選別 | 弦 | 間違い | 形式の並べ替え基準: property(,asc |
応答
戻り値の種類: コレクション(QueueItems)
例:
http://botcenter.akabot.io/api/queue/{id}/detail URL に GET リクエストを送信します。
パラメータ:
ヘッダー:
応答:

30.キューアイテムの追加
キューアイテムを追加します。 HTTPメソッド:ポスト
パラメータ
| 名前 | タイプ | 説明 |
| キュー名 | 弦 | |
| 優先度 | 文字列(高、標準、低) | |
| 参照 | 弦 | |
| ロボット名 | 弦 | |
| 特定のデータ | 弦 | |
| 締め切り | データ時間 | |
| 延期 | 日時 |
応答
戻り値の種類: HttpStatus
例:
http://botcenter.akabot.io/api/queue/addQueueItem URL に POST リクエストを送信します。
ヘッダー:
リクエスト: