使用此端點前,請先完成入門指南以取得您的 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)。

