About:get

功能介绍

获取用户信息。

场景描述

您的应用可以通过About.get接口获取到用户华为云空间信息，例如空间容量大小，允许上传的最大文件大小等。

使用约束

接口原型

路径参数

无

查询参数

请求参数

Request Header

Request Body

无

请求示例

GET https://driveapis.cloud.huawei.com.cn/drive/v1/about?fields=* HTTP/1.1 
Accept: application/json 
Cache-Control: no-cache 
Authorization: Bearer CF3NTYZSs7MRmxWyj8ssonQQxDgSPAjnDvrf+91NrpN22LdUrMA30A5Kzz0mf55sWao7e7VeLrmjQ0z2OmwPWlt3S00/L1BJppbTFhIgWb74ZBK8CFImUA==

响应参数

状态码为200时:

响应示例

{
    "storageQuota":{
        "usedSpace":"1458200675",
        "userCapacity":"5368709120"
    },
    "maxThumbnailSize":2097152,
    "needUpdate":false, // 值为true，表示需要用户更新安全策略
    "maxFileUploadSize":"53687091200",
    "domain":"driveapis.cloud.huawei.com.cn",
    "category":"drive#about",
    "user":{
        "permissionId":"233228122990838144",
        "displayName":"huaweiExample",
        "me":true,
        "category":"drive#user"
    },
    "folderLevel":10
}

常见错误码

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

调用示例

    public static void main(String[] args) throws IOException{
        // 设置请求地址和用户认证令牌
        String url = "https://driveapis.cloud.huawei.com.cn/drive/v1/about";
        String access_token = "CV6doD3HkAi7SGjrrWsDZDz0wkko0EQrWZDQKUZNZ/Sw8jytLWm5G1jQS3NtYF+wIWYCG9m3rVROTwg+8xpG6Jq55F0JDbxumn3/7SeatibxOh3sMbNgew==";
        // 获取用户信息
        JSONObject aboutInfo = aboutGet(url, access_token);
        System.out.println(aboutInfo.toJSONString());

    }

    private static JSONObject aboutGet(String url, String access_token) throws IOException {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append("?").append("fields=*");
        HttpGet httpGet = new HttpGet(url + stringBuilder);
        httpGet.setHeader("Authorization","Bearer " + access_token);
        CloseableHttpResponse response = HttpClientUtil.getClient().execute(httpGet);

        try {
            HttpEntity responseEntity = response.getEntity();
            String ret = responseEntity != null ? EntityUtils.toString(responseEntity) : null;
            JSONObject jsonObject = (JSONObject) JSON.parse(ret);
            EntityUtils.consume(responseEntity);
            return jsonObject;
        }finally {
            response.close();
        }
    }