Skip to main content
Liste uçları (GET /v1/customers, GET /v1/appointments, vb.) standart sayfalama döner. Yanıt, hem veri hem de sayfalama meta bilgisi içerir.

Parametreler

integer
default:"1"
Döndürmek istediğiniz sayfa numarası. 1’den başlar.
integer
default:"15"
Sayfa başına kayıt sayısı. En fazla 100. Daha büyük değer gönderirseniz 422 doğrulama hatası alırsınız.

Örnek istek

Yanıt yapısı

Liste yanıtları data içinde kayıtları, meta içinde sayfalama bilgilerini, links içinde gezinme URL’lerini döner:
integer
Filtrelerinize uyan toplam kayıt sayısı.
integer
Mevcut per_page değeri ile son sayfa numarası.
Bir sonraki sayfa URL’i, yoksa null.

Tüm kayıtları dolaşma örüntüsü

Kayıtları paralel işlem yapmadan sırayla dolaşmak için links.next takip edilebilir:

Performans ipuçları

  • Küçük sayfalar. per_page=100 yerine 25–50 tercih edin; büyük sayfalar bellek ve yanıt süresi maliyetini yükseltir.
  • Sık değişen listeler. Birden fazla sayfa okurken araya yeni kayıt girerse kayıtlar sayfalar arası “kayabilir”. Güçlü bir sıralama (ör. sort_by=created_at&sort_order=desc) kullanmak bu etkiyi azaltır.
  • Dakikada çok sayıda sayfa isteği atıyorsanız rate limit yiyebilirsiniz. Paralel sayfa isteklerini sınırlayın.
Şu an cursor-based pagination (imleçli sayfalama) desteklenmemektedir. İleride eklendiğinde Changelog üzerinden duyurulur.