Create Ch02 Default Order
建立商品類型為 Ch02 Default 的訂單。
Endpoint
| Item | Value |
|---|---|
| Method | POST |
| Path | /platform/order/ch2/default |
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 |
|---|---|---|---|
quantity | integer(int32) | No | 數量。範圍 1 到 10000000。 |
runs | integer(int32) | No | 分次處理次數。範圍 1 到 10000000。 |
interval_minutes | integer(int32) | No | 分次處理時間間隔，單位為分鐘。範圍 1 到 10000000。 |
link | string(uri) | Conditional | 貼文連結。產品類別不是 instagram_story 時必填，且不可與 username 同時有值。 |
username | string | Conditional | 使用者名稱。產品類別是 instagram_story 時必填，且不可與 link 同時有值。 |
product_id | string(uuid) | No | 商品 ID。 |
{
"quantity": 10,
"runs": 2,
"interval_minutes": 30,
"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-202606020002",
"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 欄位格式或條件不符合合約。 | 檢查 quantity、runs、interval_minutes 範圍與 URI/UUID 格式。 |
400 | conflicting_parameters | link 與 username 同時有值。 | 依產品類別只填其中一個欄位。 |
400 | below_minimum_quantity | 數量低於產品設定的最小值。 | 先查詢產品 min，再送出符合範圍的數量。 |
400 | exceeds_maximum_quantity | 數量高於產品設定的最大值。 | 先查詢產品 max，再送出符合範圍的數量。 |
401 | token_validation_failed | private key 缺漏或無效。 | 確認 x-api-key header，必要時聯繫客服重新申請。 |
Examples
curl -X POST "https://api.guo-guo.com/platform/order/ch2/default" \
-H "x-api-key: <private_key>" \
-H "Content-Type: application/json" \
-d '{"quantity":10,"runs":2,"interval_minutes":30,"link":"https://example.com/posts/abc123","product_id":"9c07a89a-0994-4f35-98a7-1b922b5c8331"}'