Halaman dan kursor
Cara operasi daftar membagi hasil ke dalam halaman dan cara membaca halaman berikutnya.
Halaman dengan kursor
Operasi daftar merespons dengan items dan nextCursor. Untuk membaca halaman berikutnya, kirim lagi permintaan yang sama dengan cursor berisi nextCursor yang kamu terima. Jika nextCursor bernilai null, tidak ada halaman lagi.
curl "https://api.nogitsu.com/v1/works?limit=3&cursor=eyJ2YWx1ZSI6MSwiaWQiOiIwMWEwY2IwYS0zN2MxLTc5NDYtYmUzOC1iZmM5ZjFhNWFmMGUifQ"Membaca semua halaman
Jangan ubah parameter lain selama kamu mengikuti kursor. Kursor bersifat opak: jangan membuat atau mengubahnya sendiri, dan jangan menyimpannya terlalu lama, karena urutannya bisa berubah saat katalog diperbarui.
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)Ukuran halaman
Jika sebuah operasi menerima limit, halaman referensinya menampilkan nilai default dan nilai terbesar yang diizinkan. Meminta lebih dari nilai terbesar menghasilkan error 400, bukan halaman yang lebih pendek.
Jelajahi memakai nomor halaman
Pencarian berfaset di balik halaman Jelajahi menghitung hasil alih-alih mengikuti kursor. Pencarian ini menerima page dan merespons dengan found, page, dan pageSize, hingga halaman 100.
curl "https://api.nogitsu.com/v1/search/works/explore?medium=anime&genres=fantasy&page=2"