Sayfalar ve imleçler

Liste işlemleri sonuçları nasıl sayfalara böler ve sonraki sayfa nasıl okunur.

İmleçli sayfalar

Liste işlemleri items ve nextCursor ile yanıt verir. Sonraki sayfayı okumak için aynı isteği cursor değerini aldığın nextCursor yaparak yeniden gönder. nextCursor null olduğunda başka sayfa yoktur.

Shell

curl "https://api.nogitsu.com/v1/works?limit=3&cursor=eyJ2YWx1ZSI6MSwiaWQiOiIwMWEwY2IwYS0zN2MxLTc5NDYtYmUzOC1iZmM5ZjFhNWFmMGUifQ"

Tüm sayfaları okumak

İmleci izlerken öteki parametreleri değiştirme. İmleç opaktır: kendin kurma ya da değiştirme ve uzun süre saklama, çünkü katalog güncellendikçe sıra değişebilir.

JavaScript

let cursor = null
do {
  const url = new URL('https://api.nogitsu.com/v1/works')
  url.searchParams.set('medium', 'anime')
  url.searchParams.set('limit', '50')
  if (cursor) url.searchParams.set('cursor', cursor)
  const page = await fetch(url).then((response) => response.json())
  for (const work of page.items) console.log(work.primaryTitle)
  cursor = page.nextCursor
} while (cursor)

Sayfa boyutu

Bir işlem limit kabul ediyorsa başvuru sayfası varsayılan değeri ve izin verilen en büyük değeri gösterir. En büyük değerden fazlasını istemek daha kısa bir sayfa yerine 400 hatası döndürür.

Keşfet sayfa numarası kullanır

Keşfet sayfasının süzgeçli araması imleç izlemek yerine sonuçları sayar. page alır ve found, page ve pageSize ile yanıt verir; en çok 100. sayfaya kadar.

Shell

curl "https://api.nogitsu.com/v1/search/works/explore?medium=anime&genres=fantasy&page=2"