その他のAPIメソッドでのVolume Pricing

公開APIを使って、IDを指定して数量割引価格レコードを1件取得または削除します。

このドキュメントでは、公開APIを使って数量割引価格レコードを取得および削除する方法を説明します。

数量割引価格レコードを取得する

1. エンドポイント

特定の数量割引価格レコードを取得するには、次のエンドポイントを使用します。

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

{id}は数量割引価格レコードのIDです

IDはアプリの画面で確認できます
IDを使用するときは、「#」記号を含めないでください

例：

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

2. リクエストヘッダー

すべてのGETリクエストに、次の必須ヘッダーを含める必要があります。

ヘッダー	説明	必須
`X-SAMITA-API-KEY`	Wholesaleアプリで発行されたAPIキー	はい
`X-SAMITA-SHOP-URL`	xxx.myshopify.com形式のShopifyストアドメイン	はい
`CONTENT-TYPE`	`application/json`を指定する必要があります	はい

これらのヘッダーが1つでも欠けている場合、リクエストは拒否されます。

3. リクエストボディ

GET APIはリクエストボディを必要としません
URLの{id}パラメーターのみが必要です

4. APIレスポンス

エラーレスポンス

401 – Unauthorized（認証エラー）

このエラーは、認証に失敗した場合に発生します。

考えられる原因：

ストアURLが指定されていない
APIキーが指定されていない
ストアURLが正しくない
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リクエスト
最大1日あたり50リクエスト

成功レスポンス

200 – API Success（成功）

リクエストが有効である
レコードが正常に取得される
レスポンスはJSON形式で返される

例：

{
  "id": 1,
  "title": "New Volume Pricing",
  "status": true,
  "type": "quantity",
  "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,
      "duplicated": false,
      "variant_pricing": true,
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "discount_groups": [
        {
          "name": "all",
          "type": "percent",
          "value": "10"
        }
      ],
      "variants": [
        {
          "id": 46747346763943,
          "duplicated": false,
          "from_qty": "0",
          "from_amount": "0",
          "to_qty": "10",
          "to_amount": "0",
          "discount_groups": [
            {
              "name": "all",
              "type": "percent",
              "value": "10"
            }
          ]
        }
      ]
    }
  ],
  "apply_market": {
    "type": "all",
    "handle": []
  },
  "discount_method": "variant",
  "discount_groups": [
    {
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "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. エンドポイント

既存の数量割引価格レコードを1件または複数削除するには、次のエンドポイントを使用します。

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

URLの{id}は有効なレコードIDである必要がありますが、APIが実際に削除するのは、URLの値ではなく、**ids**パラメーター（下のリクエストボディをご覧ください）に指定されたレコードです。

例：

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

2. リクエストヘッダー

すべてのDELETEリクエストに、次の必須ヘッダーを含める必要があります。

ヘッダー	説明	必須
`X-SAMITA-API-KEY`	Wholesaleアプリで発行されたAPIキー	はい
`X-SAMITA-SHOP-URL`	xxx.myshopify.com形式のShopifyストアドメイン	はい
`CONTENT-TYPE`	`application/json`を指定する必要があります	はい

3. リクエストボディ

**ids**パラメーターを渡します。削除するレコードIDをカンマ区切りで指定したリストで、クエリ文字列パラメーターまたはJSONボディのフィールドとして指定します。1回の呼び出しで複数のレコードを削除できます（例：ids=1,2,3）。
このidsパラメーターは必須です。指定しない場合、レコードは削除されません。

4. APIレスポンス

エラーレスポンス

401 – Unauthorized（認証エラー）

認証に失敗した場合に返されます。

考えられる原因：

ストアURLが指定されていない
APIキーが指定されていない
ストアURLが正しくない
APIキーが正しくない
APIキーがストアと一致しない

403 – This action is unauthorized（この操作は許可されていません）

このエラーは、次の場合に発生します。

APIキーにDelete権限がない
指定されたIDが存在しない
APIキーのアクセス権限が不足している

DELETE APIにはDelete権限が必要です。

429 – Too Many Requests（リクエストが多すぎます）

リクエストが許可されたレート制限を超えた場合に返されます。

レート制限：

制限の種類	値
リクエスト頻度	5分あたり1リクエスト
1日の上限	1日あたり50リクエスト

成功レスポンス

200 – API Success（成功）

数量割引価格レコードが正常に削除される
コンテンツなし、または確認メッセージが返される場合がある

例：

{
  "success": true
}

このページは役に立ちましたか？