Daftar karya

GET/v1/works

Mengembalikan karya per halaman, diurutkan berdasarkan popularitas, skor, terbaru, atau yang paling segera rilis. Persempit daftar berdasarkan media, genre, season, status rilis, atau arah baca.

Permintaan

Shell

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

Parameter

medium
queryopsional
Hanya karya dengan media ini.
teks
Nilai yang diizinkananimedonghuaanimationmangamanhwamanhuawebtoon
releaseStatus
queryopsional
Hanya karya dengan status rilis ini.
teks
Nilai yang diizinkannot_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirection
queryopsional
Hanya karya yang dibaca dengan arah ini.
teks
Nilai yang diizinkanrtlltrvertical_scroll
genre
queryopsional
Hanya karya dengan genre ini, berdasarkan slug.
teks
hasBanner
queryopsional
true untuk hanya karya yang punya gambar banner.
teks
hasTrailer
queryopsional
true untuk hanya karya yang punya trailer.
teks
minCoverWidth
queryopsional
Hanya karya yang sampulnya selebar setidaknya sekian piksel.
bilangan bulat
Dari 1 sampai 10000
season
queryopsional
Hanya karya yang dimulai pada season ini.
teks
Nilai yang diizinkanwinterspringsummerfall
seasonYear
queryopsional
Tahun season; gunakan bersama season.
bilangan bulat
Dari 1900 sampai 2100
sort
queryopsional
Urutan hasil.
teks
Nilai yang diizinkanpopularityscorenewestsoonest
Default: popularity
limit
queryopsional
Jumlah item yang dikembalikan dalam satu halaman.
bilangan bulat
Dari 1 sampai 50Default: 20
cursor
queryopsional
Nilai nextCursor dari halaman sebelumnya. Kosongkan untuk halaman pertama.
teks
language
queryopsional
Kode bahasa dua huruf untuk teks dalam respons, seperti en atau tr. Kosongkan untuk bahasa Inggris.
teks
Default: en

Respons

Permintaan yang berhasil merespons 200 dengan JSON ini:

itemsdaftar objek
- idteks (uuid)
- slugteks
- mediumteks
  Nilai yang diizinkananimedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormatteks
  Nilai yang diizinkantvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatusteks
  Nilai yang diizinkannot_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirectionteksbisa null
  Nilai yang diizinkanrtlltrvertical_scroll
- primaryTitleteks
- englishTitleteksbisa null
- nativeTitleteksbisa null
- romanizedTitleteksbisa null
- contentRatingteks
  Nilai yang diizinkanunknownall_agesteenmatureadult
- seasonteksbisa null
  Nilai yang diizinkanwinterspringsummerfall
- seasonYearbilangan bulatbisa null
  Dari -9007199254740991 sampai 9007199254740991
- startDateteks (date)bisa null
- totalUnitsbilangan bulatbisa null
  Dari -9007199254740991 sampai 9007199254740991
- aggregateScorebilangan bulatbisa null
  Dari 0 sampai 1000
- scoreRankbilangan bulatbisa null
  Dari 0 sampai 9007199254740991
- popularityRankbilangan bulatbisa null
  Dari 0 sampai 9007199254740991
- audienceSizebilangan bulatbisa null
  Dari 0 sampai 9007199254740991
- coverobjekbisa null
  urlteks (uri)
  widthbilangan bulatbisa null
  Dari 0 sampai 9007199254740991
  heightbilangan bulatbisa null
  Dari 0 sampai 9007199254740991
  blurhashteksbisa null
  providerteksbisa null
  Nilai yang diizinkananime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthsdaftar bilangan bulat
  Dari 0 sampai 9007199254740991
- bannerobjekbisa null
  urlteks (uri)
  widthbilangan bulatbisa null
  Dari 0 sampai 9007199254740991
  heightbilangan bulatbisa null
  Dari 0 sampai 9007199254740991
  blurhashteksbisa null
  providerteksbisa null
  Nilai yang diizinkananime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthsdaftar bilangan bulat
  Dari 0 sampai 9007199254740991
- trailerobjekbisa null
  hostteks
  Nilai yang diizinkanyoutube
  keyteks
- primaryStudioteksbisa null
- genresdaftar objek
  slugteks
  labelteks
- contentWarningsdaftar teks
  Nilai yang diizinkanviolencegoresexual-contentsuicide
- descriptionobjekbisa null
  textteks
  languageteks
  isMachineGeneratedtrue atau false
- sourceUrlteks (uri)bisa null
nextCursorteksbisa null

Error

Seperti setiap operasi, operasi ini bisa merespons 400 untuk parameter tidak valid, 404 jika tidak ada yang ditemukan, dan 429 jika kamu mengirim terlalu banyak permintaan. Semua error memiliki bentuk yang sama.

Baca tentang error