跳转至

部门新增

功能说明

添加部门

接口地址

HTTP请求方式

  • Method: POST
  • Content-Type: application/x-www-form-urlencoded

参数说明

  • 公有参数

    发送请求是必须传入公共参数，详见公共参数

  • 私有参数

参数名称 是否必须 参数类型 长度限制 描述
enterprise_code 否 string [1,20] 企业编号(集团必填,企业无需填写)
dept_code 是 string [1,50] 部门编码
name 是 string [1,100] 部门名称
parent_code 否 string [1,50] 上级部门编码,如果不传，则默认添加到根部门下
status 否 int [1] 部门是否有效，1有效、2无效

请求示例（HTTP）

POST /department/add HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

access_token=6007bf4c6efeb798da35b843e4614cff&dept_code=S100&name=部门测试&parent_code=S000&
timestamp=1501741860&version=1.0.0&sign=dc2cb643d101d8ae96e857ff4ca24de23bf4f27f&status=1

请求示例（JAVA SDK）

public class Main {
    public static OpenClient openClient = new OpenClient(Constants.BASE_URL_TEST, "xxx", "xxx");
    public static void main(String[] args) {
        DepartmentAddRequest departmentAddRequest = new DepartmentAddRequest();
        departmentAddRequest.setDeptCode("DEPT_0825_02");
        departmentAddRequest.setName("DEPT_0825_02");
        departmentAddRequest.setParentCode("DEPT_0825_01");

        String data = openClient.departmentApi().add(departmentAddRequest);
        System.out.println(data);
    }
}

返回参数说明

参数名称 描述
code 返回码。详见错误返回码。
msg 如果错误，返回错误信息。
data 如果没有错误，返回部门编号

正确返回示例

{
    "code": 0,
    "data": "S100",
    "msg": "OK"
}

错误返回示例

{
    "code": 1002212003,
    "msg": "部门添加或更新：名称已存在",
    "data": null
}

常见错误码

错误码 错误信息 排查方法
1000220002 参数验证不通过 检测参数是否按要求填写
1000220011 parent_code not exists ! 检测父部门是否已添加
1002212003 部门添加或更新：名称已存在 企业同级部门名称不能重复
1002212010 部门编码已存在 企业部门编码唯一
1000240002 enterprise_code校验失败 检查enterprise_code是否是已绑定的编码
other 其他公共错误码 其他公共错误码
回到页面顶部