Create Ch02 Custom Comments Order

建立商品類型為 Ch02 Custom Comments 的訂單。

Endpoint

Item	Value
Method	POST
Path	/platform/order/ch2/custom-comments

Authentication

資訊

此 endpoint 需要在 request header 帶入 x-api-key。private key 請聯繫客服申請。

Request

Headers

Header	Required	Description
x-api-key	Yes	請聯繫客服申請 private key。
Content-Type	Yes	固定使用 application/json。

Body

Field	Type	Required	Description
comments	string	No	留言內容。
link	string(uri)	No	貼文連結。
product_id	string(uuid)	No	商品 ID。

{
  "comments": "Great post!\nThanks for sharing.",
  "link": "https://example.com/posts/abc123",
  "product_id": "9c07a89a-0994-4f35-98a7-1b922b5c8331"
}

Response

Success Response

成功時回傳 200 OK 與 OrderResponse。

{
  "order_id": "2fe533a2-8787-4a61-a4a4-5ce049d59658",
  "order_number": "ORD-202606020004",
  "payment_type": "credit",
  "order_status": "establish",
  "payment_status": "complete",
  "total": 120,
  "order_detail": [],
  "create_date_time": "2026-06-02T12:30:00+08:00",
  "update_date_time": null
}

Error Responses

HTTP Status	Code	Meaning	How to Fix
400	data_validation_failed	Request body 欄位格式不符合合約。	檢查 comments、link、product_id。
400	string_length_out_of_range	留言內容長度超出 API 限制。	調整 comments 長度後重試。
401	token_validation_failed	private key 缺漏或無效。	確認 x-api-key header，必要時聯繫客服重新申請。

Examples

curl -X POST "https://api.guo-guo.com/platform/order/ch2/custom-comments" \
  -H "x-api-key: <private_key>" \
  -H "Content-Type: application/json" \
  -d '{"comments":"Great post!\nThanks for sharing.","link":"https://example.com/posts/abc123","product_id":"9c07a89a-0994-4f35-98a7-1b922b5c8331"}'

References

• Authentication
• CreateCh02CustomCommentOrderRequest
• OrderResponse
• Error Codes