EVA-Notify/doc/api.md

接口文档

基本格式

成功响应格式

{
  "success": true,
  "data": {
    "foo": "bar"
  }
}

NOTE: 若无特殊说明，POST请求的响应data字段为空({})，可以不用管。

失败响应格式

{
  "success": false,
  "err": "some error"
}

GET请求默认格式（若无特殊说明）

{
  "token": "token_test"
}

主页面

值班信息 GET /duty/info

当前在值班

data:

{
  "isInDuty": true,
  "inDutyCnt": 3,
  "currentDuty": "2",
  "place": "东三-204"
}

当前未值班

data:

{
  "isInDuty": false,
  "offDutyReason": "学园维修",
  "dutyRecoverTime": "下周一"
}

用户页面

个人信息 GET /user/info

data:

{
  "name": "马保国",
  "phone": "13333333333"
}

修改个人信息 POST /user/update

Request body:

{
  "name": "宇航员",
  "phone": "1233333210"
}

本地化设置

获取本地化设置 GET /user/locale/get

data:

{
  "lang": "zh_CN"
}

更新本地化设置 POST /user/locale/update

Request body:

{
  "lang": "en_US"
}

意见反馈 POST /report

Request body:

{
  "token": "token_test",
  "content": "aaa bbbb ccccc"
}

我的工单（查询）GET /user/mytickets

data (same as oreo):

{
  "list": [
    {
      "id": 6830,
      "type": 1,
      "status": 5,
      "device": "主机",
      "deviceModel": "技嘉",
      "owner": "武技栏",
      "phone": "18888888888",
      "createdTime": "2024-03-06T19:49:27.043865",
      "isConfirmed": false
    }
  ]
}

工单详情

创建评论 POST /tickets/newcomment?id={id}

Request

{
  "content": "这是一条评论",
  "token": "token_test"
}

创建工单 POST /tickets/create

Request

{
  "token": "token_test",
  "type": 1, // 电器是0，电脑是1(bushi)
  "device": "华硕",
  "deviceModel": "天选3",
  "owner": "西西弗",
  "phone": "12333333333",
  "description": "没法用pd充电",
  "accessories": [0]
}

添加评论 POST /tickets/addnote

Request

{
  "token": "token_test",
  "id": "id",
  "content" : "为什么 PD 不能充电呢？"
}

加入 Oreo POST /tickets/addtooreo

Request

{
  "token": "token_test",
  "id": 4234
}

认领工单 POST /tickets/pick

Request

{
  "token": "token_test",
  "id": 4234
}

更新工单状态 POST /tickets/update

Request

{
  "token": "token_test",
  "id": "id",
  "status": 3
}

确认已取回 POST /tickets/retrieve

Request

{
  "token": "token_test",
  "id": "id",
}

获取七天内未完成工单 POST /tickets/uncompleted

Request

{
  "token": "token_test",
}

工单信息 GET /tickets/info?id={id}

data (same as oreo):

{
  "id": 6847,
  "type": 1,
  "device": "华硕",
  "deviceModel": "灵耀X14",
  "owner": "唐姐姐",
  "phone": "15555555555",
  "description": "清灰",
  "workers": [],
  "createdTime": "2024-03-07T19:52:48.523303",
  "status": 5,
  "isConfirmed": false,
  "notes": [
    {
      "avatar": "https://....jpg",
      "id": 21368,
      "op": "宇航员",
      "type": 0,
      "content": "",
      "createdTime": "2024-03-07T19:52:48.523305"
    },
    {
      "avatar": "https://....jpg",
      "id": 21370,
      "op": "宇航员",
      "type": 2,
      "content": "1",
      "createdTime": "2024-03-07T19:58:27.838816"
    },
    {
      "avatar": "https://....jpg",
      "id": 21373,
      "op": "宇航员",
      "type": 2,
      "content": "4",
      "createdTime": "2024-03-07T20:28:12.070707"
    },
    {
      "avatar": "https://....jpg",
      "id": 21374,
      "op": "宇航员",
      "type": 2,
      "content": "5",
      "createdTime": "2024-03-07T20:30:15.770486"
    }
  ],
  "accessories": [2],
  "picked": false
}

成员相关

成员登录 POST /member/login

Request

{
  "token": "token_test",
  "stuid": "3220101984",
  "passwd": "sonvidiafuckyou"
}

成员登出 POST /member/logout

Request

{
  "token": "token_test"
}

成员值班信息 GET /member/duty/info

当前在值班

data:

{
  "isInDuty": true,
  "inDutyCnt": 3,
  "currentDuty": "2"
}

当前未值班

data:

{
  "isInDuty": false,
  "offDutyReason": "学园维修",
  "dutyRecoverTime": "下周一"
}