文 档 中 心 / Document Center
搜索 管理中心
壹川接口文档V3
获取指定部门的职位列表
更新时间:2018-04-13 14:04:51   更新人员:叶洋   文档状态:完成 #104    测试接口
摘要
获取职位列表
  1. 接口基本信息
    接口名称:获取职位列表
    请求方法:GET
    接口地址:position
    登录验证:是
  2. 请求参数
    参数名 参数 数据类型 是否必须 示例值 说明
    page 分页 int
    row 每页数量 int
    dept_id 指定部门id int
    otype 归属组织类型 int 没有指定部门id时,指定组织参考同类内建组织添加
    linkid 归属组织id string
    innerbuild 是否内建 string 该参数只有系统级别管理人员才有效,值为yes时获取内建职位列表
  3. 响应数据参数
    参数名 参数 数据类型 示例值 说明
    id 职位id int
    dept_id 所属部门id int
    create_time 创建时间 string
    create_by{} 创建人信息 object
    ├ uid ├ 创建人uid string
    ├ code ├ 创建人编码 string
    ├ username ├ 创建人用户名 string
    ├ nickname ├ 创建人昵称 string
    └ realname └ 创建人真实姓名 string
    update_time 更新时间 string
    update_by{} 更新人信息 object
    ├ uid ├ 更新人uid string
    ├ code ├ 更新人代码 string
    ├ username ├ 更新人用户名 string
    ├ nickname ├ 更新人昵称 string
    └ realname └ 更新人真实姓名 string
    status 状态 string 启用状态 1正常 0禁用
    builtin 系统标准 string 系统标准 禁止删除
    name 职位名称 string
    description 职位描述 string
    dpinfo{} 所属部门信息 object
    ├ id ├ 所属部门id string
    ├ dp_type ├ 所属部门所属组织类型 string
    ├ dp_id ├ 所属部门所属组织id string
    ├ pid ├ 所属部门的上级部门 int
    ├ status ├ 所属部门状态 int
    ├ name ├ 所属部门名称 string
    └ description └ 所属部门描述 string
  4. 请求示例
    请求例子:
     
    apirq('position', {
        data: {
            "dp_type": 3,
            "dp_id": "05d48fa8743570b0"
        }
    }) 
    
    返回数据结果:
     
    {
        "code": 0,
        "msg": "ok",
        "time": "1523599225",
        "data": {
            "page": 1,
            "row": 15,
            "count": 3,
            "total_count": 3,
            "total_page": 1,
            "lists": [
                {
                    "id": 50,
                    "dpmt_id": 44,
                    "create_time": "2018-03-27 13:27:06",
                    "create_by": {
                        "uid": "0000000000000101",
                        "code": "U4219695",
                        "username": "admin@cw",
                        "nickname": "系统内建财务员",
                        "realname": "系统内建财务员"
                    },
                    "update_time": "2018-03-27 13:27:06",
                    "update_by": {
                        "uid": "0000000000000101",
                        "code": "U4219695",
                        "username": "admin@cw",
                        "nickname": "系统内建财务员",
                        "realname": "系统内建财务员"
                    },
                    "status": 1,
                    "bandel": 0,
                    "name": "部管",
                    "description": "天天向上默认部门管理部管理员",
                    "dpinfo": {
                        "id": 44,
                        "dp_type": 3,
                        "dp_id": "05d48fa8743570b0",
                        "pid": 0,
                        "status": 1,
                        "bandel": 0,
                        "create_time": "2018-03-27 13:27:06",
                        "create_by": "0000000000000101",
                        "update_time": "2018-03-27 13:27:06",
                        "update_by": "0000000000000101",
                        "name": "管理部",
                        "description": "天天向上机构管理部门"
                    }
                },
                {
                    "id": 51,
                    "dpmt_id": 45,
                    "create_time": "2018-03-27 13:27:07",
                    "create_by": {
                        "uid": "0000000000000101",
                        "code": "U4219695",
                        "username": "admin@cw",
                        "nickname": "系统内建财务员",
                        "realname": "系统内建财务员"
                    },
                    "update_time": "2018-03-27 13:27:07",
                    "update_by": {
                        "uid": "0000000000000101",
                        "code": "U4219695",
                        "username": "admin@cw",
                        "nickname": "系统内建财务员",
                        "realname": "系统内建财务员"
                    },
                    "status": 1,
                    "bandel": 0,
                    "name": "部管",
                    "description": "天天向上默认部门财务部管理员",
                    "dpinfo": {
                        "id": 45,
                        "dp_type": 3,
                        "dp_id": "05d48fa8743570b0",
                        "pid": 0,
                        "status": 1,
                        "bandel": 0,
                        "create_time": "2018-03-27 13:27:07",
                        "create_by": "0000000000000101",
                        "update_time": "2018-03-27 13:27:07",
                        "update_by": "0000000000000101",
                        "name": "财务部",
                        "description": "天天向上机构财务部门"
                    }
                },
                {
                    "id": 52,
                    "dpmt_id": 46,
                    "create_time": "2018-03-27 13:27:07",
                    "create_by": {
                        "uid": "0000000000000101",
                        "code": "U4219695",
                        "username": "admin@cw",
                        "nickname": "系统内建财务员",
                        "realname": "系统内建财务员"
                    },
                    "update_time": "2018-03-27 13:27:07",
                    "update_by": {
                        "uid": "0000000000000101",
                        "code": "U4219695",
                        "username": "admin@cw",
                        "nickname": "系统内建财务员",
                        "realname": "系统内建财务员"
                    },
                    "status": 1,
                    "bandel": 0,
                    "name": "部管",
                    "description": "天天向上默认部门运营部管理员",
                    "dpinfo": {
                        "id": 46,
                        "dp_type": 3,
                        "dp_id": "05d48fa8743570b0",
                        "pid": 0,
                        "status": 1,
                        "bandel": 0,
                        "create_time": "2018-03-27 13:27:07",
                        "create_by": "0000000000000101",
                        "update_time": "2018-03-27 13:27:07",
                        "update_by": "0000000000000101",
                        "name": "运营部",
                        "description": "天天向上机构运营部门"
                    }
                }
            ]
        }
    } 
    
本书创建于 2018-03-30 12:03:13 ?如有疑问,请联系技术人员