Sayfalama ve İteratörler (Pagination)

Shopier REST API tüm liste uç noktalarında sayfalama kullanır. Sayfalama meta verileri HTTP yanıt başlıklarında (headers) döner:

• Shopier-Pagination-Page: Mevcut sayfa numarası
• Shopier-Pagination-Limit: Sayfa başına kayıt sayısı
• Shopier-Pagination-Total-Pages: Toplam sayfa adedi
• Shopier-Pagination-Total-Items: Toplam kayıt adedi

SDK, sayfalanmış verilerle çalışmak için iki farklı yöntem sunar:

1. Go 1.23+ Range-Over-Func İteratörleri (All): Native for ... range döngüsü ile sayfaları otomatik çeken modern yaklaşım.
2. Manuel Sayfa İstekleri (List): Sayfa numarası ve limit üzerinde tam kontrol sağlayan klasik yaklaşım.

---

1. Modern Go 1.23+ Range İteratörleri (All)

All metodu iter.Seq2[T, error] döndürür. Döngü mevcut sayfanın sonuna geldikçe sonraki sayfayı arka planda otomatik olarak ister:

ctx := context.Background()

// Tüm siparişleri sayfalama karmaşası olmadan tek bir döngüde dolaşın
for order, err := range client.Orders.All(ctx, nil) {
	if err != nil {
		log.Fatalf("İterasyon hatası: %v", err)
	}

	fmt.Printf("Sipariş #%s: %s %s\n", order.ID, order.Totals.Total, order.Currency)
}

Filtre parametrelerini All metoduna da iletebilirsiniz:

opts := &shopier.OrderListOptions{
	FulfillmentStatus: "unfulfilled",
}

for order, err := range client.Orders.All(ctx, opts) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println("Kargolanacak sipariş:", order.ID)
}

---

2. Manuel Sayfa İstekleri (List)

Ön yüzde sayfalama (pagination) düğmeleri oluştururken veya belirli sayfaları çekerken:

opts := &shopier.OrderListOptions{
	ListOptions: shopier.ListOptions{
		Page:  1,
		Limit: 20, // Min: 1, Max: 50, Varsayılan: 10
		Sort:  "desc",
	},
	FulfillmentStatus: "unfulfilled",
}

res, err := client.Orders.List(ctx, opts)
if err != nil {
	log.Fatal(err)
}

fmt.Printf("Mevcut Sayfa: %d / %d (Toplam Kayıt: %d)\n",
	res.Pagination.Page,
	res.Pagination.TotalPages,
	res.Pagination.TotalItems,
)

for _, order := range res.Items {
	fmt.Printf("- Sipariş: %s\n", order.ID)
}

// Sonraki sayfa kontrolü
if res.Pagination.HasNextPage() {
	opts.Page = res.Pagination.NextPage()
	// Sonraki sayfayı isteyin...
}

---

Veri Modelleri ve Tipler

PageResponse[T]

Tüm List metotlarının döndürdüğü jenerik sayfalama sarmalayıcısıdır.

Alan (Field)	Tip	Açıklama
Items	[]T	Çekilen veri modeli dizisi (örn. []Order, []Product)
Pagination	PaginationInfo	HTTP başlıklarından ayrıştırılan sayfalama bilgisi

---

PaginationInfo

Shopier-Pagination-* HTTP başlıklarından çıkarılan sayfa durum bilgisi.

Alan (Field)	Tip	HTTP Başlığı	Açıklama
Page	int	Shopier-Pagination-Page	Mevcut sayfa indeksi (1 tabanlı)
Limit	int	Shopier-Pagination-Limit	Sayfa başına kayıt sınırı (1 - 50)
TotalPages	int	Shopier-Pagination-Total-Pages	Toplam sayfa sayısı
TotalItems	int	Shopier-Pagination-Total-Items	Tüm sayfalardaki toplam kayıt sayısı

Yardımcı Metotlar:

• p.HasNextPage() bool: Çekilecek sonraki sayfa varsa true döner (Page < TotalPages).
• p.NextPage() int: Sonraki sayfa numarasını (Page + 1) döner; son sayfadaysa 0 döner.

---

ListOptions

Tüm liste sorgularında ortak olan temel sayfalama parametreleri.

Alan (Field)	Tip	URL Parametresi	Sınırlar	Açıklama
Page	int	page	Min: 1, Varsayılan: 1	İstenen sayfa numarası
Limit	int	limit	Min: 1, Max: 50, Varsayılan: 10	Sayfa başına kayıt
Sort	string	sort	"asc", "desc"	Sıralama yönü