システム設定API
説明概要
ユーザ/組織/所属の情報を操作するシステム設定APIを説明します。
APIによっては、GET/POSTリクエストに対してJSONやXMLをレスポンスします。
システム設定APIの種類
ユーザ設定API
操作 |
GET/POSTリクエストURL |
レスポンス(JSON) |
実行に必要な権限 |
ユーザを追加する |
<ContextRoot>/API/UGA/Quser/add |
QuserEntry |
ユーザ管理権限 |
ユーザ情報を取得する |
<ContextRoot>/API/User/Quser/find |
QuserEntry |
全ログインユーザ |
自身のユーザ情報を取得する |
<ContextRoot>/API/User/Quser/self |
QuserEntry |
全ログインユーザ |
ユーザ一覧を取得する |
<ContextRoot>/API/User/Quser/list |
QuserEntryのリスト |
全ログインユーザ |
ユーザ情報を更新する |
<ContextRoot>/API/UGA/Quser/update |
QuserEntry |
ユーザ管理権限 |
ユーザを削除する |
<ContextRoot>/API/UGA/Quser/delete |
なし |
ユーザ管理権限 |
「<ContextRoot>」は、DataSpider BPMのルートURIである「http(s)://<ホスト名>:<ポート番号>/userweb」を意味します。
ユーザ設定APIのレスポンス
QuserEntryの構造
属性 |
型 |
説明 |
id |
整数 |
ユーザのID |
name |
文字列 |
ユーザの名前 |
email |
文字列 |
ユーザのe-mailアドレス |
正常応答の例(1ユーザ)
{"quser":{"email":"Sato@localhost.localdomain","id":0,"name":"佐藤"}}
正常応答の例(複数ユーザ)
{"qusers":[
{"email":"Sato@localhost.localdomain","id":0,"name":"佐藤"},
{"email":"Suzuki@localhost.localdomain","id":1,"name":"鈴木"},
{"email":"Takahashi@localhost.localdomain","id":2,"name":"高橋"},
{"email":"Tanaka@localhost.localdomain","id":3,"name":"田中"},
{"email":"Watanabe@localhost.localdomain","id":4,"name":"渡辺"},
{"email":"Ito@localhost.localdomain","id":5,"name":"伊藤"},
{"email":"Yamamoto@localhost.localdomain","id":6,"name":"山本"},
{"email":"Nakamura@localhost.localdomain","id":7,"name":"中村"},
{"email":"Kobayashi@localhost.localdomain","id":8,"name":"小林"},
{"email":"Kato@localhost.localdomain","id":9,"name":"加藤"}
]}
ユーザ設定API詳細
ユーザを追加する: /API/UGA/Quser/add
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
name |
必須 |
対象ユーザの名前 |
email |
必須 |
対象ユーザのe-mailアドレス |
password |
必須 |
対象ユーザのパスワード |
レスポンス
発生する可能性のあるエラー
ユーザ情報を取得する: /API/User/Quser/find
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
id |
任意 |
対象ユーザのID |
email |
任意 |
対象ユーザのe-mailアドレス
両方とも指定された場合は、idのみが有効になります。
|
レスポンス
発生する可能性のあるエラー
自身のユーザ情報を取得する: /API/User/Quser/self
リクエストパラメータ
レスポンス
発生する可能性のあるエラー
ユーザ一覧を取得する: /API/User/Quser/list
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
limit |
任意 |
対象ユーザの最大件数
指定しない場合は、「1」が指定されたものとみなされます。
|
start |
任意 |
対象ユーザの開始位置
指定しない場合は、「0」が指定されたものとみなされます。
例: 検索結果の全件が100件で、startに「10」、limitに「50」を指定した場合、100件のうち11件目から60件目までを取得します。
|
query |
任意 |
検索文字列
値が指定された場合、その値がe-mailアドレスまたは名前の一部に含まれているユーザを検索します。
qgroupIdと組み合わせて検索することができます。
|
qgroupId |
任意 |
組織のID
値が指定された場合、その組織に直属するユーザを検索します。
queryと組み合わせて検索することができます。
|
レスポンス
発生する可能性のあるエラー
ユーザ情報を更新する: /API/UGA/Quser/update
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
id |
必須 |
対象ユーザのID
|
name |
任意 |
対象ユーザの新しい名前
|
email |
任意 |
対象ユーザの新しいe-mailアドレス
|
password |
任意 |
対象ユーザの新しいパスワード
|
レスポンス
発生する可能性のあるエラー
ユーザを削除する: /API/UGA/Quser/delete
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
id |
必須 |
対象ユーザのID
|
delegateQuserId |
任意 |
対象ユーザのタスクを引き受けるユーザのID
削除するユーザがタスクを持っている場合、指定が必須となります。
|
delegateQgroupId |
任意 |
対象ユーザのタスクを引き受けるユーザが、どの組織としてタスクを実行するかを指定する組織のID
削除するユーザがタスクを持っている場合、指定が必須となります。
|
レスポンス
発生する可能性のあるエラー
- InvalidId: 10001
- InvalidDelegateQuserId: 10007
- InvalidDelegateQgroupId: 10008
- QuserDoesNotExist: 20002
- DelegateDoesNotExist: 20007
- NoneSystemAdministrator: 20008
- DelegateIsSameWithDeletingUser: 20014
- NeedDelegate: 20015
- YourselfUndeletable: 20022
組織設定API
操作 |
GET/POSTリクエストURL |
レスポンス(JSON) |
実行に必要な権限 |
組織を追加する |
<ContextRoot>/API/UGA/Qgroup/add |
QgroupEntry |
ユーザ管理権限 |
組織情報を取得する |
<ContextRoot>/API/User/Qgroup/find |
QgroupEntry |
全ログインユーザ |
組織一覧を取得する |
<ContextRoot>/API/User/Qgroup/list |
QgroupEntryのリスト |
全ログインユーザ |
組織情報を更新する |
<ContextRoot>/API/UGA/Qgroup/update |
QgroupEntry |
ユーザ管理権限 |
組織を削除する |
<ContextRoot>/API/UGA/Qgroup/delete |
なし |
ユーザ管理権限 |
「<ContextRoot>」は、DataSpider BPMのルートURIである「http(s)://<ホスト名>:<ポート番号>/userweb」を意味します。
組織設定APIのレスポンス
QgroupEntryの構造
属性 |
型 |
説明 |
id |
整数 |
組織のID |
name |
文字列 |
組織の名前 |
email |
文字列 |
組織のe-mailアドレス |
parentQgroupId |
整数 |
親組織の組織のID |
parentQgroupName |
文字列 |
親組織の名前 |
parentQgroupEmail |
文字列 |
親組織のe-mailアドレス |
正常応答の例(1組織)
{"qgroup":
{"email":"accounting@localhost.localdomain","id":2,"name":"経理部",
"parentQgroupEmail":"org@localhost.localdomain","parentQgroupId":1,"parentQgroupName":"全社"}
}
正常応答の例(複数組織)
{"qgroups":[
{"email":"org@localhost.localdomain","id":1,"name":"全社",
"parentQgroupEmail":null,"parentQgroupId":null,"parentQgroupName":null},
{"email":"accounting@localhost.localdomain","id":2,"name":"経理部",
"parentQgroupEmail":"org@localhost.localdomain","parentQgroupId":1,"parentQgroupName":"全社"},
{"email":"sales@localhost.localdomain","id":3,"name":"営業部",
"parentQgroupEmail":"org@localhost.localdomain","parentQgroupId":1,"parentQgroupName":"全社"},
{"email":"marketing@localhost.localdomain","id":4,"name":"マーケティング部",
"parentQgroupEmail":"org@localhost.localdomain","parentQgroupId":1,"parentQgroupName":"全社"},
{"email":"production@localhost.localdomain","id":5,"name":"製造部",
"parentQgroupEmail":"org@localhost.localdomain","parentQgroupId":1,"parentQgroupName":"全社"}
]}
組織設定API詳細
組織を追加する: /API/UGA/Qgroup/add
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
name |
必須 |
対象組織の名前 |
email |
任意 |
対象組織のe-mailアドレス |
parentQgroupId |
必須 |
対象組織の親組織のID |
レスポンス
発生する可能性のあるエラー
組織情報を取得する: /API/User/Qgroup/find
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
id |
任意 |
対象組織のID |
name |
任意 |
対象組織の名前
|
レスポンス
発生する可能性のあるエラー
組織一覧を取得する: /API/User/Qgroup/list
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
limit |
任意 |
対象組織の取得最大件数
指定しない場合は、「1」が指定されたものとみなされます。
|
start |
任意 |
対象組織の取得開始位置
指定しない場合は、「0」が指定されたものとみなされます。
例: 検索結果の全件が100件で、startに「10」、limitに「50」を指定した場合、100件のうち11件目から60件目までを取得します。
|
query |
任意 |
検索文字列
値が指定された場合、その値がe-mailアドレスまたは名前の一部に含まれている組織を検索します。
|
レスポンス
発生する可能性のあるエラー
組織情報を更新する: /API/UGA/Qgroup/update
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
id |
必須 |
対象組織のID
|
name |
任意 |
対象組織の新しい名前
|
email |
任意 |
対象組織の新しいe-mailアドレス
|
parentQgroupId |
任意 |
対象組織の新しい親組織のID
|
レスポンス
発生する可能性のあるエラー
組織を削除する: /API/UGA/Qgroup/delete
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
id |
必須 |
対象組織のID
|
レスポンス
発生する可能性のあるエラー
- InvalidId: 10001
- QgroupDoesNotExist: 20004
- ParentQgroupUndeletable: 20009
- RootQgroupUndeletable: 20010
メンバーシップ設定API
操作 |
GET/POSTリクエストURL |
レスポンス(JSON) |
実行に必要な権限 |
組織にメンバを追加する |
<ContextRoot>/API/UGA/Membership/add |
MembershipEntry |
ユーザ管理権限 |
組織に所属するメンバ一覧を取得する |
<ContextRoot>/API/UGA/Membership/listByQgroup |
MembershipEntryのリスト |
ユーザ管理権限 |
メンバが所属する組織一覧を取得する |
<ContextRoot>/API/UGA/Membership/listByQuser |
MembershipEntryのリスト |
ユーザ管理権限 |
組織のリーダ設定を更新する |
<ContextRoot>/API/UGA/Membership/update |
MembershipEntry |
ユーザ管理権限 |
組織からメンバを外す |
<ContextRoot>/API/UGA/Membership/delete |
なし |
ユーザ管理権限 |
「<ContextRoot>」は、DataSpider BPMのルートURIである「http(s)://<ホスト名>:<ポート番号>/userweb」を意味します。
メンバーシップ設定APIのレスポンス
MembershipEntryの構造
属性 |
型 |
説明 |
quserId |
整数 |
ユーザのID |
quserName |
文字列 |
ユーザの名前 |
quserEmail |
文字列 |
ユーザのe-mailアドレス |
qgroupId |
整数 |
親組織の組織のID |
qgroupName |
文字列 |
親組織の名前 |
qgroupEmail |
文字列 |
親組織のe-mailアドレス |
role |
文字列 |
メンバのロール
リーダ: 「_leader」
メンバ: null
|
正常応答の例(1メンバ)
{"membership":
{"qgroupEmail":"marketing@localhost.localdomain","qgroupId":4,"qgroupName":"マーケティング部",
"quserEmail":"Ito@localhost.localdomain","quserId":5,"quserName":"伊藤","role":"_leader"}
}
正常応答の例(複数メンバ)
{"memberships":[
{"qgroupEmail":"marketing@localhost.localdomain","qgroupId":4,"qgroupName":"マーケティング部",
"quserEmail":"Ito@localhost.localdomain","quserId":5,"quserName":"伊藤","role":"_leader"},
{"qgroupEmail":"marketing@localhost.localdomain","qgroupId":4,"qgroupName":"マーケティング部",
"quserEmail":"Yamamoto@localhost.localdomain","quserId":6,"quserName":"山本","role":null},
{"qgroupEmail":"marketing@localhost.localdomain","qgroupId":4,"qgroupName":"マーケティング部",
"quserEmail":"Nakamura@localhost.localdomain","quserId":7,"quserName":"中村","role":null}
]}
メンバーシップ設定API詳細
組織にメンバを追加する: /API/UGA/Membership/add
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
quserId |
必須 |
対象ユーザのID |
qgroupId |
必須 |
対象組織のID |
role |
任意 |
メンバのロール
リーダの場合、「_leader」を指定します。
|
レスポンス
発生する可能性のあるエラー
組織に所属するメンバ一覧を取得する: /API/UGA/Membership/listByQgroup
リクエストパラメータ
パラメータ名 |
必須 |
説明 |
id |
必須 |
対象組織のID |
レスポンス
発生する可能性のあるエラー
メンバが所属する組織一覧を取得する: /API/UGA/Membership/listByQuser
パラメータ名 |
必須 |
説明 |
id |
必須 |
対象ユーザのID |
レスポンス
発生する可能性のあるエラー
組織のリーダ設定を更新する: /API/UGA/Membership/update
パラメータ名 |
必須 |
説明 |
quserId |
必須 |
ロールを変更するユーザのID |
qgroupId |
必須 |
ロールを変更する組織のID |
role |
任意 |
新しいロール
リーダの場合、「_leader」を指定します。
|
レスポンス
発生する可能性のあるエラー
- InvalidQuserId: 10002
- InvalidQgroupId: 10003
- InvalidRole: 10010
- QuserDoesNotExist: 20002
- QgroupDoesNotExist: 20004
- MembershipDoesNotExist: 20006
- NoneSystemAdministrator: 20008
組織からメンバを外す: /API/UGA/Membership/delete
パラメータ名 |
必須 |
説明 |
quserId |
必須 |
削除するメンバのユーザのID |
qgroupId |
必須 |
メンバを削除する組織のID |
レスポンス
発生する可能性のあるエラー
- InvalidQuserId: 10002
- InvalidQgroupId: 10003
- QuserDoesNotExist: 20002
- QgroupDoesNotExist: 20004
- MembershipDoesNotExist: 20006
- NoneSystemAdministrator: 20008