列出作品

GET/v1/works

按热度、评分、最新或即将发布排序，分页返回作品。可按媒介、类型、季度、发布状态或阅读方向缩小范围。

请求

Shell

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

参数

medium
查询可选
仅限此媒介的作品。
文本
允许的值animedonghuaanimationmangamanhwamanhuawebtoon
releaseStatus
查询可选
仅限处于此发布状态的作品。
文本
允许的值not_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirection
查询可选
仅限按此方向阅读的作品。
文本
允许的值rtlltrvertical_scroll
genre
查询可选
仅限具有此类型的作品，按 slug 指定。
文本
hasBanner
查询可选
设为 true 时仅限有横幅图的作品。
文本
hasTrailer
查询可选
设为 true 时仅限有预告片的作品。
文本
minCoverWidth
查询可选
仅限封面宽度不少于此像素数的作品。
整数
1 到 10000
season
查询可选
仅限在此季度开始的作品。
文本
允许的值winterspringsummerfall
seasonYear
查询可选
季度所在的年份；与 season 一起使用。
整数
1900 到 2100
sort
查询可选
结果的排序方式。
文本
允许的值popularityscorenewestsoonest
默认值：popularity
limit
查询可选
每页返回的条目数。
整数
1 到 50默认值：20
cursor
查询可选
上一页的 nextCursor 值。读取第一页时省略。
文本
language
查询可选
响应文本的两字母语言代码，例如 en 或 tr。省略时为英语。
文本
默认值：en

响应

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

items对象列表
- id文本 (uuid)
- slug文本
- medium文本
  允许的值animedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormat文本
  允许的值tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatus文本
  允许的值not_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirection文本可为 null
  允许的值rtlltrvertical_scroll
- primaryTitle文本
- englishTitle文本可为 null
- nativeTitle文本可为 null
- romanizedTitle文本可为 null
- contentRating文本
  允许的值unknownall_agesteenmatureadult
- season文本可为 null
  允许的值winterspringsummerfall
- seasonYear整数可为 null
  -9007199254740991 到 9007199254740991
- startDate文本 (date)可为 null
- totalUnits整数可为 null
  -9007199254740991 到 9007199254740991
- aggregateScore整数可为 null
  0 到 1000
- scoreRank整数可为 null
  0 到 9007199254740991
- popularityRank整数可为 null
  0 到 9007199254740991
- audienceSize整数可为 null
  0 到 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
- 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
- trailer对象可为 null
  host文本
  允许的值youtube
  key文本
- primaryStudio文本可为 null
- genres对象列表
  slug文本
  label文本
- contentWarnings文本列表
  允许的值violencegoresexual-contentsuicide
- description对象可为 null
  text文本
  language文本
  isMachineGeneratedtrue 或 false
- sourceUrl文本 (uri)可为 null
nextCursor文本可为 null

错误

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

了解错误