Listar notícias

GET/v1/news

Retorna notícias, das mais recentes para as mais antigas, com filtros por tema, tipo e mídia.

Requisição

Shell

curl "https://api.nogitsu.com/v1/news"

Parâmetros

cursor
consultaopcional
O valor de nextCursor da página anterior. Omita-o na primeira página.
texto
kind
consultaopcional
Apenas notícias deste tipo.
texto
Valores permitidosofficial_announcementcatalog_updaterumorindustry
topic
consultaopcional
Apenas notícias sobre este tipo de evento.
texto
Valores permitidosrelease_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
mediumKind
consultaopcional
Apenas notícias sobre obras para assistir (screen) ou para ler (reading).
texto
Valores permitidosscreenreading
limit
consultaopcional
Quantos itens retornar em uma página.
número inteiro
De 1 a 20Padrão: 20

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

itemslista de objeto
- idtexto (uuid)
- slugtexto
- kindtexto
  Valores permitidosofficial_announcementcatalog_updaterumorindustry
- topictexto
  Valores permitidosrelease_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
- publishedAttexto (date-time)
- recordedAttexto (date-time)
- isRetrospectivetrue ou false
- workobjeto
  idtexto (uuid)
  slugtexto
  mediumtexto
  Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
  publicationFormattexto
  Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
  releaseStatustexto
  Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
  titletexto
  nativeTitletextopode ser null
  romanizedTitletextopode ser null
  contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
  startYearnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
  coverobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
  contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
- relatedWorkobjetopode ser null
  idtexto (uuid)
  slugtexto
  mediumtexto
  Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
  publicationFormattexto
  Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
  releaseStatustexto
  Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
  titletexto
  nativeTitletextopode ser null
  romanizedTitletextopode ser null
  contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
  startYearnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
  coverobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
  contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
- bannerobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
- factsobjeto
  startDatetexto (date)pode ser null
  endDatetexto (date)pode ser null
  videoKeytextopode ser null
nextCursortextopode ser null

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros