[4] APIレソース

adminが2023/10/11 17:18に最終更新

以下のAPIエンドポイントとリソースは、適切な承認によってアクセスできます。

1.GetRolePermisson

リソース権限コレクションを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
name文字列trueロール名

レスポンス

ReturnType:Collection(Resource)

例)

http://botcenter.akabot.io/api/roles/{name}のURLにGETリクエストを送信します。

image-20230307144502-1.png

ヘッダー:

image-20230307144502-2.png

レスポンス:

image-20230307144502-3.png 2.GetUsers

ユーザーコレクションを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
organizationUnitId整数False 
searchuser文字列Falseログイン(ユーザ名)
page整数Falseリクエストされたページのページ番号
size整数Falseページのサイズ(上部)
sort文字列False

プロパティ(,asc|desc)形式でのソート基準

例:login,asc

レスポンス

ReturnType:Collection(User)

例)

http://botcenter.akabot.io/api/usersのURLにGETリクエストを送信します。

image-20230307144502-4.png

パラメーター

image-20230307144502-5.png

ヘッダー:

image-20230307144502-6.png

レスポンス:

image-20230307144502-7.png

3.CreateUser

新しいユーザを作成します。HTTPメソッド:Post

パラメータ

名称形式説明
userDTOユーザ 

レスポンス

ReturnType:User

例)

http://botcenter.akabot.io/api/usersのURLにPOSTリクエストを送信します。

image-20230307144502-8.png

ヘッダー:

image-20230307144502-9.png

リクエスト:

image-20230307144502-10.png

image-20230307144502-11.png

レスポンス:

image-20230307144502-12.png

image-20230307144502-13.png

  1.  
    1.  

4.AddRole

ユーザーのロールを追加します。HTTPメソッド:Put

パラメータ

名称形式説明
userRoleDTOUserRole 

レスポンス

ReturnType:StatusCode

例)

http://botcenter.akabot.io/api/user-add-roleのURLにPUTリクエストを送信します。

image-20230307144502-14.png

ヘッダー:

image-20230307144502-15.png

リクエスト:

image-20230307144502-16.png

image-20230307144502-17.png

レスポンス:

image-20230307144502-18.png

レスポンスコード:200 

5.RemoveRole

ユーザーのロールを削除します。HTTPメソッド:Put

パラメータ

名称形式説明
userRoleDTOUserRole 

レスポンス

ReturnType:StatusCode

例)

http://botcenter.akabot.io/api/user-remove-roleのURLにPUTリクエストを送信します。

image-20230307144502-19.png

ヘッダー:

image-20230307144502-20.png

リクエスト:

image-20230307144502-21.png

image-20230307144502-22.png

レスポンス:

image-20230307144502-23.png

レスポンスコード:200

6.AddOrganizationUnits

ユーザーの組織を追加します。HTTPメソッド:Put

パラメータ

名称形式説明
UserOrganizationUnitDTOUserRole 

レスポンス

ReturnType:StatusCode

例)

http://botcenter.akabot.io/api/user-add-organizationUnitのURLにPUTリクエストを送信します。

image-20230307144502-24.png

ヘッダー:

image-20230307144502-25.png

リクエスト:

image-20230307144502-26.png

image-20230307144502-27.png

レスポンス:

image-20230307144502-28.png

レスポンスコード:200

7.RemoveOrganizationUnits

ユーザーの組織を削除します。HTTPメソッド:Put

パラメータ

名称形式説明
UserOrganizationUnitDTOUserRole 

レスポンス

ReturnType:StatusCode

例)

http://botcenter.akabot.io/api/user-remove-organizationUnitのURLにPUTリクエストを送信します。

image-20230307144502-29.png

ヘッダー:

image-20230307144502-30.png

リクエスト:

image-20230307144502-31.png

image-20230307144502-32.png

レスポンス:

image-20230307144502-33.png

レスポンスコード:200

8.UpdateUser

ユーザー情報を更新します。HTTPメソッド:Put

パラメータ

名称形式説明
userDTOユーザ 

レスポンス

ReturnType:User

例)

http://botcenter.akabot.io/api/usersのURLにPUTリクエストを送信します。

リクエスト:

image-20230307144502-34.png

image-20230307144502-35.png

レスポンス:

image-20230307144502-36.png

image-20230307144502-37.png

9.ActivatedUser

ユーザーを有効/無効にします。HTTPメソッド:Put

パラメータ

名称形式説明
activateDTOActivate 

レスポンス

ReturnType:StatusCode

例)

http://botcenter.akabot.io/api/user-activatedのURLにPUTリクエストを送信します。

image-20230307144502-38.png

ヘッダー:

image-20230307144502-39.png

リクエスト:

image-20230307144502-40.png

image-20230307144502-41.png

レスポンス:

image-20230307144502-42.png

レスポンスコード:200

10.GetAssociatedProcesses

Agentに関するすべての使用可能なプロセスのコレクションを返します。サポートされているメソッド:Get

パラメータ

名称形式説明
robotKey文字列 

レスポンス

ReturnType: Collection(WorkFlow)

例)

http://botcenter.akabot.io/api/robotsservice/GetAssociatedProcessesのURLにGETリクエストを送信します。

image-20230307144502-43.png

パラメーター

image-20230307144502-44.png

ヘッダー:

image-20230307144502-45.png

レスポンス:

image-20230307144502-46.png

  1.  

11.Workflows

ワークフローコレクションを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
organizationUnitId整数False 
environmentId整数FalseAgentグループID
environmentName文字列FalseAgentグループ名
workflowId整数False 
workflowName文字列False 
page整数Falseリクエストされたページのページ番号
size整数Falseページのサイズ(上部)
sort文字列False

プロパティ(,asc|desc)形式でのソート基準

例:name,asc

レスポンス

ReturnType: Collection(WorkFlow)

例)

http://botcenter.akabot.io/api/work-flowsのURLにGETリクエストを送信します。

image-20230307144502-47.png

パラメーター

image-20230307144502-48.png

ヘッダー:

image-20230307144502-49.png

レスポンス:

image-20230307144502-50.png

12.WorkFlowVersion

ワークフローバージョンを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
workflowIdLongTrue 

レスポンス

ReturnType:String

例)

http://botcenter.akabot.io/api/workflowversionのURLにGETリクエストを送信します。

image-20230307144502-51.png

パラメーター

image-20230307144502-52.png

ヘッダー:

image-20230307144502-53.png

レスポンス:

1.0.12380.19828

13.UpdateWorkFlowVersion

ワークフローバージョンを更新します。サポートされているメソッド:Put

パラメータ

名称形式説明
id整数workflowId
version文字列 

レスポンス

ReturnType:Workflow

例)

http://botcenter.akabot.io/api/work-flows/{id}/versionのURLにPUTリクエストを送信します。

image-20230307144502-54.png

ヘッダー:

image-20230307144502-55.png

レスポンス

image-20230307144502-56.png

14.UploadPackage

パッケージをパッケージ リポジトリにアップロードします。サポートされているメソッド:Post

パラメータ

名称パラメータータイプ形式コンテンツタイプ
packageform-dataFilemultipart/form-data
environmentIdsform-dataArray[long]application/json

レスポンス

ReturnType:Packages

例)

http://botcenter.akabot.io/api/packageuploadのURLにPOSTリクエストを送信します。

image-20230307144502-57.png

パラメーター

image-20230307144502-58.png

ヘッダー:

image-20230307144502-59.png

レスポンス

image-20230307144502-60.png 15.Environments

Agentグループを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
organizationUnitId整数False 
environmentname文字列FalseAgentグループ名
page整数Falseリクエストされたページのページ番号
size整数Falseページのサイズ(上部)
sort文字列False

プロパティ(,asc|desc)形式でのソート基準

例:name,asc

レスポンス

ReturnType:Collection(Environment)

例)

Make a GET request to the http://botcenter.akabot.io/api/environmentsのURLにGETリクエストを送信します。

image-20230307144502-61.png

パラメーター

image-20230307144502-62.png

ヘッダー:

image-20230307144502-63.png

レスポンス:

image-20230307144502-64.png

16.StartJob

各Agentに対して新しいジョブを入力パラメータに基づいて追加し、このジョブを「Pending」状態に設定し、保留中のジョブについてAgentに通知します。HTTPメソッド:Post

パラメータ

名称形式説明
jobDTOJob 

レスポンス

ReturnType:Job

例)

http://botcenter.akabot.io/api/jobs-processingのURLにPOSTリクエストを送信します。

image-20230307144502-65.png

ヘッダー:

image-20230307144502-66.png

リクエスト:

image-20230307144502-67.png

image-20230307144502-68.png

レスポンス:

image-20230307144502-69.png

image-20230307144502-70.png StopJob

指定したジョブをキャンセルし、または停止させます。サポートされているメソッド:Put

パラメータ

名称形式説明
id整数jobId
valueString(STOP, KILL) 

レスポンス

ReturnType:Job

例)

http://botcenter.akabot.io/api/jobs-processing/{id}/{value}のURLにPUTリクエストを送信します。

image-20230307144502-71.png

ヘッダー:

image-20230307144502-72.png

レスポンス

image-20230307144502-73.png

17.GetJob

ジョブの情報を取得します。サポートされているメソッド:Get

パラメータ

名称形式説明
id整数jobId

レスポンス

ReturnType:Job

例)

http://botcenter.akabot.io/api/jobs/{id}のURLにGETリクエストを送信します。

image-20230307144502-74.png

ヘッダー:

image-20230307144502-75.png

レスポンス

image-20230307144502-76.png

18.GetJobs

ジョブコレクションを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
organizationUnitId整数False 
environmentId整数FalseAgentグループID
robotId整数False 
scheduleId整数False 
state文字列False

(PENDING、RUNNING、STOPPED、FAULTED、SUCCESSFUL)。

カンマで区切っている複数の状態をサポートします。

page整数Falseリクエストされたページのページ番号
size整数Falseページのサイズ(上部)
sort文字列False

プロパティ(,asc|desc)形式でのソート基準

例:startTime,desc

レスポンス

ReturnType:Collection(Job)

例)

http://botcenter.akabot.io/api/jobsのURLにGETリクエストを送信します。

image-20230307144502-77.png

パラメーター

image-20230307144502-78.png

ヘッダー:

image-20230307144502-79.png

レスポンス:

image-20230307144502-80.png

19.GetRobotMapping

ロボットマッピングの情報を取得します。サポートされているメソッド:Get

パラメータ

名称形式説明
licenseKey文字列Agentキー
machineName文字列 

レスポンス

ReturnType:RobotMappingVM

例)

http://botcenter.akabot.io/api/robotsservice/GetRobotMappingsのURLにGETリクエストを送信します。

image-20230307144502-81.png

パラメーター

image-20230307144502-82.png

ヘッダー:

image-20230307144502-83.png

レスポンス:

image-20230307144502-84.png

20.GetRobots

ロボットコレクションを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
organizationUnitId整数False 
environmentId整数FalseAgentグループID
robotId整数False 
robot_type整数FalseDEVELOPMENT(0)、 ASSITANT(1)、STAGING(2)、PRODUCTION(3)
robot_status整数FalseAVAILABLE(0)、BUSY(1)、DISCONNECTED(2)、UNRESPONSIVE(3)
search文字列FalseAgent名(ロボット名)
page整数Falseリクエストされたページのページ番号
size整数Falseページのサイズ(上部)
sort文字列False

プロパティ(,asc|desc)形式でのソート基準

例:name,asc

レスポンス

ReturnType:Collection(Robot)

例)

http://botcenter.akabot.io/api/robotsのURLにGETリクエストを送信します。

image-20230307144502-85.png

パラメーター

image-20230307144502-86.png

ヘッダー:

image-20230307144502-87.png

レスポンス:

image-20230307144502-88.png

21.SubmitHeartbeat

Agentのステータスを送信し、タスクコマンドのリストを取得します。サポートされているメソッド:Post

パラメータ

名称形式説明
heartbeatDTOHeartbeatDTO 

レスポンス

ReturnType:HeartbeatData

例)

http://botcenter.akabot.io/api/robotsservice/SubmitHeartbeatのURLにPOSTリクエストを送信します。

image-20230307144502-89.png

リクエスト:

image-20230307144502-90.png

image-20230307144502-91.png

ヘッダー:

image-20230307144502-92.png

レスポンス:

image-20230307144502-93.png

22.SubmitJobState

Agentからタスクのステータスを送信します。サポートされているメソッド:Post

パラメータ

名称形式説明
heartbeatDTOHeartbeatDTO 

レスポンス

例)

http://botcenter.akabot.io/api/robotsservice/SubmitJobStateのURLにPOSTリクエストを送信します。

image-20230307144502-94.png

リクエスト:

image-20230307144502-95.png

image-20230307144502-96.png

ヘッダー:

image-20230307144502-97.png

レスポンス:

23.PushLogs

ログをCenterにプッシュします。サポートされているメソッド:Post

パラメータ

名称形式説明
robotName文字列 
messagesArray(String) 

レスポンス

ReturnType:Bool

例)

http://botcenter.akabot.io/api/logs/v1のURLにPOSTリクエストを送信します。

image-20230307144502-98.png

リクエスト:

image-20230307144502-99.png

image-20230307144502-100.png

ヘッダー:

image-20230307144502-101.png

レスポンス:

True

24.GetLogs

ログコレクションを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
robotName文字列False 
workflowId整数False 
level整数FalseOFF(0)、FATAL(1)、 ERROR(2)、WARNING(3)、INFORMATION(4)、DEBUG(5)、VERBOSE(6)
jobId文字列False 
queryString文字列Falseログメッセージをクエリするキーワード
page整数Falseリクエストされたページのページ番号
size整数Falseページのサイズ(上部)
sort文字列False

プロパティ(,asc|desc)形式でのソート基準

例:timeStamp,desc

レスポンス

ReturnType:Collection(Job)

例)

http://botcenter.akabot.io/api/logsのURLにGETリクエストを送信します。

image-20230307144502-102.png

パラメーター

image-20230307144502-103.png

ヘッダー:

image-20230307144502-104.png

レスポンス:

image-20230307144502-105.png

25.GetAsset

アセットの情報を取得します。サポートされているメソッド:Get

パラメータ

名称形式説明
assetName文字列 
robotKey文字列 

レスポンス

ReturnType:AssetVM

例)

http://botcenter.akabot.io/api/studioservice/GetAssetのURLにGETリクエストを送信します。

image-20230307144502-106.png

パラメーター

image-20230307144502-107.png

ヘッダー:

image-20230307144502-108.png

レスポンス:

image-20230307144502-109.png

26.SetAsset

アセットの値を更新します。サポートされているメソッド:Post

パラメータ

名称形式説明
assetVMAssetVM 

レスポンス

ReturnType:Bool

例)

http://botcenter.akabot.io/api/studioservice/SetAssetのURLにPOSTリクエストを送信します。

image-20230307144502-110.png

リクエスト:

image-20230307144502-111.png

image-20230307144502-112.png

ヘッダー:

image-20230307144502-113.png

レスポンス:

True

27.GetQueue

キューコレクションを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
nameLongFalseキューID
queueName文字列Falseキュー名
page整数Falseリクエストされたページのページ番号
size整数Falseページのサイズ(上部)
sort文字列False

プロパティ(,asc|desc)形式でのソート基準

例:timeStamp,desc

レスポンス

ReturnType:Collection(Queue)

例)

http://botcenter.akabot.io/api/queueのURLにGETリクエストを送信します。

image-20230307144502-114.png

パラメーター

image-20230307144502-115.png

ヘッダー:

image-20230307144502-116.png

レスポンス:

image-20230307144502-117.png

 28.GetQueuItems

キュー項目のコレクションを取得します。サポートされているメソッド:Post

パラメータ

名称形式説明
queueName文字列 
reference文字列 
filterStrategyString (STARTSWITH, EQUALS)reference用
statusString(New, InProgress, Failed, Successful, Abandoned, Retried, Deleted, Expired)キュー項目のステータス。 複数の値のフィルタリングがサポートされている
FromDateTime作成日
ToDateTime作成日
TopInt戻り項目の数を制限
SkipIntオフセット

レスポンス

ReturnType:Collection(QueueItem)

例)

http://botcenter.akabot.io/api/queue/getQueueItemsのURLにPOSTリクエストを送信します。

image-20230307144502-118.png

リクエスト:

image-20230307144502-119.png

image-20230307144502-120.png

ヘッダー:

image-20230307144502-121.png

レスポンス:

image-20230307144502-122.png

29.GetQueueDetails

キュー項目のコレクションを取得します。サポートされているメソッド:Get

パラメータ

名称形式必須説明
idLongtrueキューID
reference文字列False 
exceptionIntegerFalseApplication(0)、Business(1)
priority整数FalseHigh(3)、Normal(2)、Low(1)
status整数FalseNew(0)、InProgress(1)、Failed(2)、Successful(3)、Abandoned(4)、Retried(5)、Deleted(6)、Expired(7)
specificData文字列FalsespecificDataをクエリするキーワード
startFromDateTimeFalsestarttimeをクエリする
startToDateTimeFalsestarttimeをクエリする
page整数Falseリクエストされたページのページ番号
size整数Falseページのサイズ(上部)
sort文字列False

プロパティ(,asc|desc)形式でのソート基準

例:timeStamp,desc

レスポンス

ReturnType:Collection(QueueItems)

例)

http://botcenter.akabot.io/api/queue/{id}/detailのURLにGETリクエストを送信します。

image-20230307144502-123.png

パラメーター

image-20230307144502-124.png

ヘッダー:

image-20230307144502-125.png

レスポンス:

image-20230307144502-126.png

30.AddQueueItem

キュー項目を追加します。HTTPメソッド:Post

パラメータ

名称形式説明
queueName文字列 
priorityString(High, Normal, Low) 
reference文字列 
robotName文字列 
specificData文字列 
deadlineDataTime 
postponeDateTime 

レスポンス

ReturnType:HttpStatus

例)

http://botcenter.akabot.io/api/queue/addQueueItemのURLにPOSTリクエストを送信します。

image-20230307144502-127.png

ヘッダー:

image-20230307144502-128.png

リクエスト:

image-20230307144502-129.png

 

  
Navigation