Diğer API yöntemleriyle Volume Pricing

Public API’yi kullanarak kimliğe göre tek bir Volume Pricing kaydını alın veya silin.

Bu belge, Public API’yi kullanarak Volume Pricing kayıtlarının nasıl alınacağını ve silineceğini açıklar.

Volume Pricing kaydı alma

1. Uç nokta

Belirli bir Volume Pricing kaydını almak için:

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

{id}, Volume Pricing kaydının kimliğidir

Kimlik, uygulama arayüzünden alınabilir
Kimliği kullanırken “#” simgesini eklemeyin

Örnek:

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

2. İstek üstbilgileri

Tüm GET isteklerinde aşağıdaki zorunlu üstbilgiler bulunmalıdır:

Üstbilgi	Açıklama	Zorunlu
`X-SAMITA-API-KEY`	Wholesale uygulamasında sağlanan API anahtarı	Evet
`X-SAMITA-SHOP-URL`	xxx.myshopify.com biçiminde Shopify mağaza alan adı	Evet
`CONTENT-TYPE`	`application/json` olmalıdır	Evet

Bu üstbilgilerden biri eksikse istek reddedilir.

3. İstek gövdesi

GET API’si istek gövdesi gerektirmez
Yalnızca URL’deki {id} parametresi zorunludur

4. API yanıtı

Hata yanıtları

401 – Unauthorized

Bu hata, kimlik doğrulama başarısız olduğunda oluşur.

Olası nedenler:

Mağaza URL’si eksik
API anahtarı eksik
Mağaza URL’si yanlış
API anahtarı yanlış
API anahtarı belirtilen mağazayla eşleşmiyor

403 – This action is unauthorized

Bu hata şu durumlarda oluşur:

API anahtarında View izni yok
Belirtilen kimlik mevcut değil
API anahtarının erişim hakları yetersiz

Her API anahtarına aşağıdaki izinler atanabilir:

View
Create
Update
Delete

GET API’si View izni gerektirir.

429 – Too Many Requests

Bu hata, hız sınırı aşıldığında oluşur.

Mevcut sınırlar:

5 dakikada en fazla 1 istek
Günde en fazla 50 istek

Başarılı yanıt

200 – API Success

İstek geçerli
Kayıt başarıyla alındı
Yanıt JSON biçiminde döndürülür

Örnek:

{
  "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 kaydı silme

1. Uç nokta

Mevcut bir veya daha fazla Volume Pricing kaydını silmek için:

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

URL’deki {id} geçerli bir kayıt kimliği olmalıdır, ancak API aslında URL bölümünü değil, ids parametresinde listelenen kayıtları siler (aşağıdaki İstek gövdesi bölümüne bakın).