C#開發BIMFACE系列10 服務端API之獲取文件下載連接

系列目錄     【已更新最新開發文章，點擊查看詳細】

經過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();
}

 

系列目錄     【已更新最新開發文章，點擊查看詳細】