Create Memo Comment

POST /api/v1/memos/{memo}/comments

MemoService · MemoService_CreateMemoComment

基于协议生成的参考。授权与实例策略仍然生效。结构描述继承自 MIT 许可的应用接口定义；本站不会向真实服务执行示例。

访问权限

需要账号认证。在空间内创建或参与已有笔记时还会检查归属与读取权限；认证本身不代表可以修改他人的笔记。

评论有独立生命周期

请求体是 Memo，不使用 comment 包装。创建时会向 URL 中的父笔记添加不可变 COMMENT 上下文关系。请明确设置评论自己的可见性和可选 space，它不会继承父笔记的归属或受众。父笔记必须可读且允许参与。即时创建响应可能省略 parent；后续 GetMemo 会补全关系。

创建时忽略 state 与 pinned

共享 Memo 结构包含 state 和 pinned，但创建操作不会写入这两个字段。即使请求提交 ARCHIVED 或 pinned: true，新笔记或评论仍以 NORMAL 状态创建且不置顶。应先创建记录，再按需要通过 UpdateMemo 的 state 或 pinned 更新掩码修改。不要把可复用结构中的每个字段都视为创建时会接受的输入。

请求

CreateMemoComment atomically creates an independent memo plus one immutable COMMENT context relation to the named memo. The new memo keeps its own placement, visibility, authorship, and lifecycle.

POST/api/v1/memos/{memo}/comments

参数

名称 / 位置	类型 / 是否必需	描述
`memo` path	string 必需	The memo id.
`commentId` query	string OpenAPI 未标记为必需	Optional. The comment ID to use.

请求体

必需

application/json · Memo

响应

200 · OK

application/json · Memo

default · Default error response

application/json · Status

完整操作定义

下方保留全部已声明约束、媒体类型和响应细节。结构引用链接到完整定义。

展开 JSON 定义

{
  "tags": [
    "MemoService"
  ],
  "description": "CreateMemoComment atomically creates an independent memo plus one immutable\n COMMENT context relation to the named memo. The new memo keeps its own\n placement, visibility, authorship, and lifecycle.",
  "operationId": "MemoService_CreateMemoComment",
  "parameters": [
    {
      "name": "memo",
      "in": "path",
      "description": "The memo id.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "commentId",
      "in": "query",
      "description": "Optional. The comment ID to use.",
      "schema": {
        "type": "string"
      }
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/Memo"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Memo"
          }
        }
      }
    },
    "default": {
      "description": "Default error response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Status"
          }
        }
      }
    }
  }
}