概要
部署リストを取得します。
リクエストアドレスの例
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
シグネチャ。1.3.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
シグネチャ。1.3.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
シグネチャ。1.3.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
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
パラメーター名
型
説明
id
long
部署ID
name
string
部署名
parent_id
long
上位部署の ID。0 は企業を示します
leader_id
long
部署長の ID
code
string
部署コード
コード
メッセージ
説明
30001
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
シグネチャ。1.3.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
無効なパラメーターです。部署 ID は空にはできません
30001
Param Invalid
無効なパラメーターです。部署名は空にはできません
30001
Param Invalid
無効なパラメーターです。部署長が存在しません
30001
Param Invalid
無効なパラメーターです。部署コードはすでに存在します
パラメーター名
型
必須
説明
id
long
Yes
部署ID
app_key
string
Yes
Appキー
sign
string
Yes
シグネチャ。1.3.1 シグネチャ(sign)の計算の項を参照してください
timestamp
string
Yes
タイムスタンプ
コード
メッセージ
説明
610
Similar record Exist
部署にユーザーが存在しているため、部署を削除できません
610
Similar record Exist
部署に下位部署があります
620
Record non-existent Error
上位部署の ID が存在しません