使用此端点之前,请完成入门指南以获取您的 API 密钥和公司 ID。
前提条件
- ✅ 已批准工作区成员的有效 Bearer 令牌
- ✅ 从
GET {{URL}}/accounts/companies获取的公司 ID - ✅ 您要更新的订单的订单 ID(项目 ID,
pid)
端点
multipart/form-data — 即使没有附件文件,也请使用此格式以满足服务器的 multipart 解析器要求。
标头
查询参数
请求主体字段
订单的新状态。必须为以下之一:
Pending、Ongoing、Review、Completed、Cancelled。允许的状态转换:Review只能在Ongoing或另一个Review之后设置。从Pending直接跳转到Review将返回400 ValidationError。- 已处于
Completed或Cancelled状态的订单无法更新。 - 客户无法取消已超过
Pending状态的订单。
示例请求
响应
成功响应
业务规则和副作用
- 状态转换受到限制。
Review只能在Ongoing或另一个Review之后设置。尝试Pending → Review将返回400 ValidationError。 - 将状态从
Pending变更为Ongoing、Review或Completed会激活订单的文件文件夹,使上传的文件对项目团队可访问。 - 将
status设置为Completed或Cancelled需要将markTasksAsDone明确设置为true或false。 - 状态变更为
Review、Completed或Cancelled会自动触发客户通知:- Review — 通知客户需要进行审查。
- Completed — 向客户发送
orderCompletion通知。 - Cancelled — 向客户发送
orderCancellation通知。
- 每次成功更新都会触发一个
ORDER.UPDATEDWebhook 事件,附带更新后的订单文档和附件元数据(前提是您有订阅该事件的有效 Webhook)。

