HistoryVersions:get

功能介绍

获取文件历史记录。

场景描述

您的应用可以通过HistoryVersions.get接口获取到文件历史记录详情。

使用约束

• reader/writer/commenter/owner角色可以获取文件历史记录
• Scope至少包含下面其中一个：
  • https://www.huawei.com/auth/drive.file
  • https://www.huawei.com/auth/drive
  • https://www.huawei.com/auth/drive.readonly
  • https://www.huawei.com/auth/drive.metadata
  • https://www.huawei.com/auth/drive.metadata.readonly
  • https://www.huawei.com/auth/drive.appdata

接口原型

路径参数

查询参数

请求参数

Request Header

Request Body

无

请求示例

GET 
https://driveapis.cloud.huawei.com.cn/drive/v1/files/BgZ_uIemYqVW0WYk0eNtKVYLMryFlmKjV/historyVersions/362238192574807808.362238192574807809?fields=* HTTP/1.1
Accept: application/json
Authorization: Bearer CgB6e3x9DnEnu88fHJGDstSVqPOjMFJgzsth/HyitN96Fqx0PhaD1V6tTdyBvYdfewqJcD5UJXNoYknEcXwG4c7FTK+lbNT+3BSVbD3GIzAJ/Wzgn65l
Cache-Control: no-cache

响应参数

状态码为200时:

响应示例

HTTP/1.1 200 OK 
{
    "editedTime": "2020-05-14T11:02:38Z",
    "size": 36,
    "sha256": "5b6e8d44920733d30740f5e59b9833e40d81674a02dbdfa2204165d4e338ac7d",
    "lastEditor": {
 "permissionId": "299639512454136576",
 "displayName": "*******3121@**3.com",
 "me": true,
 "category": "drive#user"
 },
    "id": "362238192574807808.362238192574807809",
    "originalFilename":"1.jpg"
    "mimeType": "image/jpeg",
    "category": "drive#historyVersion",
    "keepPermanent": false
}

常见错误码

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

调用示例

   public static void main(String[] args) throws IOException {
        // 设置请求地址,文件ID,历史版本ID和用户认证令牌
        String url = "https://driveapis.cloud.huawei.com.cn/drive/v1/files";
        String fileId = "AB0tr6O8DTQAguUs3yPFt3wQ5SDfLg04A";
        String historyVersionId = "367254548466646784.367254548466646785";
        String access_token = "CV5T547SEXpRlyuxqvz+PnRCtnVu784+OEIXmXAafKC+ifA3eJRnM0Ttsv20bJCkrcA+FNi4bU4nKcbERpQxlkMLQ6/Xt1iEQJYrFMyamnnI9JUV+jz4cQ==";
        // 获取文件历史版版本信息
        JSONObject historyVersionsInfo = historyVersionsGet(url, access_token, fileId, historyVersionId);
        System.out.println(historyVersionsInfo.toJSONString());
    }

    private static JSONObject historyVersionsGet(String url, String access_token, String fileId, String historyVersionId) throws IOException {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append("/").append(fileId).append("/").append("historyVersions").append("/").append(historyVersionId);
        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();
        }
    }