目录

评论回复

场景介绍

华为云空间服务支持用户对云端文件的评论进行回复,并对回复进行查看、更新和删除操作。

创建评论回复

功能简介

Replies.create接口实现创建对某个评论的回复。

限制

发送一个创建评论回复的请求

  1. 创建一个对Replies.create接口的POST请求。
  2. 添加查询参数fileId、commentId和fields。

    例如:

    POST https://driveapis.cloud.huawei.com.cn/drive/v1/files/{fileId}/comments/{commentId}/replies?fields=*

  3. 填入HTTP headers。

    • Accept:接收回复的报文格式
    • Content-Type:发送报文格式
    • Cache-Control:缓存控制
    • Authorization:填入从华为帐号获取的authorization code

  4. 发送请求。

    请求示例:
    POST https://driveapis.cloud.huawei.com.cn/drive/v1/files/AAAB9Wn0DTQCIqPbW9avGjAQo9dbxg04A/comments/BkytC_85-y5hoiLxCRnNCHZcDynNC_siY/replies?fields=* HTTP/1.1 
    Accept: application/json 
    Content-Type: application/json 
    Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk 
    Cache-Control: no-cache 
    
    { 
        "description":"HuaweiTest001",
        "operate":"reopen"
    }

    响应:

    HTTP/1.1 200 OK 
    {
        "creator": {
            "permissionId": "299639512454136576",
            "displayName": "*******3121@**3.com",
            "me": true,
            "category": "drive#user"
        },
        "editedTime": "2020-02-19T13:49:32.862Z",
        "operate": "reopen",
        "deleted": false,
        "createdTime": "2020-02-19T13:49:32.862Z",
        "description": "HuaweiTest001",
        "id": "BpMy9fyvWDfDM2rRKzfpNbqDkNfOnVg7w",
        "category": "drive#reply",
        "htmlDescription": "HuaweiTest001"
    }

获取评论回复

功能简介

Replies.get接口实现获取某个回复的内容信息。

限制

发送一个获取评论回复的请求

  1. 创建一个对Replies.get接口的GET请求。
  2. 添加查询参数fileId、commentId、replyId和fields。

    例如:

    GET https://driveapis.cloud.huawei.com.cn/drive/v1/files/{fileId}/comments/{commentId}/replies/{replyId}?fields=*

  3. 填入HTTP headers。

    • Accept:接收回复的报文格式
    • Cache-Control:缓存控制
    • Authorization:填入从华为帐号获取的authorization code

  4. 发送请求。

    请求示例:
    GET https://driveapis.cloud.huawei.com.cn/drive/v1/files/AAAB9Wn0DTQCIqPbW9avGjAQo9dbxg04A/comments/BkytC_85-y5hoiLxCRnNCHZcDynNC_siY/replies/BpMy9fyvWDfDM2rRKzfpNbqDkNfOnVg7w?fields=* HTTP/1.1 
    Accept: application/json 
    Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk 
    Cache-Control: no-cache 

    响应:

    HTTP/1.1 200 OK 
    {
        "creator": {
            "permissionId": "299639512454136576",
            "displayName": "*******3121@**3.com",
            "me": true,
            "category": "drive#user"
        },
        "editedTime": "2020-02-19T13:49:32.862Z",
        "operate": "reopen",
        "deleted": false,
        "createdTime": "2020-02-19T13:49:32.862Z",
        "description": "HuaweiTest001",
        "id": "BpMy9fyvWDfDM2rRKzfpNbqDkNfOnVg7w",
        "category": "drive#reply",
        "htmlDescription": "HuaweiTest001"
    }

获取评论回复列表

功能简介

Replies.list接口实现列出所有对某个评论的回复,用户可以根据pageSize的设定获取需要的页面大小等。

限制

说明

includeDeleted参数功能暂时不支持使用。

发送一个获取评论回复列表的请求

  1. 创建一个对Replies.list接口的GET请求。
  2. 添加查询参数fileId、commentId和fields。

    例如:

    GET https://driveapis.cloud.huawei.com.cn/drive/v1/files/{fileId}/comments/{commentId}/replies?fields=*

  3. 填入HTTP headers。

    • Accept: 接收回复的报文格式
    • Cache-Control: 缓存控制
    • Authorization: 填入从华为帐号获取的authorization code

  4. 发送请求。

    请求示例:
    GET https://driveapis.cloud.huawei.com.cn/drive/v1/files/AAAB9Wn0DTQCIqPbW9avGjAQo9dbxg04A/comments/BkytC_85-y5hoiLxCRnNCHZcDynNC_siY/replies?fields=* HTTP/1.1 
    Accept: application/json 
    Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk 
    Cache-Control: no-cache 

    响应:

    HTTP/1.1 200 OK 
    {
        "nextCursor": "BCCDAB44ACDFA4D6EA0E435F3A7560EF0",
        "replies": [
            {
                "creator": {
                    "permissionId": "299639512454136576",
                    "displayName": "*******3121@**3.com",
                    "me": true,
                    "category": "drive#user"
                },
                "editedTime": "2020-02-19T13:56:31Z",
                "operate": "reopen",
                "deleted": false,
                "createdTime": "2020-02-19T13:56:31Z",
                "description": "HuaweiTest003",
                "id": "Bv_vRsfoUCBJmbCvafSFNQrvTWT12lAsS",
                "category": "drive#reply",
                "htmlDescription": "HuaweiTest003"
            },
            {
                "creator": {
                    "permissionId": "299639512454136576",
                    "displayName": "*******3121@**3.com",
                    "me": true,
                    "category": "drive#user"
                },
                "editedTime": "2020-02-19T13:56:26Z",
                "operate": "reopen",
                "deleted": false,
                "createdTime": "2020-02-19T13:56:26Z",
                "description": "HuaweiTest002",
                "id": "BvGxpclcpKkC2hMquGAZI4bhE4f7bqSlA",
                "category": "drive#reply",
                "htmlDescription": "HuaweiTest002"
            },
            {
                "creator": {
                    "permissionId": "299639512454136576",
                    "displayName": "*******3121@**3.com",
                    "me": true,
                    "category": "drive#user"
                },
                "editedTime": "2020-02-19T13:49:33Z",
                "operate": "reopen",
                "deleted": false,
                "createdTime": "2020-02-19T13:49:33Z",
                "description": "HuaweiTest001",
                "id": "BpMy9fyvWDfDM2rRKzfpNbqDkNfOnVg7w",
                "category": "drive#reply",
                "htmlDescription": "HuaweiTest001"
            }
        ],
        "category": "drive#replyList"
    }

删除评论回复

功能简介

Replies.delete接口实现删除某条回复。

限制

发送一个删除评论回复的请求

  1. 创建一个对Replies.delete接口的DELETE请求。
  2. 添加查询参数fileId、commentId、replyId。

    例如:

    DELETE https://driveapis.cloud.huawei.com.cn/drive/v1/files/{fileId}/comments/{commentId}/replies/{replyId}

  3. 填入HTTP headers。

    • Cache-Control:缓存控制
    • Authorization:填入从华为帐号获取的authorization code

  4. 发送请求。

    请求示例:
    DELETE https://driveapis.cloud.huawei.com.cn/drive/v1/files/AAAB9Wn0DTQCIqPbW9avGjAQo9dbxg04A/comments/BkytC_85-y5hoiLxCRnNCHZcDynNC_siY/replies/BpMy9fyvWDfDM2rRKzfpNbqDkNfOnVg7w HTTP/1.1 
    Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk 
    Cache-Control: no-cache 

    响应:

    HTTP/1.1 204 OK

修改评论回复

功能简介

Replies.update接口实现对回复内容进行更新。

限制

发送一个修改评论回复的请求

  1. 创建一个对Replies.update接口的PATCH请求。
  2. 添加查询参数fileId、commentId、replyId和fields。

    例如:

    PATCH https://driveapis.cloud.huawei.com.cn/drive/v1/files/{fileId}/comments/{commentId}/replies/{replyId}?fields=*

  3. 填入HTTP headers。

    • Accept:接收回复的报文格式
    • Content-Type:发送报文格式
    • Cache-Control:缓存控制
    • Authorization:填入从华为帐号获取的authorization code

  4. 发送请求。

    请求示例:
    PATCH https://driveapis.cloud.huawei.com.cn/drive/v1/files/AAAB9Wn0DTQCIqPbW9avGjAQo9dbxg04A/comments/BkytC_85-y5hoiLxCRnNCHZcDynNC_siY/replies/BpMy9fyvWDfDM2rRKzfpNbqDkNfOnVg7w?fields=* HTTP/1.1 
    Accept: application/json 
    Content-Type: application/json 
    Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk 
    Cache-Control: no-cache 
    
    { 
        "description":"HuaweiTest011",
        "operate":"reopen"
    }

    响应:

    HTTP/1.1 200 OK 
    {
        "creator": {
            "permissionId": "299639512454136576",
            "displayName": "*******3121@**3.com",
            "me": true,
            "category": "drive#user"
        },
        "editedTime": "2020-02-19T13:49:32.862Z",
        "operate": "reopen",
        "deleted": false,
        "createdTime": "2020-02-19T13:49:32.862Z",
        "description": "HuaweiTest011",
        "id": "BpMy9fyvWDfDM2rRKzfpNbqDkNfOnVg7w",
        "category": "drive#reply",
        "htmlDescription": "HuaweiTest001"
    }