update.wf.phase8_beizhu

好的，下面是为你整理的 接口文档，适用于：

POST /api/project/update.wf.phase8_beizhu

---

📄 接口说明

用于更新项目文档中 workflow_phase.phase8_beizhu 字段的值（备注信息），支持设置为空字符串。

---

🔐 认证方式

• Token 认证
• 请求头中必须携带 Authorization 字段，格式为：

Authorization: token <your_jwt_token>

---

📥 请求方法

POST

---

🌐 请求地址

http://localhost:8004/api/project/update.wf.phase8_beizhu

---

📝 请求头（Headers）

字段名	值	是否必填
Content-Type	application/json	是
Authorization	token <your_jwt_token>	是

---

📥 请求体（Body）

字段名	类型	是否必填	示例值	说明
projectId	String	是	"687eee0a82660066ca258227"	项目的唯一标识
workflow_phase.phase8_beizhu	String	否	"这里是备注信息" 或 ""	可为空字符串

---

✅ 成功响应示例

{
  "message": "备注更新成功",
  "data": {
    "_id": "687eee0a82660066ca258227",
    "workflow_phase": {
      "phase8_beizhu": "这里是备注信息"
    },
    ...
  }
}

---

❌ 错误响应示例

1. 项目ID为空

{
  "error": "项目ID不能为空"
}

2. 项目未找到

{
  "error": "项目未找到"
}

3. 服务器错误

{
  "error": "服务器内部错误"
}

---

🧪 调试命令（使用 httpie）

printf '{
    "projectId": "687eee0a82660066ca258227",
    "workflow_phase.phase8_beizhu": ""
}' | http --follow --timeout 3600 POST 'http://localhost:8004/api/project/update.wf.phase8_beizhu' \
  Content-Type:'application/json' \
  Authorization:'token <token>'

---

✅ 说明补充

• workflow_phase.phase8_beizhu 支持传空字符串 ""
• 更新使用 Mongoose 的 $set 操作符，仅更新指定字段
• 响应返回更新后的完整项目对象

---

如需进一步补充：

• 添加审计日志记录
• 增加字段更新时间戳
• 返回仅部分字段等

也可以告诉我，我可以帮你继续完善接口设计和文档。