# Access Token
出于安全方面的考虑,BIMFACE对每一次服务端的API调用都会进行认证,认证的凭据就是Access Token(每一个应用都有自己独有的AccessToken),因此,获取AccessToken是程序开发的第一步。
# 说明
- Access Token有效期为7天,除非Token被注销,否则Access Token在7天内不会发生改变;
- Access Token只能使用appkey和secret,通过/oauth2/token接口获取;
- 数据服务接口(URL地址为https://api.bimface.com/data/...)可以使用View Token鉴权代替Access Token鉴权,具体方法为添加一个查询参数(Query parameter): view_token = {your_view_token},获取View Token的方法详见文章 获取View Token (opens new window)
# 主要流程
- 将appKey和appSecret进行拼接,拼接方式为:appKey:appSecret(中间用冒号连接);
- 对拼接后的字符串进行BASE64编码;
- 在获取Access Token的接口中添加Header类型的Authorization,具体内容为 : "Basic" + 空格 + 编码后的字符串; API:获取Access Token (opens new window)
- 获取到Access Token后进行文件上传、下载、删除、文件转换、模型集成、文件对比等操作。
# 使用工具获取Access Token
除了编写代码,还可以使用以下工具获取Access Token:
使用谷歌浏览器插件:Postman
如果你熟悉Java编程,可直接使用BIMFACE官方提供的JAVA-SDK,实例化BimfaceClient即可。
BimfaceClient client = new BimfaceClient(appKey, appSecret);