Saltar al contenido

Listar noticias

GET/v1/news

Devuelve noticias, primero las más recientes, con filtros por tema, tipo y formato.

Solicitud

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

Parámetros

  • cursor

    consultaopcional

    El valor nextCursor de la página anterior. Omítelo para la primera página.

    texto

  • kind

    consultaopcional

    Solo noticias de este tipo.

    texto

    Valores permitidosofficial_announcementcatalog_updaterumorindustry
  • topic

    consultaopcional

    Solo noticias sobre este tipo de evento.

    texto

    Valores permitidosrelease_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
  • mediumKind

    consultaopcional

    Solo noticias sobre obras para ver (screen) o para leer (reading).

    texto

    Valores permitidosscreenreading
  • limit

    consultaopcional

    Cuántos elementos devolver en una página.

    número entero

    De 1 a 20Predeterminado: 20

Respuesta

Una solicitud correcta responde 200 con 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 o false
    • workobjeto
      • idtexto (uuid)
      • slugtexto
      • mediumtexto
        Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattexto
        Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustexto
        Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletexto
      • nativeTitletextopuede ser null
      • romanizedTitletextopuede ser null
      • contentRatingtexto
        Valores permitidosunknownall_agesteenmatureadult
      • startYearnúmero enteropuede ser null

        De -9007199254740991 a 9007199254740991

      • coverobjetopuede ser null
        • urltexto (uri)
        • widthnúmero enteropuede ser null

          De 0 a 9007199254740991

        • heightnúmero enteropuede ser null

          De 0 a 9007199254740991

        • blurhashtextopuede ser null
        • providertextopuede ser null
          Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthslista de número entero

          De 0 a 9007199254740991

      • contentWarningslista de texto
        Valores permitidosviolencegoresexual-contentsuicide
    • relatedWorkobjetopuede ser null
      • idtexto (uuid)
      • slugtexto
      • mediumtexto
        Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattexto
        Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustexto
        Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletexto
      • nativeTitletextopuede ser null
      • romanizedTitletextopuede ser null
      • contentRatingtexto
        Valores permitidosunknownall_agesteenmatureadult
      • startYearnúmero enteropuede ser null

        De -9007199254740991 a 9007199254740991

      • coverobjetopuede ser null
        • urltexto (uri)
        • widthnúmero enteropuede ser null

          De 0 a 9007199254740991

        • heightnúmero enteropuede ser null

          De 0 a 9007199254740991

        • blurhashtextopuede ser null
        • providertextopuede ser null
          Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthslista de número entero

          De 0 a 9007199254740991

      • contentWarningslista de texto
        Valores permitidosviolencegoresexual-contentsuicide
    • bannerobjetopuede ser null
      • urltexto (uri)
      • widthnúmero enteropuede ser null

        De 0 a 9007199254740991

      • heightnúmero enteropuede ser null

        De 0 a 9007199254740991

      • blurhashtextopuede ser null
      • providertextopuede ser null
        Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthslista de número entero

        De 0 a 9007199254740991

    • factsobjeto
      • startDatetexto (date)puede ser null
      • endDatetexto (date)puede ser null
      • videoKeytextopuede ser null
  • nextCursortextopuede ser null

Errores

Como todas las operaciones, esta puede responder 400 si los parámetros no son válidos, 404 si no se encuentra nada y 429 si envías demasiadas solicitudes. Todos los errores comparten una misma forma.

Lee sobre los errores