APIv1_仪器服务 - 17kong/yiqikong-wiki GitHub Wiki

仪器服务

获取单个仪器
获取多个仪器
部分修改仪器

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

获取单个仪器

通用获取单个仪器接口

GET /equipment/:id

此处id同时适配仪器的仪器控id和uuid

响应

Status: 200 OK
-
{
  "source_name": "swu", // 仪器来源节点
  "source_id": 1, // 仪器来源id
  "uuid": "93724601f8c10f4953face21c4e9a472ef43cc46",
  "name": "核磁共振波谱仪", // 仪器名称
  "icon": "http://image", // 仪器图片的地址
  "ref_no": "HX007", // 仪器编号
  "model": "model", // 仪器型号
  "spec": "spec", // 仪器规格
  "price": 500000.00, // 仪器价格
  "manu_place": "安捷伦", // 生产厂家
  "manu_name": "米国", // 产地国家
  "manu_date": "2005-10-01 00:00:00", // 生产日期
  "purchased_date": "2005-10-01 00:00:00", // 购置日期
  "enroll_date": "2005-10-01 00:00:00", // 入网日期
  "tech_specs": "主要规格和技术指标", 
  "features": "主要功能和特色",
  "accessories": "主要附件及配置",
  "application": "主要测试和研究领域",
  "contact_name": "Doe John", // 负责人
  "contact_phone": 13502126928, // 联系电话
  "contact_email": "[email protected]", // 联系邮箱
  "location": "放置地点",
  "longitude": 137.12321, // 维度
  "latitude": 69.23212, // 经度
  "can_reserv": 1, // 是否接受预约
  "can_sample": 1, // 是否接受送样
  "sample_lock": 1, // 是否锁定仪器负责人对该仪器的送样设置
  "reserv_lock": 1, // 是否锁定仪器负责人对该仪器的预约设置
  "need_approval": 0, // 是否需要审核
  "need_training": 0, // 是否需要培训
  "tags": "化学", // 仪器标签
}

Status: 404 Not Found
-
没有找到对应的仪器信息

获取多个仪器

通用获取多个仪器接口

GET /equipment

参数

{
  "source_name": "swu", // 仪器来源节点
  "name_abbr": "核磁共振波谱仪", // 仪器名称
  "uuid": ['in', '2c05a4f754f4bfdf4e0b0e487c14aa0c7fc45376', '66835801fde83e6e7fd2fb56b466c5ea04d30c54'], // 仪器uuid
  "share": "1", // 仪器是否共享
  "sortby": "name", // 排序字段
  "order": "desc", // 排序方式
  "limit": [0, 20], // 分页筛选
}

响应

Status: 200 OK
-
{
  "total": 200,
  "data": [
    {
      "id": 1, // 仪器id
      "source_name": "swu", // 仪器来源节点
      "source_id": 1, // 仪器来源id
      "uuid": "93724601f8c10f4953face21c4e9a472ef43cc46",
      "name": "核磁共振波谱仪", // 仪器名称
      "name_abbr": "he ci gong zhen bo po yi", // 仪器名称拼音
      "icon": "http://image", // 仪器图片的地址
      "ref_no": "HX007", // 仪器编号
      "model": "model", // 仪器型号
      "spec": "spec", // 仪器规格
      "price": 500000.00, // 仪器价格
      "manu_place": "安捷伦", // 生产厂家
      "manu_name": "米国", // 产地国家
      "manu_date": "2005-10-01 00:00:00", // 生产日期
      "purchased_date": "2005-10-01 00:00:00", // 购置日期
      "enroll_date": "2005-10-01 00:00:00", // 入网日期
      "tech_specs": "主要规格和技术指标", 
      "features": "主要功能和特色",
      "accessories": "主要附件及配置",
      "application": "主要测试和研究领域",
      "contact_name": "Doe John", // 负责人
      "contact_phone": 13502126928, // 联系电话
      "contact_email": "[email protected]", // 联系邮箱
      "location": "放置地点",
      "longitude": 137.12321, // 维度
      "latitude": 69.23212, // 经度
      "can_reserv": 1, // 是否接受预约
      "can_sample": 1, // 是否接受送样
      "sample_lock": 1, // 是否锁定仪器负责人对该仪器的送样设置
      "reserv_lock": 1, // 是否锁定仪器负责人对该仪器的预约设置
      "need_approval": 0, // 是否需要审核
      "need_training": 0, // 是否需要培训
      "tags": "化学", // 仪器标签
    },
    ...
  ]

部分修改仪器

通用部分修改仪器接口

patch /equipment/:id

此处id同时适配仪器的仪器控id和uuid

参数

{
  "can_reserv": 1, // 是否接受预约
  "can_sample": 1, // 是否接受送样
  "need_approval": 0, // 是否需要审核
  "need_training": 0, // 是否需要培训
}

响应

Status: 200 OK
-
{
  "source_name": "swu", // 仪器来源节点
  "source_id": 1, // 仪器来源id
  "uuid": "93724601f8c10f4953face21c4e9a472ef43cc46",
  "name": "核磁共振波谱仪", // 仪器名称
  "icon": "http://image", // 仪器图片的地址
  "ref_no": "HX007", // 仪器编号
  "model": "model", // 仪器型号
  "spec": "spec", // 仪器规格
  "price": 500000.00, // 仪器价格
  "manu_place": "安捷伦", // 生产厂家
  "manu_name": "米国", // 产地国家
  "manu_date": "2005-10-01 00:00:00", // 生产日期
  "purchased_date": "2005-10-01 00:00:00", // 购置日期
  "enroll_date": "2005-10-01 00:00:00", // 入网日期
  "tech_specs": "主要规格和技术指标", 
  "features": "主要功能和特色",
  "accessories": "主要附件及配置",
  "application": "主要测试和研究领域",
  "contact_name": "Doe John", // 负责人
  "contact_phone": 13502126928, // 联系电话
  "contact_email": "[email protected]", // 联系邮箱
  "location": "放置地点",
  "longitude": 137.12321, // 维度
  "latitude": 69.23212, // 经度
  "can_reserv": 1, // 是否接受预约
  "can_sample": 1, // 是否接受送样
  "sample_lock": 1, // 是否锁定仪器负责人对该仪器的送样设置
  "reserv_lock": 1, // 是否锁定仪器负责人对该仪器的预约设置
  "need_approval": 0, // 是否需要审核
  "need_training": 0, // 是否需要培训
}

Status: 404 Not Found
-
没有找到对应的仪器信息
Status: 400 Bad Request
Status: 500 Server error