Browse Source

[u] 1.增加获取单个奖品信息的接口/award;2.简单接口修改为get形式

master
luoning 8 years ago
parent
commit
254d85223c
  1. 19
      doc/README.md

19
doc/README.md

@ -1,16 +1,17 @@ @@ -1,16 +1,17 @@
## 接口
| 接口名 | 请求方法 | 参数 | 返回值 | 备注 |
| --------------- | -------- | ---------------------------------------- | ---------------------------------------- | -------------------------------- |
| --------------- | -------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------- |
| /index | GET | | | |
| /run | POST | {"award_id":int} | {"status": 200, "msg": "success", "data": None} | 开始抽奖,进入抽奖状态 |
| /draw_lottery | GET | | {"status": 200, "msg": "success", "data": [{"uid":uid, "name":name, "award_id":award_id}]} | 获取抽奖结果,仅当抽奖状态才可调用此接口 |
| /run | GET | award_id=int | {"status": 200, "msg": "success", "data": None} | 开始抽奖,进入抽奖状态 |
| /draw_lottery | GET | | {"status": 200, "msg": "success", "data": [{"uid":uid, "name":name, "award_id":award_id, "role":role}]} | 获取抽奖结果,仅当抽奖状态才可调用此接口 |
| ~~/update~~ | ~~POST~~ | ~~[{"uid":string, "awards_id":int}]~~ | | ~~提交中奖用户~~ |
| /revoke | POST | {"uid":string} | {"status": 200, "msg": "success", "data": None} | 取消用户中奖信息,uid为工号,例如G0001 |
| /lucky_users | GET/POST | {"award_id":int} | {"status": 200, "msg": "success", "data": {award_id:[{"uid":uid, "name":name}]}} | 获取所有中奖用户列表,使用post方式获取指定奖项的中奖用户列表 |
| /users | GET | | {"status": 200, "msg": "success", "data": [{"uid":uid, "name":name}]} | 获取所有用户列表 |
| /luckless_users | GET | | {"status": 200, "msg": "success", "data": [{"uid":uid, "name":name}]} | 获取未中奖用户列表 |
| /add_awards | POST | [{"award_id":int, "award_name":string,"award_capacity":int}] | {"status": 200, "msg": "success", "data": None} | 添加新奖品 |
| /awards | GET | | {"status": 200, "msg": "success", "data": [{"award_id":award_id, "award_name":award_name}]} | 获取所有奖项列表 |
| /revoke | GET | uid=string | {"status": 200, "msg": "success", "data": None} | 取消用户中奖信息,uid为工号,例如G0001 |
| /lucky_users | GET | award_id=int | {"status": 200, "msg": "success", "data": {award_id:[{"uid":uid, "name":name, "role":role}]}} | 获取所有中奖用户列表,传入award_id获取指定奖项的中奖用户列表 |
| /users | GET | | {"status": 200, "msg": "success", "data": [{"uid":uid, "name":name, "role":role}]} | 获取所有用户列表 |
| /luckless_users | GET | | {"status": 200, "msg": "success", "data": [{"uid":uid, "name":name, "role":role}]} | 获取未中奖用户列表 |
| /add_awards | POST | [{"award_name":string, "award_capacity":int}] | {"status": 200, "msg": "success", "data": None} | 添加新奖品 |
| /award | GET | award_id=int | {"status": 200, "msg": "success", "data": {"award_id":award_id, "award_name":award_name, "award_capacity":award_capacity}} | 获取指定奖项信息 |
| /awards | GET | | {"status": 200, "msg": "success", "data": [{"award_id":award_id, "award_name":award_name, "award_capacity":award_capacity}]} | 获取所有奖项列表 |
| /reset | GET | | {"status": 200, "msg": "success", "data": None} | 重置所有数据 |
---

Loading…
Cancel
Save