批發定價的其他 API 方法

本文說明如何使用公開 API 擷取與刪除批發定價紀錄。

---

擷取批發定價紀錄

1. 端點

若要擷取特定的批發定價紀錄：

GET https://wholesale.samita.io/api/v1/wholesale-pricings/{id}

• {id} 為批發定價紀錄的 ID

• 可從應用程式介面取得 ID
• 使用 ID 時請勿包含「#」符號

範例：

GET https://wholesale.samita.io/api/v1/wholesale-pricings/1

---

2. 請求標頭

所有 GET 請求都必須包含下列必要標頭：

標頭	說明	必填
X-SAMITA-API-KEY	Wholesale 應用程式中提供的 API 金鑰	是
X-SAMITA-SHOP-URL	Shopify 商店網域，格式為 xxx.myshopify.com	是
CONTENT-TYPE	必須為 application/json	是

若缺少任一標頭，請求將會被拒絕。

---

3. 請求內容

• GET API 不需要請求內容
• 只需要網址中的 {id} 參數

---

4. API 回應

錯誤回應

401 – Unauthorized

驗證失敗時會發生此錯誤。

可能原因：

• 缺少商店網址
• 缺少 API 金鑰
• 商店網址不正確
• API 金鑰不正確
• API 金鑰與所提供的商店不符

---

403 – This action is unauthorized

在下列情況會發生此錯誤：

• API 金鑰沒有 View 權限
• 提供的 ID 不存在
• API 金鑰的存取權限不足

每組 API 金鑰可指派下列權限：

• View
• Create
• Update
• Delete

GET API 需要 View 權限。

---

429 – Too Many Requests

超過速率限制時會發生此錯誤。

目前的限制：

• 上限為每 5 分鐘 1 次請求
• 上限為每天 50 次請求

---

成功回應

200 – API Success

• 請求有效
• 已成功擷取紀錄
• 以 JSON 格式傳回回應

範例：

{
  "id": 1,
  "title": "New Wholesale Pricing",
  "status": true,
  "apply_customer": {
    "type": "all",
    "tags": []
  },
  "exclude_customer": {
    "type": "none",
    "tags": []
  },
  "apply_product": {
    "type": "all",
    "product_ids": [],
    "product_tags": [],
    "collection_ids": [],
    "apply_for_variants": false
  },
  "exclude_product": {
    "type": "none",
    "product_ids": [],
    "collection_ids": []
  },
  "discount_for_variants": [
    {
      "id": 8516448190631,
      "variant_pricing": true,
      "variants": [
        {
          "id": 46747346763943,
          "discount_groups": [
            {
              "name": "all",
              "type": "percent",
              "value": "10"
            }
          ]
        }
      ]
    }
  ],
  "apply_market": {
    "type": "all",
    "handle": []
  },
  "discount_group": {
    "type": "percent",
    "value": "10"
  },
  "active_date": {
    "types": [],
    "start_at": "",
    "end_at": ""
  },
  "created_at": "2026-01-15T10:00:00",
  "updated_at": "2026-01-15T10:00:00"
}

---

刪除批發定價紀錄

1. 端點

若要刪除一筆或多筆現有的批發定價紀錄：

DELETE https://wholesale.samita.io/api/v1/wholesale-pricings/{id}

• 網址中的 {id} 應為有效的紀錄 ID，但 API 實際上會刪除 ids 參數中列出的紀錄（見下方請求內容），而不是網址中的該段。

範例：

DELETE https://wholesale.samita.io/api/v1/wholesale-pricings/1

---

2. 請求標頭

所有 DELETE 請求都必須包含下列必要標頭：

標頭	說明	必填
X-SAMITA-API-KEY	Wholesale 應用程式中提供的 API 金鑰	是
X-SAMITA-SHOP-URL	Shopify 商店網域，格式為 xxx.myshopify.com	是
CONTENT-TYPE	必須為 application/json	是

---

3. 請求內容

• 傳入 ids 參數，即以逗號分隔的待刪除紀錄 ID 清單（可作為查詢字串參數或 JSON 內容欄位）。這樣即可在一次呼叫中刪除多筆紀錄，例如 ids=1,2,3。
• 此 ids 參數為必填，缺少時不會刪除任何紀錄。
• 只需要端點網址中的 {id}

---

4. API 回應

錯誤回應

401 – Unauthorized

驗證失敗時傳回。

可能原因：

• 缺少商店網址
• 缺少 API 金鑰
• 商店網址不正確
• API 金鑰不正確
• API 金鑰與商店不符

---

403 – This action is unauthorized

在下列情況會發生此錯誤：

• API 金鑰沒有 Delete 權限
• 提供的 ID 不存在
• API 金鑰沒有足夠的存取權限

DELETE API 需要 Delete 權限。

---

429 – Too Many Requests

請求超過允許的速率限制時傳回。

速率限制：

限制類型	值
請求頻率	每 5 分鐘 1 次請求
每日上限	每天 50 次請求

---

成功回應

200 – API Success

• 批發定價紀錄已成功刪除
• 可能不會傳回內容，或傳回確認訊息

範例：

{
  "success": true
}