目录

Files:get.content

功能介绍

下载文件。

场景描述

File.get.content接口实现下载文件数据,用户可以根据Range指定下载文件的数据范围。

使用约束

接口原型

承载协议

HTTP GET

接口方向

开发者服务器->华为云空间服务器

接口URL

https://driveapis.cloud.huawei.com.cn/drive/v1/files/{fileId}?form=content

数据格式

请求消息:Content-Type: application/json

路径参数

参数

是否必选

参数类型

描述

fileId

是

string

文件ID。

查询参数

参数

是否必选

参数类型

描述

form

是

string

下载方式。

quotaId

否

string

用户标识,小于40个字符。用于限制单个用户的API访问数量。

请求参数

Request Header

参数

是否必选

参数类型

描述

Authorization

是

string

用户鉴权信息 AccessToken(即AT)

x-hw-trace-id

否

string

业务跟踪id。

x-hw-app-id

否

string

应用的appid。

version

否

string

SDK版本。

Range

否

string

指定文件下载范围,格式为:bytes=start-end,不指定默认下载整个文件

x-hw-terminal

否

string

终端型号。

x-hw-os

否

string

终端操作系统类型。

unionID

否

string

用户的unionID。

User-Agent

否

string

应用版本号/appid。

x-hw-deviceUUID

否

string

设备UUID。

x-hw-deviceUDID

否

string

设备UDID。

x-hw-appPackageName

否

string

应用包名。

x-hw-network

否

string

网络类型,[WiFi, 2G, 3G, 4G, 5G, wire]。

Cookie

否

string

cookie中的loginId为会话ID,用于鉴权。

Request Body

无

请求示例

GET https://driveapis.cloud.huawei.com.cn/drive/v1/files/DSQpEkxcAAADKXEPJAYABgEZivNwAmCu?form=content HTTP/1.1 
Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk

响应参数

状态码为200时:

参数

参数类型

描述

MediaContent

string

文件内容。

响应示例

[imageData]

常见错误码

错误码后4位为业务错误码,用于区分错误场景,其他业务错误码见状态码章节。

状态码

错误码

响应代码

描述

200

NA

-

成功。

302

NA

-

重定向其他url下载.

400

22004003

PARAM_VALUE_NOT_SUPPORT

参数不支持,请检查参数列表。

400

22044002

PARAM_INVALID

参数校验失败,请检查参数列表。

400

22054002

PARAM_INVALID

参数校验失败,请检查参数列表。

400

22054003

PARAM_VALUE_NOT_SUPPORT

参数不支持,请检查参数列表。

400

22054005

SITE_NOT_FOUND

站点信息未知。

400

22064001

LACK_OF_PARAM

缺少入参,请检查参数列表。

400

22064002

PARAM_INVALID

参数校验失败,请检查参数列表。

400

22064003

PARAM_VALUE_NOT_SUPPORT

无效参数,请检查参数列表。

400

22064004

PARAM_EXPIRED

参数不支持,请检查参数列表。

400

22084002

PARAM_INVALID

参数校验失败,请检查参数列表。

400

22234002

PARAM_INVALID

参数校验失败,请检查参数列表。

401

22044011

USER_NOT_AUTHORIZED

用户鉴权失败。

401

22054011

USER_NOT_AUTHORIZED

用户鉴权失败。

401

22064011

USER_NOT_AUTHORIZED

用户鉴权失败。

403

22004032

SERVICE_NOT_SUPPORT

服务在当前国家/地区不支持。

403

22004035

INSUFFICIENT_SCOPE

Scope校验失败。

403

22004037

OPERATION_NOT_COMPLETE

由于错误无法完成操作。

403

22044033

AGREEMENT_NOT_SIGNED

协议未签署,请签署协议后再进行重试。

403

22054034

CROSS_SITE_NOT_SUPPORT

跨站点功能限制。

403

22064035

INSUFFICIENT_SCOPE

Scope校验失败。

403

22064036

INSUFFICIENT_PERMISSION

无此操作权限。

403

22064038

OUTER_SERVICE_ERROR

外部服务错误且无法恢复。

403

22124031

DATA_MIGRATING

正处于安全策略更新,请等待安全策略更新完成。

403

22124032

SERVICE_NOT_SUPPORT

服务未开放。

403

22234035

INSUFFICIENT_SCOPE

Scope校验失败。

403

22234036

INSUFFICIENT_PERMISSION

无此操作权限。

403

22234038

OUTER_SERVICE_ERROR

外部服务错误且无法恢复。

404

22234041

CONTENT_NOT_FOUND

内容未发现。

429

22074291

USER_REQUEST_TOO_MANY

用户请求太频繁。

429

22074292

APP_REQUEST_TOO_MANY

应用请求太频繁。

500

22005006

SERVER_TEMP_ERROR

服务器临时错误。

500

22065002

OUTER_SERVICE_UNAVAILABLE

外部服务不可用。

500

22065005

RESOURCE_LOCKED

资源被锁住,暂时禁止操作。

500

22085006

SERVER_TEMP_ERROR

服务器临时错误。

500

22235002

OUTER_SERVICE_UNAVAILABLE

外部服务不可用。

调用示例

    public static void main(String[] args) throws IOException {
        // 设置请求地址,文件ID和用户认证令牌
        String url = "https://driveapis.cloud.huawei.com.cn/drive/v1/files";
        String fileId = "AACUf44uK7wAg6pECq0Vh4QNqkgKoCuwA";
        String access_token = "CF3qCeRPLh5GzjpB3ta5UscyjQa2rZhjgFzULNJqVDmCGCJi7IjrQwG7MKmpWIHTq6PRVeYSDsTZtjMbeCoP9ReANeBzHPYRHAppt8HZAaw/3H+IiLbWzQ==";
        // 下载文件
        filesGetMedia(url, access_token, fileId);
    }

    private static void filesGetMedia(String url, String access_token, String fileId) throws IOException {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append("/").append(fileId);
        stringBuilder.append("?").append("form=content");
        HttpGet httpGet = new HttpGet(url + stringBuilder);
        httpGet.setHeader("Authorization","Bearer " + access_token);
        httpGet.setHeader("Cache-Control","no-cache");
        CloseableHttpResponse response = HttpClientUtil.getClient().execute(httpGet);

        try {
            response.setHeader("Content-type","image/jpeg");
            HttpEntity responseEntity = response.getEntity();
            InputStream inputStream=responseEntity.getContent();
            FileUtils.copyToFile(inputStream, new File("D://2.jpg"));
        }finally {
            response.close();
        }
    }