İade Listesi · Bulbulustur Developers

İade Taleplerini Listeleme

GET /api/returns

API anahtarının bağlı olduğu mağazaya gelen iade taleplerini tarihe göre yeniden eskiye doğru sayfalı listeler. Yalnızca okuma işlemidir.

Parametreler

pageinteger · Opsiyonel · Query

Varsayılan 1; minimum 1.

sizeinteger · Opsiyonel · Query

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

Mağaza kapsamı

Yalnız API anahtarınıza bağlı mağazanın iade talepleri görüntülenir. storeId parametresi yoktur.

Sonraki sayfa: ?page=2&size=50. data.totalPageCount toplam sayfa sayısını gösterir.

Yanıt: 200 OK; kimlik doğrulama hatası 401; istek limiti aşımı 429.

cURLGET /api/returns

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

Sandbox örneğinde size=1 kullanılmıştır. Kendi API Key ve Secret değerlerinizi girin.

Liste Yanıtı

StoreReturnRequest V1 · Sayfalama

data.items altındaki her kayıt bir StoreReturnRequest modelidir. count yalnızca bu sayfadaki kayıt sayısı; data.totalItemCount toplam eşleşen kayıt sayısıdır.

StoreReturnRequest V1 alanları

Alan açıklamaları

returnRequestId

İade talebi kimliği.

returnKey

İade detayında kullanılan anahtar.

requestDate

İade talebinin tarihi.

orderKey

İlgili sipariş anahtarı.

orderLineId

Sipariş kalemi kimliği.

productId

Ürün kimliği.

variantId

Varyant kimliği.

productName

Ürün adı.

quantity

İade istenen miktar.

description

Talebin açıklaması.

haveInvoice

Fatura mevcut mu.

haveAccessory

Aksesuar mevcut mu.

reasonId

İade nedeni referansı.

statusId

İade durum referansı.

price

İade talebindeki fiyat; null olabilir.

currencyId

Para birimi referansı.

Alan tipleri ve null bilgisi yayımlanan OpenAPI V1 sözleşmesinden alınır. İade detayını returnKey ile sorgulayabilirsiniz.

JSON · 200 OKSandbox, size=1

{
  "data": {
    "items": [
      {
        "returnRequestId": 7001,
        "returnKey": "sandbox-return-1",
        "requestDate": "2026-11-01T00:00:00Z",
        "orderKey": "sandbox-order-1003",
        "orderLineId": 5003,
        "productId": 9003,
        "variantId": 9103,
        "productName": "Sandbox Backpack",
        "quantity": 1,
        "description": "Sandbox return",
        "haveInvoice": true,
        "haveAccessory": true,
        "reasonId": 1,
        "statusId": 1,
        "price": 459.5,
        "currencyId": 1
      }
    ],
    "pageNumber": 1,
    "pageSize": 1,
    "totalItemCount": 2,
    "totalPageCount": 2
  },
  "count": 1
}

Örnekteki tarih, 2 Kasım 2026'da sandbox verisi esas alınarak gösterilmiştir. Gerçek sandbox isteğinde tarih UTC gününe göre değişir. Genel Result meta alanları dahil değildir.