系列目录 【已更新最新开发文章,点击查看详细】
通过BIMFACE控制台或者调用服务接口上传文件成功后,默认场景下需要下载该源文件,下载文件一般需要知道文件的下载链接即可。BIMACE平台提供了“获取文件下载链接”的服务接口。下面详细介绍其使用方法。
请求地址:GET https://file.bimface.com/download/url
说明:应用通过该接口获取文件的下载地址,然后下载文件。下载地址有效时间是5分钟。
参数:
请求 path(示例):https://file.bimface.com/download/url?fileId=1419273043501216
请求 header(示例):"Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"
HTTP响应示例(200):
{
"code" : "success",
"data" : "data", // 请求成功后返回的文件下载链接
"message" : ""
}
C#实现方法:
1 /// <summary>
2 /// 获取文件下载链接
3 /// </summary>
4 /// <param name="accessToken">令牌</param>
5 /// <param name="fileId">文件ID</param>
6 /// <param name="name">文件名称</param>
7 /// <returns></returns>
8 public virtual FileDownloadUrlGetResponse GetFileDownloadUrl(string accessToken, string fileId, string name = "")
9 {
10 //GET GET https://file.bimface.com/download/url
11 string url = string.Format(BimfaceConstants.FILE_HOST + "/download/url?fileId={0}", fileId);
12 if (name.IsNotNullAndWhiteSpace())
13 {
14 url = url + "&name=" + name.UriEscapeDataString();
15 }
16 BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
17 headers.AddOAuth2Header(accessToken);
18
19 try
20 {
21 FileDownloadUrlGetResponse response;
22
23 HttpManager httpManager = new HttpManager(headers);
24 HttpResult httpResult = httpManager.Get(url);
25 if (httpResult.Status == HttpResult.STATUS_SUCCESS)
26 {
27 response = httpResult.Text.DeserializeJsonToObject<FileDownloadUrlGetResponse>();
28 }
29 else
30 {
31 response = new FileDownloadUrlGetResponse
32 {
33 Message = httpResult.RefText
34 };
35 }
36
37 return response;
38 }
39 catch (Exception ex)
40 {
41 throw new Exception("[获取文件下载链接]发生异常!", ex);
42 }
43 }
其中引用的 httpManager.Get() 方法,请参考《C#开发BIMFACE系列6 服务端API之获取文件信息》,方法完全一样。
测试
在BIMFACE的控制台中可以看到我们上传的文件列表
选择任意一个文件的ID来做测试
可以看到获取文件下载链接成功,返回了以下信息:文件下载链。
复制下载链接到浏览器的地址栏中,回车即开始下载文件
下载地址有效时间是5分钟,5分钟后该链接即失效。 如果再下载,需要重新获取下载链接。
测试程序如下:
// 获取文件下载链接
protected void btnGetFileDownloadUrl_Click(object sender, EventArgs e)
{
txtFileInfo.Text = string.Empty;
string token = txtAccessToken.Text;
string fileId = txtFileId.Text;
FileApi api = new FileApi();
FileDownloadUrlGetResponse response = api.GetFileDownloadUrl(token, fileId);
txtFileInfo.Text = response.Code
+ Environment.NewLine
+ response.Message
+ Environment.NewLine
+ response.Data.ToString();
}
系列目录 【已更新最新开发文章,点击查看详细】