Quartz 5

POST__quote_bids__change_status__reviews__quote_bid_id

3 min read

POST /quote_bids/change_status/reviews/{quote_bid_id}.json

type: api_detail
status: observed
last_verified: 2026-05-14
environment: staging
method: POST
host: https://api-staging.pro360.com.tw
path: /quote_bids/change_status/reviews/{quote_bid_id}.json

這支 API 回答什麼

consumer 或 provider 對 quote bid 對方留下評價。前端目前在案件聊天詳情頁送出 provider 評價時會呼叫這支 API。

出現位置

類型文件備註
頁面../頁面/dashboard__projects_quote_detailconsumer 的案件聊天詳情頁
操作../操作/quote_bid__submit_or_update_review新增或更新 provider 評價

觸發方式

簡要觸發路徑：

案件聊天詳情頁 -> 更多 -> 評論專家 -> 送出評價表單

完整前端步驟與截圖見 ../操作/quote_bid__submit_or_update_review。

Request

Headers

Header是否必要備註
X-PRO360-Rest-Api-Key是文件中不要暴露非公開 key
X-PRO360-User-Session-Token是文件中遮蔽
Content-Type: multipart/form-data是browser 會帶 boundary
Originbrowser CORSstaging 前端為 https://staging.pro360.com.tw

Body

欄位型別是否必要前端來源備註
is_satisfiedint/string是星等選擇一般評價流程必填
feedbackstring否評價文字輸入可為中文
tag[]array否評價 tag 選項後端會存 JSON
FeedbackAttachment[]array否上傳附件 URL後端最多取 3 張，且只接受 allowlist CloudFront URL

前端可觸發條件

目前觀測：評論專家 入口只會在 consumer 已確認雇用該 provider 後出現。

後端 guard 仍會檢查：

  • actor 必須是 requestor 或 provider。
  • quote_bids.is_want_to_contact_provider = 1。
  • 一般 review 必須有 is_satisfied。

Response

Success

Legacy-compatible response shape：

{
  "status": "Success"
}

注意：不要自行新增 error:0。這支 legacy reviews 一般成功沒有 error 欄位。

Error

未聯繫 provider 前評價：

{
  "error": 19,
  "status": "您必須先與專家聯繫後才能評價專家"
}

缺少一般評價必要欄位：

{
  "status": "error"
}

前端如何使用 Response

  • 成功時以前端畫面更新評價卡片。
  • 目前 migration 需要維持 legacy response shape。
  • 不能以 error 是否存在當成功必要條件，因為成功 response 不包含 error。

Routing / Origin

2026-05-14 staging 驗證：

server: nginx/1.18.0
x-php-env: php82-staging-1
x-pro360: 99

LB / CloudFront path rule 應切：

/quote_bids/change_status/reviews/*

不要切整包：

/quote_bids/change_status/*

DB / Side Effect

主要 side effect：

  • quote_feedbacks
  • quote_feedback_attachments
  • quote_activities
  • event_queue 或 event_queue_log_1 到 event_queue_log_4
  • 低分評價會有 badReview admin email 與 mute match

2026-05-14 實測：

quote_bid_id = 2147686109
quote_feedbacks.id = 2031
quote_feedback_attachments.id = 116
event_queue_log_4.event_key = Update_Review
event_queue_log_4.status_id = 1

相關文件

Graph View

Backlinks