功能介绍

下载缩略图。

场景描述

Thumbnail.get接口实现下载文件大缩略图的接口，用户可以根据文件ID来下载对应的缩略图。

使用约束

只支持下载大缩略图。
只有owner可以下载该缩略图。
0bit（空文件）的文件，无缩略图。
Scope至少包含下面其中一个：
- https://www.huawei.com/auth/drive
- https://www.huawei.com/auth/drive.file
- https://www.huawei.com/auth/drive.readonly
- https://www.huawei.com/auth/drive.appdata

接口原型

承载协议	HTTP GET
接口方向	开发者服务器->华为云空间服务器
接口URL	https://driveapis.cloud.huawei.com.cn/drive/v1/thumbnails/{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版本。
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/thumbnails/DSQpEkxcAAADKXEPJAYABgEZivNwAmCu?form=content HTTP/1.1 
Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk

响应参数

状态码为200时:

参数	参数类型	描述
ThumbnailContent	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	22064002	PARAM_INVALID	参数校验失败，请检查参数列表。
400	22084002	PARAM_INVALID	参数校验失败，请检查参数列表。
400	22104001	LACK_OF_PARAM	缺少入参，请检查参数列表。
400	22104002	PARAM_INVALID	参数校验失败，请检查参数列表。
400	22104003	PARAM_VALUE_NOT_SUPPORT	无效参数，请检查参数列表。
400	22104004	PARAM_EXPIRED	参数不支持，请检查参数列表。
400	22234002	PARAM_INVALID	参数校验失败，请检查参数列表。
401	22044011	USER_NOT_AUTHORIZED	用户鉴权失败，请检查参数列表。
401	22054011	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	22064036	INSUFFICIENT_PERMISSION	无此操作权限。
403	22104035	INSUFFICIENT_SCOPE	Scope校验失败。
403	22104038	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	22105002	OUTER_SERVICE_UNAVAILABLE	外部服务不可用。
500	22105006	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/thumbnails";
        String fileId = "AACUf44uK7wAg6pECq0Vh4QNqkgKoCuwA";
        String access_token = "CF3qHUcDOG3Rq+aCBdoTbdxTQYmIrt1c8xeVvh7Tquare/8VD+7YZFNxzuz5ZdhDrulEWOZVECrpQbVOqVMABeKe9p4wjL4UxskLw7KJKvs0fvZEJqjAKQ==";
        // 下载缩略图
        thumbnailGet(url, access_token, fileId);
    }

    private static void thumbnailGet(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);
        CloseableHttpResponse response = HttpClientUtil.getClient().execute(httpGet);

        try {
            HttpEntity responseEntity = response.getEntity();
            InputStream inputStream=responseEntity.getContent();
            FileUtils.copyToFile(inputStream, new File("D://thumbnail.jpg"));
        }finally {
            response.close();
        }
    }

目录

Thumbnail:get

功能介绍

场景描述

使用约束

接口原型

路径参数

查询参数

请求参数

请求示例

响应参数

响应示例

常见错误码

调用示例