| 承载协议 | HTTP GET |
|---|---|
| 接口方向 | 开发者服务器->华为云空间服务器 |
| 接口URL | https://driveapis.cloud.huawei.com.cn/drive/v1/smallThumbnails/{fileId}?form=content |
| 数据格式 | 请求消息:Content-Type: application/json |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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/smallThumbnails/DSQpEkxcAAADKXEPJAYABgEZivNwAmCu?form=content HTTP/1.1 Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk
错误码后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/smallThumbnails";
String fileId = "AACUf44uK7wAg6pECq0Vh4QNqkgKoCuwA";
String access_token = "CF3qHUcDOG3Rq+aCBdoTbdxTQYmIrt1c8xeVvh7Tquare/8VD+7YZFNxzuz5ZdhDrulEWOZVECrpQbVOqVMABeKe9p4wjL4UxskLw7KJKvs0fvZEJqjAKQ==";
// 下载文件小缩略图
smallThumbnailGet(url, access_token, fileId);
}
private static void smallThumbnailGet(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://smallThumbnail.jpg"));
}finally {
response.close();
}
}