다른 API 메서드로 수량별 가격 관리

공개 API를 사용해 ID로 Volume Pricing 레코드 하나를 조회하거나 삭제하세요.

이 문서에서는 공개 API를 사용해 Volume Pricing 레코드를 조회하고 삭제하는 방법을 설명해요.

Volume Pricing 레코드 조회

1. 엔드포인트

특정 Volume Pricing 레코드를 조회하려면 다음과 같이 하세요.

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

{id}는 Volume Pricing 레코드의 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`이어야 해요	예

이 헤더 중 하나라도 누락되면 요청이 거부돼요.

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회 요청
최대 하루 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"
}

Volume Pricing 레코드 삭제

1. 엔드포인트

기존 Volume Pricing 레코드를 하나 이상 삭제하려면 다음과 같이 하세요.

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. 요청 본문

삭제할 레코드 ID를 쉼표로 구분한 목록인 ids 파라미터를 쿼리 문자열 파라미터 또는 JSON 본문 필드로 전달하세요. 이렇게 하면 한 번의 호출로 여러 레코드를 삭제할 수 있어요(예: 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회 요청
일일 제한	하루 50회 요청

성공 응답

200 – API Success

Volume Pricing 레코드가 성공적으로 삭제되었어요
내용이 없거나 확인 메시지가 반환될 수 있어요

예시:

{
  "success": true
}

도움이 되었나요?