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#实现方法：

/// <summary>
/// 获取文件下载链接
/// </summary>
/// <param name="accessToken">令牌</param>
/// <param name="fileId">文件ID</param>
/// <param name="name">文件名称</param>
/// <returns></returns>
public virtual FileDownloadUrlGetResponse GetFileDownloadUrl(string accessToken, string fileId, string name = "")
{
//GET GET https://file.bimface.com/download/url
string url = string.Format(BimfaceConstants.FILE_HOST + "/download/url?fileId={0}", fileId);
if (name.IsNotNullAndWhiteSpace())
{
url = url + "&name=" + name.UriEscapeDataString();
}
BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
headers.AddOAuth2Header(accessToken); try
{
FileDownloadUrlGetResponse response; HttpManager httpManager = new HttpManager(headers);
HttpResult httpResult = httpManager.Get(url);
if (httpResult.Status == HttpResult.STATUS_SUCCESS)
{
response = httpResult.Text.DeserializeJsonToObject<FileDownloadUrlGetResponse>();
}
else
{
response = new FileDownloadUrlGetResponse
{
Message = httpResult.RefText
};
} return response;
}
catch (Exception ex)
{
throw new Exception("[获取文件下载链接]发生异常！", ex);
}
}

其中引用的 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();
}

系列目录【已更新最新开发文章，点击查看详细】