API中心服务端API房间管理

房间管理

创建VR/AR房间

请求地址: https://app.3dcat.live/api/3dcat/application/room

请求方法： post

请求参数:

字段名	类型	是否必填	说明
password	String	否	房间密码(如果房间是私有密码必传)
des	String	否	房间描述
type	int	是	房间类型 1:VR 2:AR
name	String	是	房间名称
isSecret	Integer	是	0公开房间 1私密房间

返回结果:

返回内容示例:

{
    "version": "1.0.0",
    "result": true,
    "message": "success",
    "code": 200,
    "data": null,
    "serverTime": 1638839659119,
    "requestId": "8e1d1a6bb19785fd"
}

更新房间

请求地址:https://app.3dcat.live/api/3dcat/application/room

请求方法： put

请求参数:

字段名	类型	是否必填	说明
id	Long	是	房间id

返回结果:

返回内容示例:

{
    "version": "1.0.0",
    "result": true,
    "message": "success",
    "code": 200,
    "data": null,
    "serverTime": 1638786940848,
    "requestId": "8d166d19b159d60a"
}

查询房间列表

请求地址:https://app.3dcat.live/api/3dcat/application/room

请求方法： get

请求参数:

字段名	类型	是否必填	说明
current	int	是	当前页(从1开始)
size	int	是	一页数量
roomName	int	否	房间名称(模糊查询)

返回结果:

字段名	类型	说明
current	int	当前页
size	int	一页数量
total	int	查询总数
records	List	房间列表

房间

字段名	类型	说明
id	Long	房间Id
des	String	房间描述
name	String	房间名称
isSecret	int	0公开房间 1私密房间
type	int	1 VR 2 AR
userId	Long	用户id
createTime	Date	创建时间
updateTime	Date	更新时间

返回内容示例:

{
    "version": "1.0.0",
    "result": true,
    "message": "success",
    "code": 200,
    "data": {
        "records": [
            {
                "id": 1219,
                "des": "",
                "name": "3dcat12.6",
                "isSecret": 0,
                "type": 1,
                "userId": 3681,
                "createTime": "2021-12-06T18:35:40.844",
                "updateTime": "2021-12-07T09:33:57.258"
            },
            {
                "id": 1214,
                "des": "",
                "name": "431241",
                "isSecret": 1,
                "type": 1,
                "userId": 3681,
                "createTime": "2021-11-15T11:50:08.528",
                "updateTime": "2021-12-06T18:12:08.209"
            }
        ],
        "total": 2,
        "size": 10,
        "current": 1,
        "orders": [],
        "searchCount": true,
        "pages": 1
    },
    "serverTime": 1638841607599,
    "requestId": "9dad43691742bd15"
}

删除房间

请求地址: https://app.3dcat.live/api/3dcat/application/room/{id}

请求方法： delete

请求参数:

返回结果:

返回内容示例:

{
    "version": "1.0.0",
    "result": true,
    "message": "success",
    "code": 200,
    "data": null,
    "serverTime": 1638780517915,
    "requestId": "afb160eb550df07b"
}

获取房间列表(不分页)

请求地址: https://app.3dcat.live/api/3dcat/application/room/all

请求方法： get

请求参数:

返回结果:

字段名	类型	说明

房间

字段名	类型	说明
id	Long	房间Id
des	String	房间描述
name	String	房间名称
isSecret	int	0公开房间 1私密房间
type	int	1 VR 2 AR
userId	Long	用户id
createTime	Date	创建时间
updateTime	Date	更新时间

返回内容示例:

{
    "version": "1.0.0",
    "result": true,
    "message": "success",
    "code": 200,
    "data": [
        {
            "id": 1214,
            "des": "",
            "name": "431241",
            "isSecret": 1,
            "type": 1,
            "userId": 3681,
            "createTime": "2021-11-15T11:50:08.528",
            "updateTime": "2021-12-06T18:12:08.209"
        },
        {
            "id": 1219,
            "des": "",
            "name": "3dcat12.6",
            "isSecret": 0,
            "type": 1,
            "userId": 3681,
            "createTime": "2021-12-06T18:35:40.844",
            "updateTime": "2021-12-07T09:33:57.258"
        }
    ],
    "serverTime": 1638841651212,
    "requestId": "af1ae89cb82bfa6e"
}

获取房间详情

请求地址: https://app.3dcat.live/api/3dcat/application/room/id

请求方法： get

请求参数:

字段名	类型	是否必填	说明
id	Long	是	房间类型

返回结果:

字段名	类型	说明
id	Long	房间Id
password	String	私有密码
des	String	房间描述
name	String	房间名称
isSecret	int	0公开房间 1私密房间
userId	Long	用户id
isDelete	Integer	是否删除
createTime	Date	创建时间
updateTime	Date	更新时间
type	int	1 VR 2 AR

返回内容示例:

{
    "version": "1.0.0",
    "result": true,
    "message": "success",
    "code": 200,
    "data": {
        "id": 1219,
        "password": null,
        "des": "",
        "name": "3dcat12.6",
        "isSecret": 0,
        "userId": 3681,
        "isDelete": 0,
        "createTime": "2021-12-06T18:35:40.844",
        "updateTime": "2021-12-07T09:33:57.258",
        "type": 1
    },
    "serverTime": 1638841811546,
    "requestId": "f1f504f9afba03a3"
}