文档管理中心

Replies:create

功能介绍

创建回复列表。

场景描述

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

使用约束

  • 只有writer/commenter/owner角色可以创建回复。
  • Scope至少包含下面其中一个:
    • https://www.huawei.com/auth/drive.file
    • https://www.huawei.com/auth/drive

接口原型

承载协议

HTTP POST

接口方向

开发者服务器->华为云空间服务器

接口URL

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

数据格式

请求消息:Content-Type: application/json

响应消息:Content-Type: application/json

路径参数

展开

参数

是否必选

参数类型

描述

fileId

string

文件ID。

commentId

string

评论ID。

查询参数

展开

参数

是否必选

参数类型

描述

fields

string

采用[Partial-response格式],具体使用见公共说明。

form

string

媒体格式。

prettyPrint

boolean

是否以美观格式输出。

quotaId

string

用户标识,小于40个字符。用于限制单个用户的API访问数量。

callback

string

JSONP的callback函数。

请求参数

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]。

Request Body

展开

参数

是否必选

参数类型

描述

description

string

回复内容。

operate

string

操作。

请求示例

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/x-www-form-urlencoded  
Authorization: Bearer CV3PnPLZXyr9K2GV7RYZkF962JZvoEkMQhTho3QHQAPQUyma/lEyZskP/IMWrc7FvaeHivO7y0lyibI/fQvulBnTgtXArSVPsjaLKvYNkDsJSaIR2/sx+K40bYDWWpKFvJNKg2U47jRwz2mfiF3ortNk  
Cache-Control: no-cache  
{  
    "description":"HuaweiTest001", 
    "operate":"reopen" 
}

响应参数

状态码为200时:

展开

参数

参数类型

描述

category

string

类型,固定为drive#reply。

id

string

回复id。

createdTime

string

回复创建时间。

editedTime

string

回复修改时间。

creator.category

string

类型,固定为drive#user。

creator.displayName

string

用户显示名。

creator.profilePhotoLink

string

用户头像链接(默认不返回)。

creator.me

boolean

是否是我。

creator.permissionId

string

权限id。

creator.userAccount

string

帐号名称(默认不返回)。

htmlDescription

string

html内容。

description

string

内容。

deleted

boolean

评论回复是否已删除。

operate

string

操作。

响应示例

{ 
    "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" 
}

常见错误码

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

展开

状态码

错误码

响应代码

描述

200

NA

-

成功。

400

21004001

LACK_OF_PARAM

缺少入参,请检查参数列表。

400

21004002

PARAM_INVALID

参数校验失败,请检查参数列表。

403

21004032

SERVICE_NOT_SUPPORT

服务不支持。

403

21004035

INSUFFICIENT_SCOPE

Scope校验失败。

403

21004036

INSUFFICIENT_PERMISSION

角色权限不足。

500

21005006

SERVER_TEMP_ERROR

服务器异常。

403

21074033

AGREEMENT_NOT_SIGNED

用户还未签署华为云空间用户协议,请签署协议后再进行重试。。

403

21084031

DATA_MIGRATING

正处于安全策略更新, 请等待安全策略更新完成。

404

21084041

CONTENT_NOT_FOUND

资源未找到。

500

21085002

OUTER_SERVICE_UNAVAILABLE

服务器异常。

500

21085006

SERVER_TEMP_ERROR

服务器异常。

403

21094038

OUTER_SERVICE_ERROR

服务器异常。

调用示例

    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 commentId = "BlIuT9Ue4I8qnKGDcmf9MUZf5sCpjOCDK";
        String access_token = "CV5T547SEXpRlyuxqvz+PnRCtnVu784+OEIXmXAafKC+ifA3eJRnM0Ttsv20bJCkrcA+FNi4bU4nKcbERpQxlkMLQ6/Xt1iEQJYrFMyamnnI9JUV+jz4cQ==";
        // 创建评论回复
        JSONObject replyInfo = replyCreate(url, access_token, fileId, commentId);
        System.out.println(replyInfo.toJSONString());
    }

    private static JSONObject replyCreate(String url, String access_token, String fileId, String commentId) throws IOException {
        StringBuilder stringBuilder = new StringBuilder("");
        stringBuilder.append(fileId).append("/").append("comments").append("/").append(commentId).append("/").append("replies");
        stringBuilder.append("?").append("fields=*");
        HttpPost httpPost = new HttpPost(url + stringBuilder);
        httpPost.setHeader("Authorization","Bearer " + access_token);
        httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded");
        httpPost.setHeader("Accept", "application/json");

        JSONObject jsonParam = new JSONObject();
        jsonParam.put("description", "HuaweiTest001");
        jsonParam.put("operate", "reopen");

        StringEntity entity = new StringEntity(jsonParam.toString());
        httpPost.setEntity(entity);


        CloseableHttpResponse response = HttpClientUtil.getClient().execute(httpPost);

        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();
        }
    }
在 API参考 中进行搜索
请输入您想要搜索的关键词