部门管理
部门管理
新增部门信息
接口URL
/adddeptinfo
请求参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| CorpCode | 企业账号 | Y | String | 1000 | 系统提供的企业账号。 | |
| Timestamp | 时间戳 | Y | String | 14 | 20180811113019 | 服务方仅允许20分钟内的时间误差。 |
| Version | 版本号 | Y | String | 3.0 | 固定为3.0。 | |
| LoginName | 操作人帐号 | Y | String | HW_000001 | 1、如果是系统维护，写“sysadmin”2、如果是普通员工维护，写员工登录名 | |
| MsgID | 唯一标识 | Y | String | 1000120150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN | |
| Dept | 部门信息 | Y | Dept | 如果按照部门层级展示，则需要按照部门从上到下调用接口 | ||
| LoginCorpCode | 登录企业账号 | N | String | 相对于CorpCode参数，如果LoginCorpCode不存在，则CorpCode既为对接企业账号也为登录企业账号，如果LoginCorpCode存在，则CorpCode为对接企业账号，LoginCorpCode为登录企业账号。登录企业账号：用户实际归属的企业的账号 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| ResultCode | 返回码 | Y | String | 0 | 0表示成功，其他值为失败。 | |
| Description | 描述 | Y | String | Success | 描述信息，出错时为错误信息即错误原因。 |
样例
请求
{
"CorpCode": "0008",
"Timestamp": "20220929100252",
"Version": "3.0",
"LoginName": "sysadmin",
"MsgID": "0008120220929071248283828",
"Dept": {
"DeptNum": "1",
"DeptName": "产品与解决方案",
"DeptDescription": "产品与解决方案"
},
"LoginCorpCode": "0008"
}
返回
{
"ResultCode": "0",
"Description": "成功"
}
修改部门信息
接口URL
/modideptinfo
请求参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| CorpCode | 企业账号 | Y | String | 1000 | 系统提供的企业账号 | |
| Timestamp | 时间戳 | Y | String | 14 | 20180811113019 | 服务方仅允许20分钟内的时间误差。 |
| Version | 版本号 | Y | String | 3.0 | 固定为3.0。 | |
| LoginName | 操作人帐号 | Y | String | HW_000001 | 1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>" | |
| MsgID | 唯一标识 | Y | String | 1000120150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN | |
| Dept | 部门信息 | Y | Dept | |||
| LoginCorpCode | 登录企业账号 | N | String | 相对于CorpCode参数，如果LoginCorpCode不存在，则CorpCode既为对接企业账号也为登录企业账号，如果LoginCorpCode存在，则，则CorpCode为对接企业账号，LoginCorpCode为登录企业账号。登录企业账号：用户实际归属的企业的账号 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| ResultCode | 返回码 | Y | String | 0 | 0表示成功，其他值为失败。 | |
| Description | 描述 | Y | String | Success | 描述信息，出错时为错误信息即错误原因。 |
样例
请求
{
"CorpCode": "0008",
"Timestamp": "20220929100252",
"Version": "3.0",
"LoginName": "sysadmin",
"MsgID": "0008120220929071248283828",
"Dept": {
"DeptNum": "1",
"DeptName": "产品与解决方案",
"DeptDescription": "产品与解决方案"
},
"LoginCorpCode": "0008"
}
返回
{
"ResultCode": "0",
"Description": "成功"
}
删除部门信息
接口URL
/deldeptinfo
请求参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| CorpCode | 企业账号 | Y | String | 1000 | 系统提供的企业账号 | |
| Timestamp | 时间戳 | Y | String | 14 | 20180811113019 | 服务方仅允许20分钟内的时间误差。 |
| Version | 版本号 | Y | String | 3.0 | 固定为3.0。 | |
| LoginName | 操作人帐号 | Y | String | HW_000001 | 1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>" | |
| MsgID | 唯一标识 | Y | String | 1000120150511190411000001 | 企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN | |
| DeptNum | 部门编号 | Y | String | 1234 | ||
| LoginCorpCode | 登录企业账号 | N | String | 相对于CorpCode参数，如果LoginCorpCode不存在，则CorpCode既为对接企业账号也为登录企业账号，如果LoginCorpCode存在，则，则CorpCode为对接企业账号，LoginCorpCode为登录企业账号。登录企业账号：用户实际归属的企业的账号 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| ResultCode | 返回码 | Y | String | 0 | 0表示成功，其他值为失败。 | |
| Description | 描述 | Y | String | Success | 描述信息，出错时为错误信息即错误原因。 |
样例
请求
{
"CorpCode": "0008",
"Timestamp": "20220929100252",
"Version": "3.0",
"LoginName": "sysadmin",
"MsgID": "0008120220929071248283828",
"DeptNum": "1",
"LoginCorpCode": "0008"
}
返回
{
"ResultCode": "0",
"Description": "成功"
}