システム設定API

説明概要

ユーザ/組織/所属の情報を操作するシステム設定APIを説明します。
APIによっては、GET/POSTリクエストに対してJSONやXMLをレスポンスします。

システム設定APIの種類

ユーザ設定API ユーザ情報に関する参照/追加/更新/削除を行うAPIです。
組織設定API 組織情報に関する参照/追加/更新/削除を行うAPIです。
メンバーシップ設定API 所属情報に関する参照/追加/更新/削除を行う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
削除するユーザがタスクを持っている場合、指定が必須となります。

レスポンス

発生する可能性のあるエラー

組織設定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

レスポンス

発生する可能性のあるエラー

メンバーシップ設定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」を指定します。

レスポンス

発生する可能性のあるエラー

組織からメンバを外す: /API/UGA/Membership/delete

パラメータ名 必須 説明
quserId 必須 削除するメンバのユーザのID
qgroupId 必須 メンバを削除する組織のID

レスポンス

発生する可能性のあるエラー