discussions

# 讨论 API ## 概述 讨论 API 支持对协议进行协作评论。评论可以在协议级别和单个步骤级别添加，并支持嵌套回复、编辑和删除。 ## 基础 URL 所有讨论端点均使用基础 URL：`https://protocols.io/api/v3` ## 协议级别评论 ### 列出协议评论 检索协议的所有评论。 **端点：** `GET /protocols/{protocol_id}/comments` **路径参数：** - `protocol_id`: 协议的唯一标识符 **查询参数：** - `page_size`: 每页结果数 (默认：10，最大：50) - `page_id`: 分页页码 (从 0 开始) **响应包含：** - 评论 ID 和内容 - 作者信息（姓名、所属机构、头像） - 时间戳（创建和修改时间） - 回复数量和线程结构 ### 创建协议评论 为协议添加新评论。 **端点：** `POST /protocols/{protocol_id}/comments` **请求体：** - `body` (必需)：评论文本（支持 HTML 或 Markdown） - `parent_comment_id` (可选)：用于嵌套回复的父评论 ID **请求示例：** bash curl -X POST -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" -d '{ "body": "This protocol worked excellently for our CRISPR experiments. We achieved 85% editing efficiency." }' "https://protocols.io/api/v3/protocols/12345/comments" ### 创建嵌套回复 要回复现有评论，请包含父评论 ID： bash curl -X POST -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" -d '{ "body": "What cell type did you use?", "parent_comment_id": 67890 }' "https://protocols.io/api/v3/protocols/12345/comments" ### 更新评论 编辑您自己的评论。 **端点：** `PATCH /protocols/{protocol_id}/comments/{comment_id}` **请求体：** - `body` (必需)：更新后的评论文本 **授权**：仅评论作者可以编辑其评论 ### 删除评论 删除评论。 **端点：** `DELETE /protocols/{protocol_id}/comments/{comment_id}` **授权**：仅评论作者可以删除其评论 **注意**：删除父评论可能会影响整个讨论线程，具体取决于 API 实现 ## 步骤级别评论 ### 列出步骤评论 检索特定协议步骤的所有评论。 **端点：** `GET /protocols/{protocol_id}/steps/{step_id}/comments` **路径参数：