Wholesale Pricing için API’ler

Bu belge, Samita Wholesale uygulamasındaki Wholesale Pricing kayıtlarının listesini almak için Public API’nin nasıl kullanılacağını açıklar.

---

1. Uç nokta

Wholesale Pricing listesini almak için aşağıdaki API uç noktasını kullanın:

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

---

2. İstek üstbilgileri

Tüm API 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 parametreleri (sorgu / gövde)

API isteğini özelleştirmek için aşağıdaki parametreler eklenebilir:

Parametre	Açıklama	Zorunlu
limit	Tek bir istekte döndürülen en fazla kayıt sayısını tanımlar	Hayır
query	Kayıtları başlığa veya kimliğe göre aramak için kullanılır	Hayır
status	Kayıtları durumlarına göre filtrelemek için kullanılır	Hayır
sort	Kayıtları oluşturulma zamanına göre sıralamak için kullanılır	Hayır

a. limit

• Tek bir istekte döndürülen en fazla kayıt sayısını tanımlar
• Sayısal bir değer olmalıdır
• Minimum değer: 1
• Maksimum değer: 20
• İsteğe bağlı parametre
• Boş bırakılırsa varsayılan değer 20 olur

Örnek:

limit=10

---

b. query

• Kayıtları başlığa veya kimliğe göre aramak için kullanılır
• Bir dize değeri olmalıdır
• Maksimum uzunluk: 255 karakter
• İsteğe bağlı parametre

Örnek:

query=pricing rule

---

c. status

• Kayıtları durumlarına göre filtrelemek için kullanılır
• İsteğe bağlı parametre
• Boş bırakılırsa API tüm kayıtları döndürür
• 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

Başka herhangi bir değer reddedilir.

Örnek:

status=active

---

d. sort

• Kayıtları oluşturulma zamanına göre sıralamak için kullanılır
• İsteğe bağlı parametre
• Boş bırakılırsa kayıtlar önce en yeni oluşturulan olacak şekilde sıralanır
• Yalnızca iki değer kabul edilir:

Değer	Açıklama
descrease	Yeniden eskiye sırala
ascrease	Eskiden yeniye sırala

Örnek:

sort=descrease

---

Örnek istek:

GET /wholesale-pricing?page=1&limit=20&status=active&sort=descrease

4. API yanıtı

API, aşağıdaki HTTP durum kodlarından birini döndürür:

a. Hata yanıtları

401 – Unauthorized

Bu hata, istek düzgün şekilde kimlik doğrulamasından geçmediğinde 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, API anahtarının yeterli izni olmadığında oluşur.

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

• View
• Create
• Update
• Delete

Wholesale Pricing List API’si View iznini gerektirir.
API anahtarında View izni yoksa bu hata döndürülür.

---

429 – Too Many Requests

Bu hata, istek izin verilen hız sınırını aştığında oluşur.

Mevcut hız sınırları:

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

Bu sınırlar aşılırsa sistem bu hatayı döndürür.

---

b. Başarılı yanıt

200 – API Success

• İstek geçerli
• Kimlik doğrulama başarılı
• Veriler doğru şekilde döndürülür
• Wholesale Pricing listesi JSON biçiminde sağlanır

---

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

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