Diğer API yöntemleriyle toptan fiyatlandırma

Public API ile kimliğe göre tek bir Wholesale Pricing kaydını alın veya silin.

Bu belgede Public API ile Wholesale Pricing kayıtlarının nasıl alınacağı ve silineceği açıklanmaktadır.

Wholesale Pricing kaydını alma

1. Uç nokta

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

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

{id}, Wholesale 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/wholesale-pricings/1

2. İstek üstbilgileri

Tüm GET istekleri aşağıdaki zorunlu üstbilgileri içermelidir:

Üstbilgi	Açıklama	Zorunlu
`X-SAMITA-API-KEY`	Wholesale uygulamasında verilen 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 için istek gövdesi gerekmez
Yalnızca URL’deki {id} parametresi zorunludur

4. API yanıtı

Hata yanıtları

401 – Yetkisiz

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 – Bu işlem için yetki yok

Bu hata şu durumlarda oluşur:

API anahtarının View izni yok
Girilen 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 için View izni gerekir.

429 – Çok fazla istek

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

Geçerli sınırlar:

En fazla 5 dakikada 1 istek
En fazla günde 50 istek

Başarılı yanıt

200 – API başarılı

İ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 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"
}

Wholesale Pricing kaydını silme

1. Uç nokta

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

DELETE https://wholesale.samita.io/api/v1/wholesale-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).