概要
部署リストを取得します。
リクエストアドレスの例
https://HOST:PORT/api/v2/department
リクエスト方法
GET
リクエストパラメーター
通常のレスポンス
レスポンスのフィールド
department フィールドの説明
エラーレスポンスのフィールド
概要
部署コードから部署情報を取得します。
リクエストアドレスの例
https://HOST:PORT/api/v2/department/search/code
リクエスト方法
GET
リクエストパラメーター
通常のレスポンス
レスポンスのフィールド
エラーレスポンスのフィールド
概要
部署 ID から部署情報を取得します。
リクエストアドレスの例
https://HOST:PORT/api/v2/department/{id}
リクエスト方法
GET
リクエストパラメーター
通常のレスポンス
レスポンスのフィールド
エラーレスポンスのフィールド
概要
部署作成のインターフェースです。
リクエストアドレスの例
https://HOST:PORT/api/v2/department
リクエスト方法
POST: form-data
リクエストパラメーター
通常のレスポンス
レスポンスのフィールド
エラーレスポンスのフィールド
概要
部署インターフェースを更新します。
リクエストアドレスの例
https://HOST:PORT/api/v2/department/update
リクエスト方法
POST: form-data
リクエストパラメーター
通常のレスポンス
レスポンスのフィールド
エラーレスポンスのフィールド
概要
部署を削除します。
リクエストアドレスの例
https://HOST:PORT/api/v2/department/delete
リクエスト方法
GET
リクエストパラメーター
通常のレスポンス
エラーレスポンスのフィールド
パラメーター名
型
必須
説明
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。2.2.1 シグネチャ(sign)の計算 の章を参照してください。
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
id
long
部署ID
name
string
部署名
parent_id
long
上位部署の ID。0 は企業を示します。
leader_id
long
部署長の ID
leader_name
string
部署長の名前
user_num
int
部署内の人数
children
list<department>
下位部署のリスト
パラメーター名
型
説明
id
long
部署ID
name
string
部署名
parent_id
long
上位部署の ID。0 は企業を示します。
leader_id
long
部署長の ID
leader_name
string
部署長の名前
user_num
int
部署内の人数
children
list<department>
下位部署のリスト
コード
メッセージ
説明
30001
Param Invalid
無効なパラメーターです
パラメーター名
型
必須
説明
code
string
Yes
部署コード。長さ制限は 45。
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。2.2.1 シグネチャ(sign)の計算 の章を参照してください。
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
id
long
部署ID
name
string
部署名
parent_id
long
上位部署の ID。0 は企業を示します。
leader_id
long
部署長の ID
code
string
部署コード
コード
メッセージ
説明
30001
Param Invalid
無効なパラメーターです
パラメーター名
型
必須
説明
id
long
Yes
部署ID
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。2.2.1 シグネチャ(sign)の計算 の章を参照してください。
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
id
long
部署ID
name
string
部署名
parent_id
long
上位部署の ID。0 は企業を示します。
leader_id
long
部署長の ID
code
string
部署コード
コード
メッセージ
説明
30001
Param Invalid
無効なパラメーターです。部署IDが存在しません。
パラメーター名
型
必須
説明
parentId
long
Yes
上位部署 ID
name
string
Yes
名前。長さ制限は 50。空の値で登録しないでください。
leaderId
long
No
部署長の ID
code
string
No
部署コード。長さ制限は 45。
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。2.2.1 シグネチャ(sign)の計算 の章を参照してください。
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
id
long
部署ID
name
string
部署名
parent_id
long
上位部署の ID。0 は企業を示します。
leader_id
long
部署長の ID
code
string
部署コード
コード
メッセージ
説明
498
Param Invalid
上位の部署を選択ください。
610
Similar record Exist
同じ名前の部署が同じレベルに存在します。
620
Record non-existent Error
上位部署の ID が存在しません。
30001
Param Invalid
無効なパラメーターです。部署名は空にはできません。
30001
Param Invalid
無効なパラメーターです。部署長が存在しません。
30001
Param Invalid
無効なパラメーターです。部署コードはすでに存在します。
パラメーター名
型
必須
説明
id
long
Yes
部署ID
parentId
long
Yes
上位部署 ID。上位部署IDが存在しない場合、エラーとなる可能性があります。ご注意ください。
name
string
Yes
名前。長さ制限は 50。
leaderId
long
No
部署長の ID
code
string
No
部署コード。長さ制限は 45。
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。2.2.1 シグネチャ(sign)の計算 の章を参照してください。
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
id
long
部署ID
name
string
部署名
parent_id
long
上位部署の ID。0 は企業を示します。
leader_id
long
部署長の ID
code
string
部署コード
コード
メッセージ
説明
610
Similar record Exist
同じ名前の部署が同じレベルに存在します。
620
Record non-existent Error
上位部署の ID が無効です(現在のノードの上位部署は指定できません)
30001
Param Invalid
無効なパラメーターです。上位部署の ID は空にはできません。
30001
Param Invalid
無効なパラメーターです。部署 ID は空にはできません。
30001
Param Invalid
無効なパラメーターです。部署名は空にはできません。
30001
Param Invalid
無効なパラメーターです。部署長が存在しません。
30001
Param Invalid
無効なパラメーターです。部署コードはすでに存在します。
パラメーター名
型
必須
説明
id
long
Yes
部署ID
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。2.2.1 シグネチャ(sign)の計算 の章を参照してください。
timestamp
string
Yes
タイムスタンプ
コード
メッセージ
説明
610
Similar record Exist
部署にユーザーが存在しているため、部署を削除できません。
610
Similar record Exist
部署に下位部署があります。
620
Record non-existent Error
上位部署の ID が存在しません。