跳到主要内容

获取预告片

GET/v1/trailers/{videoKey}

按 YouTube 视频 key 返回预告片,并附带其作品、该作品的其他预告片以及相关预告片。

请求

Shell
curl "https://api.nogitsu.com/v1/trailers/63xrlIw4Y88"

参数

  • videoKey

    路径必填

    预告片的 YouTube 视频 key。

    文本

  • language

    查询可选

    响应文本的两字母语言代码,例如 en 或 tr。省略时为英语。

    文本

    默认值:en

响应

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

  • videoKey文本
  • work对象
    • 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
  • workTrailerKeys文本 列表
  • related对象 列表
    • videoKey文本
    • addedAt文本 (date-time)可为 null
    • 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
      • 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

      • primaryStudio文本可为 null
      • season文本可为 null
        允许的值winterspringsummerfall
      • seasonYear整数可为 null

        -9007199254740991 到 9007199254740991

      • startDate文本 (date)可为 null

错误

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

了解错误