-
Notifications
You must be signed in to change notification settings - Fork 9
15. 账单
Vizards edited this page Mar 15, 2019
·
1 revision
查询消费/充值统计信息和账单,支持按类别和天数查询
POST /api/living/bill
参数 | 类型 | 必需 | 描述 | 示例 |
---|---|---|---|---|
Content-Type |
string | 是 | application/json |
application/json |
Accept |
string | 是 | application/json |
application/json |
Authorization |
string | 是 | Bearer Token | Bearer [Your Token] |
参数 | 类型 | 必需 | 描述 | 示例 |
---|---|---|---|---|
day |
number | 是 | 要查询的账单天数,可为 7 或 30 或 90 或 180
|
30 |
type |
string | 是 | 要查询的交易类型,可为:all :全部 cost :消费charge :充值electricity :电费充值 |
cost |
status: 200 OK
{
"code": 201,
"data": {
"total_cost": 0.12,
"total_charge": 20,
"history": [
{
"time": "2019-03-01 13:35:29",
"device": "电费充值",
"transaction": "+220",
"roomId": 110110
},
{
"time": "2019-02-27 10:29:05",
"device": "文印中心POS07",
"transaction": "-0.12",
"balance": 4.82
}
]
},
"time": "2019-03-02T17:25:01Z",
"msg": "Post Success"
}
参数名 | 描述 | 类型 |
---|---|---|
data.total_cost |
总消费金额(¥) | Number |
data.total_charge |
总充值金额(¥) | Nuumber |
data.history |
消费/充值数据数组 | Array |
data.history[i].time |
消费/充值时间 | String |
data.history[i].device |
此次余额变化发生设备 | String |
data.history[i].transaction |
余额变化情况 | String |
data.history[i].balance |
消费/充值后余额 | String |
data.history[i].roomId |
电费充值宿舍房间号 | Number |
data.history[i]
的 key
并不是固定的:
- 一卡通充值、消费历史中,存在
balance
键,表示消费/充值后一卡通的余额 - 电费充值历史中,
balance
变为roomId
,表示此次充值的宿舍房间号
UESTC-API 已经取消提供公共 API 服务器,开发者需要将应用部署到自己的服务器上
https://uestc.ml 现在仅提供 11 个 Extra API 的转发服务,且不保证此服务的可用性
我们提供了方便的 Docker 化部署方案,在方便开发者实现后端数据管控的同时帮助我们应对日益严峻的教务系统 IP 封禁策略,感谢配合