APIv2_预约服务 - 17kong/yiqikong-wiki GitHub Wiki

预约接口

请及时更新文档 任何人发现文档和接口不符请及时通知团队维护者

获取单个预约

通用获取仪器预约接口

GET /reserve/:id

此处id为仪器控-预约id

参数

{
  "token": "4415297e3af8c", // 唯一标示,APP生成,为了新增时查找相关预约
}

响应

Status: 200 OK
-
{
  "id": 1, // 仪器控预约id
  "equipment": 1, // 仪器控仪器id
  "user": 1, // 仪器控用户id
  "user_name": "Doe john", // 仪器控用户姓名
  "lab_name": "Lab", // 课题组名称
  "project_name": "Lab", // 送样关联项目名称
  "phone": "13900000000", // 用户联系电话
  "address": "Doe John", // 用户地址
  "operator": 1, // 操作者id
  "start_time": "1529655889", // 开始时间
  "end_time": "1529655889", // 结束时间
  "ctime": "2018-06-05 00:00:00", // 创建时间
  "title": 5, // 预约标题
  "description": "描述", // 描述
  "source_name": "swu", // 来源
  "source_id": 1, // 来源id
  "token": "4415297e3af8c", // 唯一标示
  "type": 0, // 预约类型 (0预约 3非预约)
  "state": 1, // 该订单状态 (0排队中 1成功 2失败 3取消)
  "approval": 1, // 审批状态 
}
Status: 404 Not Found
-
"没有找到对应的预约信息"

获取多个预约

通用获取仪器控多预约接口

GET /reserve

参数

{
  "equipment": 1, // 仪器控仪器ID
  "user": 1, // 预约仪器控ID
  "start_time": ["bt", "1529655889", "1529655889"], // 开始时间
  "end_time": ["bt", "1529655889", "1529655889"], // 结束时间
  "ctime": ["bt", "2018-06-04 00:00:00", "2018-06-05 00:00:00"], // 创建时间
  "type": ["in", 0, 3] // 预约类型
  "sortby": "name", // 排序字段
  "order": "desc", // 排序方式
  "limit": [0, 20], // 分页筛选
}

响应

Status: 200 OK
-
{
  "total": 200,
  "data": [
    {
      "id": 1, // 仪器控预约id
      "equipment": 1, // 仪器控仪器id
      "user": 1, // 仪器控用户id
      "user_name": "Doe john", // 仪器控用户姓名
      "lab_name": "Lab", // 课题组名称
      "project_name": "Lab", // 送样关联项目名称
      "phone": "13900000000", // 用户联系电话
      "address": "Doe John", // 用户地址
      "operator": 1, // 操作者id
      "start_time": "1529655889", // 开始时间
      "end_time": "1529655889", // 结束时间
      "ctime": "2018-06-05 00:00:00", // 创建时间
      "title": 5, // 预约标题
      "description": "描述", // 描述
      "source_name": "swu", // 来源
      "source_id": 1, // 来源id
      "token": "4415297e3af8c", // 唯一标示 
      "type": 0, // 预约类型 (0预约 3非预约)
      "state": 1, // 该订单状态 (0排队中 1成功 2失败 3取消)
      "approval": 1, // 审批状态 
    },
    ...
  ]
}

添加预约

通用添加仪器控用户接口

POST /reserve

参数

{
  "user": 1, // 仪器控用户id
  "user_name": "Doe john", // 仪器控用户姓名
  "lab_name": "Lab", // 课题组名称
  "project_name": "Lab", // 送样关联项目名称
  "phone": "13900000000", // 用户联系电话
  "address": "Doe John", // 用户地址
  "equipment": 1, // 仪器控仪器id
  "start_time": "1529683200", // 开始时间
  "end_time": "1529683200", // 结束时间
  "title": "标题", // 标题
  "description": "描述", // 描述
  "source_name": "swu", // 来源
  "token": "4415297e3af8c", // 唯一标示 
}

响应

Status: 200 OK
-
{
  "id": 1, // 仪器控预约id
  "equipment": 1, // 仪器控仪器id
  "user": 1, // 仪器控用户id
  "user_name": "Doe john", // 仪器控用户姓名
  "lab_name": "Lab", // 课题组名称
  "project_name": "Lab", // 送样关联项目名称
  "phone": "13900000000", // 用户联系电话
  "address": "Doe John", // 用户地址
  "operator": 1, // 操作者id
  "start_time": "1529655889", // 开始时间
  "end_time": "1529655889", // 结束时间
  "ctime": "2018-06-05 00:00:00", // 创建时间
  "title": "标题", // 预约标题
  "description": "描述", // 描述
  "source_name": "swu", // 来源
  "source_id": 1, // 来源id
  "token": "4415297e3af8c", // 唯一标示 
  "type": 0, // 预约类型 (0预约 3非预约)
  "state": 1, // 该订单状态 (0排队中 1成功 2失败 3取消)
  "approval": 1, // 审批状态 
}
Status: 400 Bad Request

修改预约

通用修改仪器控预约接口

PUT /reserve/:id

参数

{
  "equipment": 1, // 仪器控仪器id
  "user": 1, // 仪器控用户id
  "user_name": "Doe john", // 仪器控用户姓名
  "lab_name": "Lab", // 课题组名称
  "project_name": "Lab", // 送样关联项目名称
  "phone": "13900000000", // 用户联系电话
  "address": "Doe John", // 用户地址
  "start_time": "1529655889", // 开始时间
  "end_time": "1529655889", // 结束时间
  "ctime": "2018-06-05 00:00:00", // 创建时间
  "title": "标题", // 预约标题
  "description": "描述", // 描述
  "approval": 1, // 审批状态
  "type": 3 // 预约类型
  "state": 1, // 该订单状态
  "source_name": "swu", // 来源
  "source_id": 1, // 来源id
  "token": "4415297e3af8c", // 唯一标示 
}

响应

Status: 200 OK
-
{
  "id": 1, // 仪器控预约id
  "equipment": 1, // 仪器控仪器id
  "user": 1, // 仪器控用户id
  "user_name": "Doe john", // 仪器控用户姓名
  "lab_name": "Lab", // 课题组名称
  "project_name": "Lab", // 送样关联项目名称
  "phone": "13900000000", // 用户联系电话
  "address": "Doe John", // 用户地址
  "operator": 1, // 操作者id
  "start_time": "1529655889", // 开始时间
  "end_time": "1529655889", // 结束时间
  "ctime": "2018-06-05 00:00:00", // 创建时间
  "title": 5, // 预约标题
  "description": "描述", // 描述
  "source_name": "swu", // 来源
  "source_id": 1, // 来源id
  "token": "4415297e3af8c", // 唯一标示 
  "type": 0, // 预约类型 (0预约 3非预约)
  "state": 1, // 该订单状态 (0排队中 1成功 2失败 3取消)
  "approval": 1, // 审批状态 
}
Status: 400 Bad Request