SIT-kite#kite-server#消费查询1

## 概念 消费查询包括**校园卡消费**与**宿舍电费**查询。 操作的资源主要有： - /pay/room/{*roomId*} 查询电费余额 - /pay/room/*{roomId}*/rank 查询最近24小时电费用量排名 - /pay/room/{*roomId*}/bill/days 按日进行用电统计 - /pay/room/{*roomId*}/bill/hours 查询最近一天的逐小时用电情况 ## 接口 ### [GET] /pay/room/{*roomId*} 查询房间电费余额（仅支持奉贤校区）。 房间 ID 的计算规则是由电费查询系统规定的。格式为 “10” + 楼号 + 寝室号，如果遇到仅为个位的楼号，不补零。例如，对于1号楼101寝室，对应的房间 ID 为 `101101`。 余额更新可能有延迟，详见校内 OA [相关页面](card.sit.edu.cn)。 #### 权限 普通用户。 #### 参数 | 参数 | 类型 | 必填 | 释义 | 合法值 | | ------ | ------ | ---- | ------ | ------ | | roomId | string | 是 | 房间号 | | #### 响应示例 ```json { "code": 0, "msg": "OK", "data": { "event_id": 12 } } ``` ### [GET] /pay/room/{*roomId*}/rank 查询房间用电量排行 #### 权限 普通用户。 #### 参数 | 参数 | 类型 | 必填 | 释义 | 合法值 | | ------ | ------ | ---- | ------ | ------ | | roomId | string | 是 | 房间号 | | #### 响应示例 ```json { "code": 0, "data": { "consumption": 3.2330008, "rank": 1788, "room_count": 4564 } } ``` ### [GET] /pay/room/{*roomId*}/bill/days 按日进行用电统计，所得数值均为正数。 #### 权限 普通用户。 #### 参数 | 参数 | 类型 | 必填 | 释义 | 合法值 | | ------ | ------ | ---- | ------ | ------ | | roomId | string | 是 | 房间号 | | |