Elenca le opere

GET/v1/works

Restituisce le opere pagina per pagina, ordinate per popolarità, punteggio, più recenti o più imminenti. Restringi l'elenco per tipo, genere, stagione, stato di pubblicazione o senso di lettura.

Richiesta

Shell

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

Parametri

medium
queryfacoltativo
Solo opere di questo tipo.
testo
Valori consentitianimedonghuaanimationmangamanhwamanhuawebtoon
releaseStatus
queryfacoltativo
Solo opere con questo stato di pubblicazione.
testo
Valori consentitinot_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirection
queryfacoltativo
Solo opere lette in questo senso.
testo
Valori consentitirtlltrvertical_scroll
genre
queryfacoltativo
Solo opere con questo genere, tramite slug.
testo
hasBanner
queryfacoltativo
true per le sole opere che hanno un'immagine banner.
testo
hasTrailer
queryfacoltativo
true per le sole opere che hanno un trailer.
testo
minCoverWidth
queryfacoltativo
Solo opere la cui copertina è larga almeno questo numero di pixel.
numero intero
Da 1 a 10000
season
queryfacoltativo
Solo opere iniziate in questa stagione.
testo
Valori consentitiwinterspringsummerfall
seasonYear
queryfacoltativo
Anno della stagione; usalo insieme a season.
numero intero
Da 1900 a 2100
sort
queryfacoltativo
Ordine dei risultati.
testo
Valori consentitipopularityscorenewestsoonest
Predefinito: popularity
limit
queryfacoltativo
Quanti elementi restituire in una pagina.
numero intero
Da 1 a 50Predefinito: 20
cursor
queryfacoltativo
Il valore nextCursor della pagina precedente. Omettilo per la prima pagina.
testo
language
queryfacoltativo
Codice di lingua di due lettere per i testi della risposta, come en o tr. Omettilo per l'inglese.
testo
Predefinito: en

Risposta

Una richiesta riuscita risponde 200 con questo JSON:

itemselenco di oggetto
- idtesto (uuid)
- slugtesto
- mediumtesto
  Valori consentitianimedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormattesto
  Valori consentititvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatustesto
  Valori consentitinot_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirectiontestopuò essere null
  Valori consentitirtlltrvertical_scroll
- primaryTitletesto
- englishTitletestopuò essere null
- nativeTitletestopuò essere null
- romanizedTitletestopuò essere null
- contentRatingtesto
  Valori consentitiunknownall_agesteenmatureadult
- seasontestopuò essere null
  Valori consentitiwinterspringsummerfall
- seasonYearnumero interopuò essere null
  Da -9007199254740991 a 9007199254740991
- startDatetesto (date)può essere null
- totalUnitsnumero interopuò essere null
  Da -9007199254740991 a 9007199254740991
- aggregateScorenumero interopuò essere null
  Da 0 a 1000
- scoreRanknumero interopuò essere null
  Da 0 a 9007199254740991
- popularityRanknumero interopuò essere null
  Da 0 a 9007199254740991
- audienceSizenumero interopuò essere null
  Da 0 a 9007199254740991
- coveroggettopuò essere null
  urltesto (uri)
  widthnumero interopuò essere null
  Da 0 a 9007199254740991
  heightnumero interopuò essere null
  Da 0 a 9007199254740991
  blurhashtestopuò essere null
  providertestopuò essere null
  Valori consentitianime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthselenco di numero intero
  Da 0 a 9007199254740991
- banneroggettopuò essere null
  urltesto (uri)
  widthnumero interopuò essere null
  Da 0 a 9007199254740991
  heightnumero interopuò essere null
  Da 0 a 9007199254740991
  blurhashtestopuò essere null
  providertestopuò essere null
  Valori consentitianime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthselenco di numero intero
  Da 0 a 9007199254740991
- traileroggettopuò essere null
  hosttesto
  Valori consentitiyoutube
  keytesto
- primaryStudiotestopuò essere null
- genreselenco di oggetto
  slugtesto
  labeltesto
- contentWarningselenco di testo
  Valori consentitiviolencegoresexual-contentsuicide
- descriptionoggettopuò essere null
  texttesto
  languagetesto
  isMachineGeneratedtrue o false
- sourceUrltesto (uri)può essere null
nextCursortestopuò essere null

Errori

Come ogni operazione, questa può rispondere 400 per parametri non validi, 404 quando non trova nulla e 429 quando invii troppe richieste. Tutti gli errori condividono la stessa forma.

Leggi sugli errori