[关闭]
@yiranblade 2017-05-27T02:32:01.000000Z 字数 3443 阅读 345

TTMS(Web)后端接口文档

API文档


用户信息接口详情

/user/delete/{id}


删除对应用户信息

是否需要权限验证

请求参数

必选 类型 说明
id String 对应用户id
请求方法

GET

调用样例

/delete/214

返回结果

* JSON示例 *

` ``

删除成功

` ``

* 错误返回值 *

删除失败


/user/login


验证用户并获取其相关数据

是否需要权限验证

请求参数

必选 类型 说明
username String 用户登录名称,只有登录后方可访问其他接口
userpassword String
请求方法

POST

调用样例

/user/login
username:yiranblade
userpassword:123456

返回结果

* JSON示例 *

``
{
"data": {
"user_position": 0,
"user_password": "123456",
"user_id": 1,
"user_image": null,
"user_name": "yiranblade"
},
"code": 200
}
``

* 错误返回值 *

{
"data": "账户名或密码错误",
"code": 500
}


/doUpload


上传文件

是否需要权限验证

请求参数

必选 类型 说明
file MultipartFile 需要上传文件
请求方法

POST

调用样例

/doUpload

返回结果

* JSON示例 *

` ``
文件上传成功

` ``

* 错误返回值 *

文件上传失败


/user/add


添加用户

是否需要权限验证

请求参数

必选 类型 说明
user User 程序自动获取
请求方法

POST

调用样例

JSON示例
{
"user_name":"喵帕斯",
"user_position":"0",
"user_password":"123456"
}

返回结果

* JSON示例 *

` ``
{
"data": "添加成功",
"code": 200
}

` ``

* 错误返回值 *

添加失败


/user/update


更新用户信息

是否需要权限验证

请求参数

必选 类型 说明
user User 自动获取
请求方法

POST

调用样例

JSON示例
{
"user_id":"1",
"user_name":"lft",
"user_position":"0",
"user_password":"123456"
}

返回结果

* JSON示例 *

` ``
{
"data": "更新成功",
"code": 200
}

` ``

* 错误返回值 *

更新失败


/user/find/


查找所有用户信息

是否需要权限验证

请求参数
必选 类型 说明
自动获取
请求方法

GET

调用样例

http://www.xxx.com/ttms_web/user/find/

返回结果

JSON示例
{
"data": [
{
"user_position": 0,
"user_password": "123456",
"user_id": 1,
"user_image": null,
"user_name": "lft"
},
{
"user_position": 0,
"user_password": "123456",
"user_id": 2,
"user_image": null,
"user_name": "喵帕斯"
}
],
"code": 200
}

* 错误返回值 *
查找错误


/user/find/


按页查找所有用户信息

是否需要权限验证

请求参数
必选 类型 说明
page String 第几页
per_page String 每页显示数目
请求方法

GET

调用样例

http://localhost:8080/ttms_web/user/find/1/2

返回结果

JSON示例
{
"data": [
{
"user_position": 0,
"user_password": "123456",
"user_id": 1,
"user_image": null,
"user_name": "lft"
},
{
"user_position": 0,
"user_password": "123456",
"user_id": 2,
"user_image": null,
"user_name": "喵帕斯"
}
],
"code": 200
}

* 错误返回值 *
查找错误

演出厅管理接口详情

/studio/add


增添新的演出厅

是否需要权限验证

请求参数

必选 类型 说明
studio Studio 对应用户id
请求方法

POST

调用样例

JSON示例
{
"studio_area":"200cm2",
"studio_seat_row":"2",
"studio_seat_colu":"3"
}

返回结果

* JSON示例 *
{
"data": "添加成功",
"code": 200
}
` ``

* 错误返回值 *

添加发生未知错误


/studio/delete


删除演出厅

是否需要权限验证

请求参数

必选 类型 说明
id String 对应演出厅id
请求方法

GET

调用样例

http://localhost:8080/ttms_web/studio/delete/3

返回结果

{
"data": "添加成功",
"code": 200
}

* 错误返回值 *

* JSON示例 *
{
"data": "删除成功",
"code": 400
}


/studio/update


更新演出厅信息

是否需要权限验证

请求参数

必选 类型 说明
studio Studio 对应演出厅id
请求方法

POST

调用样例

{
"Studio_id":"1",
"Studio_area":"200cm2",
"Studio_seat_row":"1",
"Studio_seat_colu":"2"
}

返回结果

{
"data": "更新成功",
"code": 200
}

* 错误返回值 *

* JSON示例 *
{
"data": "更新发生未知错误",
"code": 400
}


/studio/all


获取全部演出厅信息

是否需要权限验证

请求参数

必选 类型 说明
请求方法

GET

调用样例

http://localhost:8080/ttms_web/studio/all

返回结果

{
"data": [
{
"studio_seat_row": 0,
"studio_id": 0,
"studio_seat_colu": 0,
"seats": [],
"studio_area": null
},
{
"studio_seat_row": 0,
"studio_id": 1,
"studio_seat_colu": 0,
"seats": [],
"studio_area": null
}
],
"code": 200
}

* 错误返回值 *

* JSON示例 *
{
"data": "获取发生未知错误",
"code": 400
}

座位管理接口详情

/seat/delete


删除某个座位

是否需要权限验证

请求参数

必选 类型 说明
id String
请求方法

GET

调用样例

http://localhost:8080/ttms_web/seat/delete/1

返回结果

{
"data": "删除成功",
"code": 200
}


/seat/set


设置多个座位为已卖出

是否需要权限验证

请求参数

必选 类型 说明
ids List
请求方法

POST

调用样例

[

    "2",
    "3"

]
返回结果

{
"data": "设置成功",
"code": 200
}

* 错误返回值 *

* JSON示例 *
{
"data": "设置发生未知错误",
"code": 400
}


/seat/get/


通过演出厅获取座位

是否需要权限验证

请求参数

必选 类型 说明
id String
请求方法

GET

调用样例

http://localhost:8080/ttms_web/get/1

返回结果

{
"data": [
{
"studio_seat_row": "2",
"studio_id": 1,
"studio_seat_colu": "2",
"seats": [
{
"col": 1,
"is_sell": false,
"row": 1,
"seat_id": 1,
"seat_status": true
},
{
"col": 2,
"is_sell": false,
"row": 1,
"seat_id": 2,
"seat_status": true
},
{
"col": 1,
"is_sell": false,
"row": 2,
"seat_id": 3,
"seat_status": true
},
{
"col": 2,
"is_sell": false,
"row": 2,
"seat_id": 4,
"seat_status": true
}
],
"studio_area": "100cm2"
}
],
"code": 200
}

* 错误返回值 *

* JSON示例 *
{
"data": "查找发生未知错误",
"code": 400
}

ErrorCode

错误代码对照表


系统级错误

错误代码 返回msg 详细描述
500 系统错误,请稍候再试 服务器错误
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注