跳转至

查询部门

功能说明

查询部门

接口地址

HTTP请求方式

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

参数说明

  • 公有参数

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

  • 私有参数

参数名称 是否必须 参数类型 长度限制 描述
enterprise_code 否 string [1,20] 企业编号(集团必填,企业无需填写)
dept_code 是 string [1,50] 部门编码

请求示例（HTTP）

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

access_token=6007bf4c6efeb798da35b843e4614cff&dept_code=S100&
timestamp=1495094685&sign=dc2cb643d101d8ae96e857ff4ca24de23bf4f27f

请求示例（JAVA SDK）

public class Main {
    public static OpenClient openClient = new OpenClient(Constants.BASE_URL_TEST, "xxx", "xxx");
    public static void main(String[] args) {
        DepartmentGetRequest departmentGetRequest = new DepartmentGetRequest();
        departmentGetRequest.setDeptCode("DEPT_0825_02");
        DepartmentResp departmentResp = openClient.departmentApi().get(departmentGetRequest);
        System.out.println(JSON.toJSONString(departmentResp));
    }
}

返回参数说明

参数名称 描述
code 返回码。详见错误返回码。
msg 如果错误，返回错误信息。
data 如果没有错误，返回部门信息
data.dept_code 部门编码
data.name 部门名称
data.parent_code 上级部门编码
data.manager_code 部门主管工号
data.manager_userid 部门主管第三方唯一标识
data.status 部门状态，1有效、2无效
data.is_primary 是否一级部门：true or false

正确返回示例

{
    "code": 0,
    "data": {
        "name": "销售部",
        "status": 1,
        "dept_Code": "S100",
        "parent_code": "A001",
        "manager_code": "SN123",
        "is_primary": false
    },
    "msg": "OK"
}

错误返回示例

{
    "code": 1000210001,
    "msg": "timestamp check failed!",
    "data": null
}

常见错误码

错误码 错误信息 排查方法
1000220002 参数验证不通过 检测参数是否按要求填写
1000220010 dept_code not exists ! 检测部门是否成功添加
1000240002 enterprise_code校验失败 检查enterprise_code是否是已绑定的编码
other 其他公共错误码 其他公共错误码
回到页面顶部