郑州烟草研究院统一认证平台对接规范 郑州烟草研究院统一认证平台对接规范
首页
  • 介绍

    • 关于
  • 如何接入

    • 开始
    • 订阅注册
    • 拉取机构
    • 拉取用户
    • 常见问题
  • 单点登录

    • 介绍
    • jssdk接入
    • JavaSdk接入
    • 自行接入
    • 常见问题
  • 单点退出

    • 01退出登录
  • 统一通知
  • 信息发布
  • 统一检索
  • 统一待办
首页
  • 介绍

    • 关于
  • 如何接入

    • 开始
    • 订阅注册
    • 拉取机构
    • 拉取用户
    • 常见问题
  • 单点登录

    • 介绍
    • jssdk接入
    • JavaSdk接入
    • 自行接入
    • 常见问题
  • 单点退出

    • 01退出登录
  • 统一通知
  • 信息发布
  • 统一检索
  • 统一待办
  • 介绍

  • 如何接入

    • 快速开始
    • 订阅注册
    • 拉取机构
    • 拉取用户
      • 常见问题
    目录

    拉取用户

    # 开始

    跟拉取机构一样的

    提示

    《ip》 在 以下内容中代表的意思为 http://ip:port/urm/pull 例如: http://10.6.0.108/api/urm/pull

    # 1、获取签名

    跟拉取机构的获取签名是一个方法,可以共用

    请求URL

    《ip》/getAppSign

    请求类型

    POST

    请求参数

    属性 类型 描述
    appId String 资源服务中注册的唯一应用id
    appSecret String 注册时的密钥

    返回值

    属性 类型 描述
    code int 状态码 成功200 失败500
    msg String 返回的消息,失败时传递失败原因
    data Object 响应体,返回的是appSign字符串,后续调用使用

    示例

    {
      "msg": "获取成功",
      "code": 200,
      "data": "2c6f49f6f9bc7a55571d77d29d222afa"
    }
    
    1
    2
    3
    4
    5

    # 2、拉取所有用户

    调用服务之前需要获取签名信息,后续请求中在header头中需要传递该签名信息。

    请求URL

    《ip》/pullAllUser

    请求类型

    GET

    请求头

    属性 类型 描述
    appSign String 是上面获取的签名值

    请求参数

    属性 类型 描述
    appId String 资源服务中注册的唯一应用id

    返回值

    属性 类型 描述
    code int 状态码 成功200 失败500
    msg String 返回的消息,失败时传递失败原因
    data Object 响应体,返回的是用户的list列表数据,包含部门信息

    示例

    {
      "msg": "获取成功",
      "code": 200,
      "data": [
        {
          "address": "办公室",
          "birthDate": null,
          "createDate": "2023-11-28 14:58:43",
          "createId": "1",
          "createName": "超级管理员",
          "departId": "1916374976559566849",
          "departOrg": null,
          "email": "xxx@163.com",
          "extData": null,
          "id": "1916375340969086982",
          "idCard": null,
          "isDel": 0,
          "mobilePhone": "13837823297",
          "page": 1,
          "password": null,
          "poolDepartId": "1916374976559566849",
          "poolId": "1916374866274537474",
          "realName": "侯玉国",
          "remark": null,
          "rows": 10,
          "secretLevel": null,
          "sectionAddr": "办公室",
          "sex": "男",
          "shortNo": null,
          "sourceUserId": "1729394371170484225",
          "status": "0",
          "updateDate": "2023-11-28 15:10:30",
          "updateId": "1",
          "updateName": "超级管理员",
          "userName": "13837823297",
          "userOrder": null,
          "userType": "0",
          "workPost": null,
          "workTel": null
        },{
          "address": null,
          "birthDate": "2025-04-14",
          "createDate": "2025-04-14 14:17:55",
          "createId": "3",
          "createName": "赵鹏飞",
          "departId": "1916374976559566849",
          "departOrg": null,
          "email": "111",
          "extData": null,
          "id": "1916375340969086988",
          "idCard": null,
          "isDel": 0,
          "mobilePhone": "13213211231",
          "page": 1,
          "password": null,
          "poolDepartId": "1916374976559566849",
          "poolId": "1916374866274537474",
          "realName": "赵鹏飞",
          "remark": null,
          "rows": 10,
          "secretLevel": "0",
          "sectionAddr": "111",
          "sex": "0",
          "shortNo": null,
          "sourceUserId": "1911665199142854658",
          "status": null,
          "updateDate": "2025-04-15 08:57:01",
          "updateId": "3",
          "updateName": "赵鹏飞",
          "userName": "zhaopengfei",
          "userOrder": null,
          "userType": null,
          "workPost": "2",
          "workTel": "111"
        },{
          "address": "局领导",
          "birthDate": null,
          "createDate": "2023-11-28 14:58:42",
          "createId": "1",
          "createName": "超级管理员",
          "departId": "1916374976559566849",
          "departOrg": null,
          "email": "xxx@163.com",
          "extData": null,
          "id": "1916375340969086981",
          "idCard": null,
          "isDel": 0,
          "mobilePhone": "13837131267",
          "page": 1,
          "password": null,
          "poolDepartId": "1916374976559566849",
          "poolId": "1916374866274537474",
          "realName": "曹建广",
          "remark": null,
          "rows": 10,
          "secretLevel": null,
          "sectionAddr": "局领导",
          "sex": "男",
          "shortNo": null,
          "sourceUserId": "1729394369400487937",
          "status": "0",
          "updateDate": "2023-11-28 15:10:31",
          "updateId": "1",
          "updateName": "超级管理员",
          "userName": "13837131267",
          "userOrder": null,
          "userType": "0",
          "workPost": null,
          "workTel": null
        }
      ]
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97
    98
    99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112

    # 3、拉取某个部门下的用户

    调用服务之前需要获取签名信息,后续请求中在header头中需要传递该签名信息。

    请求URL

    《ip》/pullUserByDepId

    请求类型

    POST 请求头

    属性 类型 描述
    appSign String 是上面获取的签名值

    请求参数

    属性 类型 描述
    appId String 资源服务中注册的唯一应用id
    depId String 部门id

    返回值

    属性 类型 描述
    code int 状态码 成功200 失败500
    msg String 返回的消息,失败时传递失败原因
    data Object 响应体,返回用户列表数据

    示例

    {
      "msg": "获取成功",
      "code": 200,
      "data": [
        {
          "address": "办公室",
          "birthDate": null,
          "createDate": "2023-11-28 14:58:43",
          "createId": "1",
          "createName": "超级管理员",
          "departId": "1916374976559566849",
          "departOrg": null,
          "email": "xxx@163.com",
          "extData": null,
          "id": "1916375340969086982",
          "idCard": null,
          "isDel": 0,
          "mobilePhone": "13837823297",
          "page": 1,
          "password": null,
          "poolDepartId": "1916374976559566849",
          "poolId": "1916374866274537474",
          "realName": "侯玉国",
          "remark": null,
          "rows": 10,
          "secretLevel": null,
          "sectionAddr": "办公室",
          "sex": "男",
          "shortNo": null,
          "sourceUserId": "1729394371170484225",
          "status": "0",
          "updateDate": "2023-11-28 15:10:30",
          "updateId": "1",
          "updateName": "超级管理员",
          "userName": "13837823297",
          "userOrder": null,
          "userType": "0",
          "workPost": null,
          "workTel": null
        },{
          "address": null,
          "birthDate": "2025-04-14",
          "createDate": "2025-04-14 14:17:55",
          "createId": "3",
          "createName": "赵鹏飞",
          "departId": "1916374976559566849",
          "departOrg": null,
          "email": "111",
          "extData": null,
          "id": "1916375340969086988",
          "idCard": null,
          "isDel": 0,
          "mobilePhone": "13213211231",
          "page": 1,
          "password": null,
          "poolDepartId": "1916374976559566849",
          "poolId": "1916374866274537474",
          "realName": "赵鹏飞",
          "remark": null,
          "rows": 10,
          "secretLevel": "0",
          "sectionAddr": "111",
          "sex": "0",
          "shortNo": null,
          "sourceUserId": "1911665199142854658",
          "status": null,
          "updateDate": "2025-04-15 08:57:01",
          "updateId": "3",
          "updateName": "赵鹏飞",
          "userName": "zhaopengfei",
          "userOrder": null,
          "userType": null,
          "workPost": "2",
          "workTel": "111"
        },{
          "address": "局领导",
          "birthDate": null,
          "createDate": "2023-11-28 14:58:42",
          "createId": "1",
          "createName": "超级管理员",
          "departId": "1916374976559566849",
          "departOrg": null,
          "email": "xxx@163.com",
          "extData": null,
          "id": "1916375340969086981",
          "idCard": null,
          "isDel": 0,
          "mobilePhone": "13837131267",
          "page": 1,
          "password": null,
          "poolDepartId": "1916374976559566849",
          "poolId": "1916374866274537474",
          "realName": "曹建广",
          "remark": null,
          "rows": 10,
          "secretLevel": null,
          "sectionAddr": "局领导",
          "sex": "男",
          "shortNo": null,
          "sourceUserId": "1729394369400487937",
          "status": "0",
          "updateDate": "2023-11-28 15:10:31",
          "updateId": "1",
          "updateName": "超级管理员",
          "userName": "13837131267",
          "userOrder": null,
          "userType": "0",
          "workPost": null,
          "workTel": null
        }
      ]
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97
    98
    99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112

    # 4、拉取某个用户详情

    调用服务之前需要获取签名信息,后续请求中在header头中需要传递该签名信息。

    请求URL

    《ip》/pullUserById

    请求类型

    POST 请求头

    属性 类型 描述
    appSign String 是上面获取的签名值

    请求参数

    属性 类型 描述
    appId String 资源服务中注册的唯一应用id
    userId String 用户的id

    返回值

    属性 类型 描述
    code int 状态码 成功200 失败500
    msg String 返回的消息,失败时传递失败原因
    data Object 响应体,用户的实体信息

    示例

    {
      "msg": "获取成功",
      "code": 200,
      "data": {
        "address": null,
        "birthDate": "2025-04-14",
        "createDate": "2025-04-14 14:17:55",
        "createId": "3",
        "createName": "赵鹏飞",
        "departId": null,
        "departOrg": null,
        "email": "111",
        "extData": null,
        "id": "1916375340969086988",
        "idCard": null,
        "isDel": 0,
        "mobilePhone": "13213211231",
        "page": 1,
        "password": null,
        "poolDepartId": "1916374976559566849",
        "poolId": "1916374866274537474",
        "realName": "赵鹏飞",
        "remark": null,
        "rows": 10,
        "secretLevel": "0",
        "sectionAddr": "111",
        "sex": "0",
        "shortNo": null,
        "sourceUserId": "1911665199142854658",
        "status": null,
        "updateDate": "2025-04-15 08:57:01",
        "updateId": "3",
        "updateName": "赵鹏飞",
        "userName": "zhaopengfei",
        "userOrder": null,
        "userType": null,
        "workPost": "2",
        "workTel": "111"
      }
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40

    # 5、部门的返回值信息代表的含义

    
        @ApiModelProperty(value="资源池id")
        private String poolId;
    
        @ApiModelProperty(value = "用户名")
        private String userName;
    
    
        @ApiModelProperty(value = "密码")
        private String password;
    
        @TableField("REAL_NAME")
        @ApiModelProperty(value = "真实姓名")
        private String realName;
    
        @TableField("SEX")
        @ApiModelProperty(value = "性别")
        private String sex;
    
        @TableField("BIRTH_DATE")
        @ApiModelProperty(value = "出生日期")
    
        @ApiModelProperty(value = "电话")
        private String mobilePhone;
        @ApiModelProperty(value = "地址")
        private String address;
    
        @ApiModelProperty(value = "邮箱")
        private String email;
    
        @ApiModelProperty(value = "用户类型")
        private String userType;
    
        @ApiModelProperty(value = "状态")
        private String status;
    
        @ApiModelProperty(value = "办公地点")
        private String sectionAddr;
    
     
        @ApiModelProperty(value = "办公室电话")
        private String workTel;
    
    
        @ApiModelProperty(value = "职务")
        private String workPost;
    
        @ApiModelProperty(value = "排序")
        private String userOrder;
    
    
        @ApiModelProperty(value = "身份证号")
        private String idCard;
    
    
        @ApiModelProperty(value = "涉密等级:0:非密:1:一般、2:重要、3:核心")
        private String secretLevel;
    
    
        @ApiModelProperty(value = "短号,个人私密号码")
        private String shortNo;
    
    
        @ApiModelProperty(value = "原用户ID")
        private String sourceUserId;
    
        /**
         * 扩展字段,以key-value格式记录,如:{key1:value1,key2:value2}
         */
    
        private String extData;
    
        /**
         * 所在部门id
         */
        @TableField(exist = false)
        private String departId;
        /**
         * 所在部门标识
         */
        @TableField(exist = false)
        private String departOrg;
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    拉取机构
    常见问题

    ← 拉取机构 常见问题→

    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式