在《C#開發BIMFACE系列4 服務端API之源上傳檔案》、《C#開發BIMFACE系列5 服務端API之檔案直傳》兩篇文章中詳細介紹瞭如何將本地檔案上傳到BIMFACE伺服器及BIMFACE後臺的分散式儲存系統中。檔案上傳成功後，BIMFACE的服務會返回與該檔案相關的資訊，如下圖：

 開發者在成功上傳了檔案並獲得相關檔案資訊後，可以將資訊儲存到資料庫中供後續的業務開發使用。

除此之外，BIMFACE平臺還提供了單獨的服務用於獲取檔案資訊、獲取檔案資訊列表、獲取檔案上傳的狀態資訊、獲取應用支援的檔案型別。

下面分別介紹各種服務的使用方法。

請求地址： GET https://file.bimface.com/files/{fileId}

說明：根據檔案ID獲取檔案詳細資訊

引數：

請求 path(示例)：https://file.bimface.com/files/1419273043501216

請求 header(示例)："Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"

HTTP響應示例(200)：

{
  "code" : "success",
  "data" : {
    "createTime" : "2017-11-09 13:25:03", // 檔案的上傳時間
    "etag" : "19349858cjs98ericu989",     // 儲存檔案的額外屬性
    "fileId" : 1216113551663296,          // 檔案編號
    "length" : 39044,                     // 檔案的大小
    "name" : "-1F.rvt",                   // 檔案的名稱
    "status" : "success",                 // 檔案的上傳狀態
    "suffix" : "rvt"                      // 檔案的字尾名
  },
  "message" : ""
}

C#實現方法：

 1 /// <summary>
 2 ///   根據檔案ID獲取檔案詳細資訊
 3 /// </summary>
 4 /// <param name="accessToken">令牌</param>
 5 /// <param name="fileId">檔案ID</param>
 6 /// <returns></returns>
 7 public virtual FileInfoGetResponse GetFileInfo(string accessToken, string fileId)
 8 {
 9     //GET https://file.bimface.com/files/{fileId}
10     string url = string.Format(BimfaceConstants.FILE_HOST + "/files/{0}", fileId);
11 
12     BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
13     headers.AddOAuth2Header(accessToken);
14 
15     try
16     {
17         FileInfoGetResponse response;
18 
19         HttpManager httpManager = new HttpManager(headers);
20         HttpResult httpResult = httpManager.Get(url);
21         if (httpResult.Status == HttpResult.STATUS_SUCCESS)
22         {
23             response = httpResult.Text.DeserializeJsonToObject<FileInfoGetResponse>();
24         }
25         else
26         {
27             response = new FileInfoGetResponse
28             {
29                 Message = httpResult.RefText
30             };
31         }
32 
33         return response;
34     }
35     catch (Exception ex)
36     {
37         throw new Exception("[根據檔案ID獲取檔案詳細資訊]發生異常！", ex);
38     }
39 }

其中引用的 httpManager.Get() 方法如下：

/// <summary>
/// HTTP-GET方法，(不包含body資料)。
/// 傳送 HTTP 請求並返回來自 Internet 資源的響應(HTML程式碼)
/// </summary>
/// <param name="url">請求目標URL</param>
/// <returns>HTTP-GET的響應結果</returns>
public HttpResult Get(string url)
{
    return RequestString(url, null, HttpMethod.GET, null);
}

 1 /// <summary>
 2 ///  HTTP請求(包含文字的body資料)
 3 /// </summary>
 4 /// <param name="url">請求目標URL</param>
 5 /// <param name="data">主體資料(普通文字或者JSON文字)。如果引數中有中文，請使用合適的編碼方式進行編碼，例如：gb2312或者utf-8</param>
 6 /// <param name="method">請求的方法。請使用 HttpMethod 的列舉值</param>
 7 /// <param name="contentType"><see langword="Content-type" /> HTTP 標頭的值。請使用 ContentType 類的常量來獲取</param>
 8 /// <returns></returns>
 9 private HttpResult RequestString(string url, string data, string method, string contentType)
10 {
11     HttpResult httpResult = new HttpResult();
12     HttpWebRequest httpWebRequest = null;
13 
14     try
15     {
16         httpWebRequest = WebRequest.Create(url) as HttpWebRequest;
17         httpWebRequest.Method = method;
18         httpWebRequest.Headers = HeaderCollection;
19         httpWebRequest.CookieContainer = CookieContainer;
20         if (!string.IsNullOrWhiteSpace(contentType))
21         {
22             httpWebRequest.ContentType = contentType;// 此屬性的值儲存在WebHeaderCollection中。如果設定了WebHeaderCollection，則屬性值將丟失。所以放置在Headers 屬性之後設定
23         }
24         httpWebRequest.UserAgent = _userAgent;
25         httpWebRequest.AllowAutoRedirect = _allowAutoRedirect;
26         httpWebRequest.ServicePoint.Expect100Continue = false;
27 
28         if (data != null)
29         {
30             httpWebRequest.AllowWriteStreamBuffering = true;
31             using (Stream requestStream = httpWebRequest.GetRequestStream())
32             {
33                 requestStream.Write(EncodingType.GetBytes(data), 0, data.Length);//將請求引數寫入請求流中
34                 requestStream.Flush();
35             }
36         }
37 
38         HttpWebResponse httpWebResponse = httpWebRequest.GetResponse() as HttpWebResponse;
39         if (httpWebResponse != null)
40         {
41             GetResponse(ref httpResult, httpWebResponse);
42             httpWebResponse.Close();
43         }
44     }
45     catch (WebException webException)
46     {
47         GetWebExceptionResponse(ref httpResult, webException);
48     }
49     catch (Exception ex)
50     {
51         GetExceptionResponse(ref httpResult, ex, method, contentType);
52     }
53     finally
54     {
55         if (httpWebRequest != null)
56         {
57             httpWebRequest.Abort();
58         }
59     }
60 
61     return httpResult;
62 }

 在BIMFACE的控制檯中可以看到我們上傳的檔案列表

選擇任意一個檔案的ID來做測試

可以看到獲取檔案資訊成功，返回了以下資訊：檔案的上傳時間、儲存檔案的額外屬性、檔案編號、檔案的大小、檔案的名稱、檔案的上傳狀態、檔案的字尾名。
測試程式如下：

 1 // 獲取檔案資訊
 2 protected void btnGetFileInfo_Click(object sender, EventArgs e)
 3 {
 4     txtFileInfo.Text = string.Empty;
 5 
 6     string token = txtAccessToken.Text;
 7     string fileId = txtFileId.Text;
 8 
 9     FileApi api = new FileApi();
10     FileInfoGetResponse response = api.GetFileInfo(token, fileId);
11 
12     txtFileInfo.Text = response.Code
13                      + Environment.NewLine
14                      + response.Message
15                      + Environment.NewLine
16                      + response.Data.ToString();
17 }