跳到主要内容

列出新闻

GET/v1/news

按从新到旧返回新闻,可按话题、种类和媒介筛选。

请求

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

参数

  • cursor

    查询可选

    上一页的 nextCursor 值。读取第一页时省略。

    文本

  • kind

    查询可选

    仅限此种类的新闻。

    文本

    允许的值official_announcementcatalog_updaterumorindustry
  • topic

    查询可选

    仅限关于此类事件的新闻。

    文本

    允许的值release_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
  • mediumKind

    查询可选

    仅限关于可观看作品(screen)或可阅读作品(reading)的新闻。

    文本

    允许的值screenreading
  • limit

    查询可选

    每页返回的条目数。

    整数

    1 到 20默认值:20

响应

请求成功时返回 200 和以下 JSON:

  • items对象 列表
    • id文本 (uuid)
    • slug文本
    • kind文本
      允许的值official_announcementcatalog_updaterumorindustry
    • topic文本
      允许的值release_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
    • publishedAt文本 (date-time)
    • recordedAt文本 (date-time)
    • isRetrospectivetrue 或 false
    • work对象
      • id文本 (uuid)
      • slug文本
      • medium文本
        允许的值animedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormat文本
        允许的值tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatus文本
        允许的值not_yet_releasedreleasingfinishedhiatuscancelledunknown
      • title文本
      • nativeTitle文本可为 null
      • romanizedTitle文本可为 null
      • contentRating文本
        允许的值unknownall_agesteenmatureadult
      • startYear整数可为 null

        -9007199254740991 到 9007199254740991

      • cover对象可为 null
        • url文本 (uri)
        • width整数可为 null

          0 到 9007199254740991

        • height整数可为 null

          0 到 9007199254740991

        • blurhash文本可为 null
        • provider文本可为 null
          允许的值anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidths整数 列表

          0 到 9007199254740991

      • contentWarnings文本 列表
        允许的值violencegoresexual-contentsuicide
    • relatedWork对象可为 null
      • id文本 (uuid)
      • slug文本
      • medium文本
        允许的值animedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormat文本
        允许的值tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatus文本
        允许的值not_yet_releasedreleasingfinishedhiatuscancelledunknown
      • title文本
      • nativeTitle文本可为 null
      • romanizedTitle文本可为 null
      • contentRating文本
        允许的值unknownall_agesteenmatureadult
      • startYear整数可为 null

        -9007199254740991 到 9007199254740991

      • cover对象可为 null
        • url文本 (uri)
        • width整数可为 null

          0 到 9007199254740991

        • height整数可为 null

          0 到 9007199254740991

        • blurhash文本可为 null
        • provider文本可为 null
          允许的值anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidths整数 列表

          0 到 9007199254740991

      • contentWarnings文本 列表
        允许的值violencegoresexual-contentsuicide
    • banner对象可为 null
      • url文本 (uri)
      • width整数可为 null

        0 到 9007199254740991

      • height整数可为 null

        0 到 9007199254740991

      • blurhash文本可为 null
      • provider文本可为 null
        允许的值anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidths整数 列表

        0 到 9007199254740991

    • facts对象
      • startDate文本 (date)可为 null
      • endDate文本 (date)可为 null
      • videoKey文本可为 null
  • nextCursor文本可为 null

错误

与所有操作一样,此操作在参数无效时可能返回 400,找不到内容时返回 404,请求过多时返回 429。所有错误的结构都相同。

了解错误