跳到主要内容

列出片单中的作品

GET/v1/collections/{id}/items

返回片单中的作品及所有者的备注,可按所有者设定的顺序或其他方式排序,并支持文本搜索。

请求

Shell
curl -g "https://api.nogitsu.com/v1/collections/{id}/items"

参数

  • id

    路径必填

    条目的 ID,为 UUID。

    文本

  • cursor

    查询可选

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

    文本

  • sort

    查询可选

    结果的排序方式。

    文本

    允许的值positionaddedtitleyearscore
  • q

    查询可选

    要搜索的文本。

    文本

响应

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

  • items对象 列表
    • position整数

      -9007199254740991 到 9007199254740991

    • note文本可为 null
    • addedAt文本 (date-time)
    • 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
  • nextCursor文本可为 null

错误

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

了解错误