跳到主要内容

列出作品的评测

GET/v1/works/{id}/reviews

返回作品已发布的评测,可按有用程度、日期或评分排序,并支持筛选。

请求

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/reviews"

参数

  • id

    路径必填

    条目的 ID,为 UUID。

    文本

  • sort

    查询可选

    结果的排序方式。

    文本

    允许的值helpfulnewesthighestlowest

    默认值:helpful

  • score

    查询可选

    仅限给出此评分的评测。

    整数

    1 到 10

  • language

    查询可选

    仅限以此语言撰写的评测。

    文本

  • completedOnly

    查询可选

    设为 true 时仅限已看完或读完该作品的成员所写的评测。

    文本

  • detailed

    查询可选

    设为 true 时仅限 600 个字符及以上的长评测。

    文本

  • cursor

    查询可选

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

    文本

  • limit

    查询可选

    每页返回的条目数。

    整数

    1 到 20默认值:20

响应

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

  • items对象 列表
    • id文本 (uuid)
    • author对象
      • username文本
      • displayName文本
      • avatarUrl文本 (uri)可为 null
    • title文本可为 null
    • body对象可为 null
      • blocks多种结构之一 列表
        1. 选项 1

          • type文本
            允许的值paragraph
          • children多种结构之一 列表
            1. 选项 1

            2. 选项 2

            3. 选项 3

            4. 选项 4

            5. 选项 5

        2. 选项 2

          • type文本
            允许的值heading
          • children多种结构之一 列表
            1. 选项 1

            2. 选项 2

            3. 选项 3

            4. 选项 4

            5. 选项 5

        3. 选项 3

          • type文本
            允许的值quote
          • childrenRichTextBlock 列表
        4. 选项 4

          • type文本
            允许的值list
          • isOrderedtrue 或 false
          • itemsRichTextBlock 列表 列表
        5. 选项 5

          • type文本
            允许的值code
          • text文本
    • bodyLength整数

      0 到 9007199254740991

    • hasSpoilertrue 或 false
    • spoilerUnit数字可为 null

      至少 0

    • sourceSpoiler对象可为 null
      • kind文本
        允许的值mangamanhwamanhuawebtoonnovelother
      • unit数字可为 null

        至少 0

    • pros文本 列表可为 null
    • cons文本 列表可为 null
    • images对象 列表
      • url文本 (uri)
      • width整数

        0 到 9007199254740991

      • height整数

        0 到 9007199254740991

      • alt文本可为 null
      • variantWidths整数 列表

        0 到 9007199254740991

    • language文本
    • scoreHalfPoints整数可为 null

      1 到 20

    • categoryScores对象
    • trackingStatus文本可为 null
      允许的值plannedcurrentcompletedpauseddroppedrewatching
    • progressUnits数字可为 null

      至少 0

    • progressTotal整数可为 null

      0 到 9007199254740991

    • repeatCount整数

      0 到 9007199254740991

    • authorStats对象
      • reviewCount整数

        0 到 9007199254740991

      • helpfulCount整数

        0 到 9007199254740991

    • helpfulCount整数

      0 到 9007199254740991

    • unhelpfulCount整数

      0 到 9007199254740991

    • replyCount整数

      0 到 9007199254740991

    • createdAt文本 (date-time)
    • editedAt文本 (date-time)可为 null
  • nextCursor文本可为 null

错误

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

了解错误