Sipariş Listesi · Bulbulustur Developers

Siparişleri Listeleme

GET /api/orders

API anahtarına bağlı B2C mağazanın siparişlerini en yeni tarihten başlayarak sayfalı listeler.

Parametreler

pageinteger · Opsiyonel · Query

Varsayılan 1; en küçük 1.

sizeinteger · Opsiyonel · Query

Varsayılan 50; aralık 1–100.

Mağaza kapsamı

Mağaza, API anahtarına göre belirlenir. URL'de storeId gönderilmez.

Sonraki sayfa için ?page=2&size=50 kullanın. totalPageCount son sayfayı gösterir. Yanıt: 200 OK; yetkisiz 401; limit 429.

cURLGET /api/orders

curl --request GET \
  'https://developers.bulbulustur.com/api/orders?page=1&size=1' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'X-Api-Secret: YOUR_API_SECRET' \
  --header 'Accept: application/json'

Örnek, ilk sayfadan bir sipariş döndürür.

Liste Yanıtı

StoreOrder V1 · Sayfalama

data.items içindeki her öğe StoreOrder modelidir; count bu sayfada dönen sipariş sayısı, totalItemCount toplam sipariş sayısıdır.

StoreOrder V1 alanları

Alan açıklamaları

orderStoreId

Mağazanın sipariş kaydı kimliği.

orderId

Siparişin sistem kimliği.

orderKey

Sipariş detayının sorgulanmasında kullanılan anahtar.

orderDate

Sipariş oluşturulma tarihi.

orderStoreStatusId

Mağazaya ait sipariş durum kimliği.

storeGrandTotal

Mağazanın sipariş genel toplamı.

storeTotalNetPrice

Mağazanın net toplamı.

storeTotalVat

Mağazanın KDV toplamı.

storeTotalShipping

Mağazanın kargo toplamı.

Şema tipleri ve null bilgisi yayımlanan OpenAPI V1 sürümünden okunur.

JSON · 200 OKSandbox, size=1

{
  "data": {
    "items": [
      {
        "orderStoreId": 1001,
        "orderId": 1001,
        "orderKey": "sandbox-order-1001",
        "orderDate": "2026-11-02T00:00:00Z",
        "orderStoreStatusId": 1,
        "storeGrandTotal": 199.9,
        "storeTotalNetPrice": 199.9,
        "storeTotalVat": 0,
        "storeTotalShipping": 0
      }
    ],
    "pageNumber": 1,
    "pageSize": 1,
    "totalItemCount": 3,
    "totalPageCount": 3
  },
  "count": 1
}

Sandbox verilerinden türetilmiş gösterimdir; genel Result meta alanları gösterilmez. Tarih örnek isteğin yapıldığı günün UTC tarihini temsil eder.