1. 快速上手

目标: 快速使用 BOS 定义、存储、获取数据。

1.1.1. 准备工作

• 使用账号密码登录 BOS 门户, 点击「创建应用」按钮, 按照提示创建应用。

  

• 点击 应用管理 的「数据模型配置」

  

• 数据模型配置

  本页面用于对象类、关系类的配置, 用户可对相关类进行增删改查操作。

  下面的截图最终的结果是新建一个对象类, 类名为 uoInspectionRecord, 并且添加了对象类的自定义属性为 time。

  

  

1.1.2. 获取调用接口所需数据

• 获取应用 appKey

  进入 应用管理 页面, 点击「编辑」按钮, 在新页面中复制应用 appKey。

  

  

• 获取应用 token

  打开 postman, 在 postman 中发送登录请求, 请求数据如下, 获取响应数据的 access_token。

  请求方法: post
  请求url: http://bosgw.bimwinner.com/bospersonnelservice/{appKey}/users/login
  body(form-data): {
    "name": "zhangsan",
    "password":"123321"
  }
  

  

1.1.3. 调用接口

• 使用接口添加一条数据

  在 postman 中发送登录请求, 请求数据如下：

  请求方法: post
  请求url: http://bosgw.bimwinner.com/bosfoundationservice/{appKey}/prototype/entity/uoInspectionRecord
  Headers: {
    "Authorization": "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTUyN2ZmYWRhZjhhNGY0YWJhZTk4NWM2N2JiZDQ5NmQiLCJ1c2VyTmFtZSI6InJhb2ppYWp1biIsInVzZXJUeXBlIjoiMCIsImFwcEtleSI6Inc4NDg2ZTJhMDY3ZTRiZGFiNzYzMDU0NmFkMDE3NTFhIiwiYXBwTmFtZSI6InRlc3QxMTIzMyIsImFwcERiIjoidzg0ODZlMmEwNjdlNGJkYWI3NjMwNTQ2YWQwMTc1MWEiLCJsb2dpblRpbWUiOiIxNTk2NzgxMDA3NjE5IiwiZXhwIjowfQ.IZf0QDXp-HzKsG47OSHcrrPHSmZ-ZhYrNKWkcgnO6n4"
  }
  body(application/json): {
    "name": "zhangsan"
  }
  

  

• 使用接口查询数据

  在 postman 中发送登录请求, 请求数据如下：

  请求方法: post
  请求url: http://bosgw.bimwinner.com/bosfoundationservice/{appKey}/prototype/query/uoInspectionRecord?noRelation=true
  Headers: {
    "Authorization": "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTUyN2ZmYWRhZjhhNGY0YWJhZTk4NWM2N2JiZDQ5NmQiLCJ1c2VyTmFtZSI6InJhb2ppYWp1biIsInVzZXJUeXBlIjoiMCIsImFwcEtleSI6Inc4NDg2ZTJhMDY3ZTRiZGFiNzYzMDU0NmFkMDE3NTFhIiwiYXBwTmFtZSI6InRlc3QxMTIzMyIsImFwcERiIjoidzg0ODZlMmEwNjdlNGJkYWI3NjMwNTQ2YWQwMTc1MWEiLCJsb2dpblRpbWUiOiIxNTk2NzgxMDA3NjE5IiwiZXhwIjowfQ.IZf0QDXp-HzKsG47OSHcrrPHSmZ-ZhYrNKWkcgnO6n4"
  }
  body(application/json): {
     "condition": []
  }
  

  

1.1.4. 总结

BOSF 提供了功能强大的数据模型配置和数据服务 API, 开发者不必关心数据的处理过程,只需要调用相应的 API 即可实现需求。