Sayfalama

API'nin liste uç noktaları verileri sayfalı olarak döndürür. Platformda tarihsel olarak iki sayfalama şeması gelişmiştir; hangi şemanın kullanıldığı etkileşimli referanstaki uç nokta açıklamasında belirtilir.

Şema 1 — Offset ve X-Total-Count

Klasik offset tabanlı sayfalama. İstek, limit (sayfa boyutu) ve offset (atlanacak kayıt sayısı) sorgu parametrelerini kabul eder:

curl -H "Authorization: Bearer mbp_TOKENINIZ" "https://alan-adiniz/api/bots/BOT_ID/subscribers?limit=50&offset=100"

Toplam kayıt sayısı X-Total-Count yanıt başlığında döner. Bununla sayfa sayısı hesaplanır: offset değeri X-Total-Count değerinden küçük olduğu sürece offset'i limit kadar artırarak sayfalarda ilerleyin. Yanıt gövdesi, geçerli sayfanın öğelerinden oluşan bir dizidir.

Şema 2 — Before İmleci ve has_more

Zamana göre sıralanan akışlar için imleç tabanlı sayfalama (örn. diyalog mesajları). İstek, limit ve isteğe bağlı before imlecini — son alınan öğenin tanımlayıcısını veya işaretini — kabul eder:

curl -H "Authorization: Bearer mbp_TOKENINIZ" "https://alan-adiniz/api/bots/BOT_ID/users/USER_ID/dialog?limit=50&before=CURSOR"

Yanıt, bir öğe sayfası ve has_more bayrağı içerir. has_more true olduğu sürece, son alınan öğenin imlecini before olarak geçirerek isteği tekrarlayın. has_more false olduğunda bu son sayfadır.

Hangi Şema Seçilir

Şemayı siz seçmezsiniz — uç nokta belirler. Referans listeleri genellikle offset ve X-Total-Count'u; zaman sırası akışları before imlecini ve has_more'u kullanır. Her zaman referanstaki uç nokta sayfasına bakın.

Sonraki Adımlar