その他の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	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 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. エンドポイント

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

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

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

例:

DELETE https://wholesale.samita.io/api/v1/wholesale-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パラメーターは必須です。指定しない場合、レコードは削除されません。
• エンドポイントURL内の{id}のみ必須です

---

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
}