跳至主要内容

Create Ch02 Comment Likes Order

建立商品類型為 Ch02 Comment Likes 的訂單。

Endpoint

ItemValue
MethodPOST
Path/platform/order/ch2/comment-likes

Authentication

資訊

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

Request

Headers

HeaderRequiredDescription
x-api-keyYes請聯繫客服申請 private key。
Content-TypeYes固定使用 application/json

Body

FieldTypeRequiredDescription
quantityinteger(int32)No數量。範圍 110000000
usernamestringNo被按讚的帳號。
linkstring(uri)No貼文連結。
product_idstring(uuid)No商品 ID。
{
"quantity": 10,
"username": "sample_user",
"link": "https://example.com/posts/abc123",
"product_id": "9c07a89a-0994-4f35-98a7-1b922b5c8331"
}

Response

Success Response

成功時回傳 200 OKOrderResponse

{
"order_id": "2fe533a2-8787-4a61-a4a4-5ce049d59658",
"order_number": "ORD-202606020003",
"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 StatusCodeMeaningHow to Fix
400data_validation_failedRequest body 欄位格式或數值範圍不符合合約。檢查 quantity 範圍、link URI 格式與 product_id UUID 格式。
400credit_not_enough組織信用點數不足。補足信用點數後重新建立訂單。
401token_validation_failedprivate key 缺漏或無效。確認 x-api-key header,必要時聯繫客服重新申請。

Examples

curl -X POST "https://api.guo-guo.com/platform/order/ch2/comment-likes" \
-H "x-api-key: <private_key>" \
-H "Content-Type: application/json" \
-d '{"quantity":10,"username":"sample_user","link":"https://example.com/posts/abc123","product_id":"9c07a89a-0994-4f35-98a7-1b922b5c8331"}'

References