# 用户、权限接口文档 ## 用户登录接口 > URI: /service-user/login > > METHOD: POST > > CONTENT-TYPE: JSON | 参数 | 数据类型 | 必填 | 备注 | | -------- | ------ | ---- | ---- | | username | String | true | 用户名 | | password | String | true | 密码 | > RETURN: 令牌字符串 > > EXAMPLE: > ``` > eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0Iiwicm9sZXMiOiJVU0VSIiwiZXhwIjoxNTE4MDU0Mzk1fQ.jDXfmpc4UMvJH_888XJveSqM7_iLAp4ukisvAXZ9vb2_zngqVicnbJa2hNXKls0p4mIVbOLfwHttoaxpNHyWvQ > ``` ## 获取用户信息接口 > URI: /service-user/user > > METHOD: GET > > CONTENT-TYPE: Query string | 参数 | 数据类型 | 必填 | 备注 | | -------- | ------ | ---- | ---- | | username | String | true | 用户名 | > RETURN: 用户对象 > > EXAMPLE: > > ```json > { > "id": 1, > "username":"test", > "role": "ADMIN", > "org": 1 > } > ``` ## 获取权限列表接口 > URI: /service-user/user/permissions > > METHOD: GET > > CONTENT-TYPE: Query string | 参数 | 数据类型 | 必填 | 备注 | | -------- | ------ | ---- | ---- | | username | String | true | 用户名 | > RETURN: 用户对象 > > EXAMPLE: > > ```json > [{ > "id": 1, > "name":"获取权限列表", > "url": "/service-user/user/permissions" > },{ > "id": 2, > "name":"获取权限组", > "url": "/service-user/user/permissionGroups" > }] > ``` ## 获取权限组接口 > URI: /service-user/user/permissionGroups > > METHOD: GET > > CONTENT-TYPE: Query string | 参数 | 数据类型 | 必填 | 备注 | | -------- | ------ | ---- | ---- | | username | String | true | 用户名 | > RETURN: 用户对象 > > EXAMPLE: > > ```json > [{ > "id": 1, > "name":"用户管理" > },{ > "id": 2, > "name":"门店管理" > }] > ``` > ## 新建用户接口 > URI: /service-user/user/createUser > > METHOD: POST > > CONTENT-TYPE: JSON | 参数 | 数据类型 | 必填 | 备注 | | -------- | ------- | ----- | ------------------ | | username | String | true | 用户名 | | password | String | true | 密码 | | role | String | true | 角色(超管、集团管理、门店管理) | | org | Integer | false | 所属集团ID(超管不需要填写此字段) | > RETURN: 新建记录行数 > > EXAMPLE: > > ``` > 1 > ``` ## 修改密码接口 > URI: /service-user/user/changePassword > > METHOD: POST > > CONTENT-TYPE: JSON | 参数 | 数据类型 | 必填 | 备注 | | ----------- | ------ | ---- | ---- | | username | String | true | 用户名 | | oldPassword | String | true | 旧密码 | | newPassword | String | true | 新密码 | > RETURN: 修改记录行数 > > EXAMPLE: > > ``` > 1 > ``` ## 为用户增加权限组接口 > URI: /service-user/user/addUserPermissionGroup > > METHOD: POST > > CONTENT-TYPE: JSON | 参数 | 数据类型 | 必填 | 备注 | | ----------------- | ------- | ---- | ----- | | userId | Integer | true | 用户ID | | permissionGroupId | Integer | true | 权限组ID | > RETURN: 修改记录行数 > > EXAMPLE: > > ``` > 1 > ``` ## 为用户移除权限组接口 > URI: /service-user/user/removeUserPermissionGroup > > METHOD: POST > > CONTENT-TYPE: JSON | 参数 | 数据类型 | 必填 | 备注 | | ----------------- | ------- | ---- | ----- | | userId | Integer | true | 用户ID | | permissionGroupId | Integer | true | 权限组ID | > RETURN: 修改记录行数 > > EXAMPLE: > > ``` > 1 > ```