# Access Token

出于安全方面的考虑,BIMFACE对每一次服务端的API调用都会进行认证,认证的凭据就是Access Token(每一个应用都有自己独有的AccessToken),因此,获取AccessToken是程序开发的第一步。

# 说明

  1. Access Token有效期为7天,除非Token被注销,否则Access Token在7天内不会发生改变;
  2. Access Token只能使用appkey和secret,通过/oauth2/token接口获取;
  3. 数据服务接口(URL地址为https://api.bimface.com/data/...)可以使用View Token鉴权代替Access Token鉴权,具体方法为添加一个查询参数(Query parameter): view_token = {your_view_token},获取View Token的方法详见文章 获取View Token (opens new window)

# 主要流程

  1. 将appKey和appSecret进行拼接,拼接方式为:appKey:appSecret(中间用冒号连接);
  2. 对拼接后的字符串进行BASE64编码;
  3. 在获取Access Token的接口中添加Header类型的Authorization,具体内容为 : "Basic" + 空格 + 编码后的字符串;   API:获取Access Token (opens new window)
  4. 获取到Access Token后进行文件上传、下载、删除、文件转换、模型集成、文件对比等操作。

# 使用工具获取Access Token

除了编写代码,还可以使用以下工具获取Access Token:

  1. 使用谷歌浏览器插件:Postman image

  2. 如果你熟悉Java编程,可直接使用BIMFACE官方提供的JAVA-SDK,实例化BimfaceClient即可。

BimfaceClient client = new BimfaceClient(appKey, appSecret);

查看JAVA SDK使用方式 (opens new window)