POST /nodes/{nodeId}/comments

基本信息

在节点nodeId上创建comments。 您可以在JSON正文中指定comments，如下所示：

{
  "content": "This is a comment"
}

Note: 您可以通过在JSON正文中指定comments列表来创建多个comments，如下所示：

[
  {
    "content": "This is a comment"
  },
  {
    "content": "This is another comment"
  }
]

如果将列表指定为输入，则在响应正文中返回分页列表，而不是条目。 例如：

{
  "list": {
    "pagination": {
      "count": 2,
      "hasMoreItems": false,
      "totalItems": 2,
      "skipCount": 0,
      "maxItems": 100
    },
    "entries": [
      {
        "entry": {
          ...
        }
      },
      {
        "entry": {
          ...
        }
      }
    ]
  }
}

请求方式：POST 

请求API：/nodes/{nodeId}/comments

响应等级（状态201）

成功回应

{
  "entry": {
    "id": "string",
    "title": "string",
    "content": "string",
    "createdBy": {
      "id": "string",
      "firstName": "string",
      "lastName": "string",
      "description": "string",
      "avatarId": "string",
      "email": "string",
      "skypeId": "string",
      "googleId": "string",
      "instantMessageId": "string",
      "jobTitle": "string",
      "location": "string",
      "company": {
        "organization": "string",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "postcode": "string",
        "telephone": "string",
        "fax": "string",
        "email": "string"
      },
      "mobile": "string",
      "telephone": "string",
      "statusUpdatedAt": "2021-01-08T08:52:11.192Z",
      "userStatus": "string",
      "enabled": true,
      "emailNotificationsEnabled": true,
      "aspectNames": [
        "string"
      ],
      "properties": {},
      "capabilities": {}
    },
    "createdAt": "2021-01-08T08:52:11.192Z",
    "edited": true,
    "modifiedBy": {
      "id": "string",
      "firstName": "string",
      "lastName": "string",
      "description": "string",
      "avatarId": "string",
      "email": "string",
      "skypeId": "string",
      "googleId": "string",
      "instantMessageId": "string",
      "jobTitle": "string",
      "location": "string",
      "company": {
        "organization": "string",
        "address1": "string",
        "address2": "string",
        "address3": "string",
        "postcode": "string",
        "telephone": "string",
        "fax": "string",
        "email": "string"
      },
      "mobile": "string",
      "telephone": "string",
      "statusUpdatedAt": "2021-01-08T08:52:11.192Z",
      "userStatus": "string",
      "enabled": true,
      "emailNotificationsEnabled": true,
      "aspectNames": [
        "string"
      ],
      "properties": {},
      "capabilities": {}
    },
    "modifiedAt": "2021-01-08T08:52:11.192Z",
    "canEdit": true,
    "canDelete": true
  }
}

响应内容类型 applicaiton/json

Query参数

名称	类型	是否必填	示例值	描述
fields	Array[string]	否		field名称的list。 例如，如果您想节省整体带宽，则可以使用此参数来限制响应中返回的field。 例如，如果您想节省整体带宽，则可以使用此参数来限制响应中返回的field。 该列表适用于返回的单个实体或集合中的条目。 如果API方法也支持include参数，则除了在fields参数中指定的fields外，还返回include参数中指定的fields。

Path参数

名称	类型	是否必填	示例值	描述
nodeId	string	是		节点的标识符。

Body参数（commentBodyCreate）

request body示例

{
  "content": "string"
}

错误信息描述

状态码	原因
400	无效的参数：commentBodyCreate无效
401	验证失败
403	用户无权创建comments
404	nodeId不存在
405	无法comments此类型的节点
409	nodeId已锁定，您不是锁定所有者
default	意外错误

返回结果示例

{
  "error": {
    "errorKey": "string",
    "statusCode": 0,
    "briefSummary": "string",
    "stackTrace": "string",
    "descriptionURL": "string",
    "logId": "string"
  }
}