Volume Pricing için API’ler

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

---

1. Uç nokta

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

Bu uç nokta, filtreleme ve sıralama parametrelerine göre Volume Pricing kayıtlarının listesini almanızı sağlar.

---

2. İstek üstbilgileri

Tüm isteklerde 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

Zorunlu üstbilgilerden biri eksik veya geçersizse istek reddedilir.

---

3. İstek parametreleri

GET isteği aşağıdaki isteğe bağlı sorgu parametrelerini destekler:

---

a. limit

Döndürülen en fazla kayıt sayısını tanımlar.

• Bir sayı olmalıdır
• Minimum değer: 1
• Maksimum değer: 20
• Boş bırakılırsa varsayılan değer 20’dir

Örnek:

?limit=10

---

b. query

Kayıtları başlığa veya kimliğe göre filtrelemek için kullanılan arama dizesi.

• Bir dize olmalıdır
• Maksimum uzunluk: 255 karakter

Örnek:

?query=pricing rule

---

c. status

Kayıtları duruma göre filtreler.

• Tüm kayıtları almak için boş bırakılabilir

• Belirtilirse yalnızca aşağıdaki değerler kabul edilir:

  Değer	Açıklama
  active	Yalnızca etkin kayıtlar
  draft	Yalnızca taslak kayıtlar

Örnek:

?status=active

---

d. sort

Kayıtları oluşturulma zamanına göre sıralar.

• Boş bırakılabilir (varsayılan: önce en yeni kayıtlar)
• Belirtilirse yalnızca aşağıdaki değerlerden birini kabul eder:
  • descrease
  • ascrease

Örnek:

?sort=descrease

---

Tam istek örneği

GET https://wholesale.samita.io/api/v1/volume-pricings?limit=10&status=active&sort=descrease

---

4. API yanıtı

---

4.1 Hata yanıtları

401 – Unauthorized

Kimlik doğrulama başarısız olduğunda döndürülür.

Olası nedenler:

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

---

403 – This action is unauthorized

API anahtarının yeterli izni olmadığında döndürülür.

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

• View
• Create
• Update
• Delete

List Volume Pricing API, View izni gerektirir.

---

429 – Too Many Requests

Hız sınırı aşıldığında döndürülür.

Mevcut sınırlar:

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

---

4.2 Başarılı yanıt

200 – API Success

İstek geçerli olduğunda ve başarıyla işlendiğinde döndürülür.

Yanıt, Volume Pricing kayıtlarının listesini JSON biçiminde döndürür.

---

Başarılı API örneği:

[
  {
    "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"
  }
]