本文へスキップ

コメントの一覧

GET/v1/posts/{id}/comments

投稿のコメントツリーをページごとに返します。並べ替え、話での絞り込み、単一のスレッド、テキスト検索が使えます。

リクエスト

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

パラメーター

  • id

    パス必須

    項目のID（UUID）。

    テキスト

  • sort

    クエリ任意

    結果の順序。

    テキスト

    使用できる値bestnewoldcontroversialunit

    既定値：best

  • unit

    クエリ任意

    この話数に関するコメントのみ。特定の話に結び付かないコメントは general。

    複数の形式のいずれか

  • thread

    クエリ任意

    このコメントの下にあるスレッドのみ。

    テキスト (uuid)

  • q

    クエリ任意

    検索するテキスト。

    テキスト

  • cursor

    クエリ任意

    前のページの nextCursor の値。最初のページでは省略します。

    テキスト

レスポンス

リクエストが成功すると、次のJSONとともに200が返ります。

  • items__schema0のリスト
    • idテキスト (uuid)
    • authorオブジェクトnull になる場合あり
      • usernameテキスト
      • displayNameテキスト
      • avatarUrlテキスト (uri)null になる場合あり
    • authorFlairテキストnull になる場合あり
    • authorProgressオブジェクトnull になる場合あり
      • trackingStatusテキスト
        使用できる値plannedcurrentcompletedpauseddroppedrewatching
      • progressUnits数値null になる場合あり

        0以上

      • progressTotal整数null になる場合あり

        0〜9007199254740991

    • stateテキスト
      使用できる値publishedremoveddeleted
    • bodyオブジェクトnull になる場合あり
      • blocks複数の形式のいずれかのリスト

        1. 選択肢1

          • typeテキスト
            使用できる値paragraph
          • children任意の値のリスト

        2. 選択肢2

          • typeテキスト
            使用できる値heading
          • children任意の値のリスト

        3. 選択肢3

          • typeテキスト
            使用できる値quote
          • childrenRichTextBlockのリスト

        4. 選択肢4

          • typeテキスト
            使用できる値list
          • isOrderedtrue または false
          • items任意の値のリストのリスト

        5. 選択肢5

          • typeテキスト
            使用できる値code
          • textテキスト
    • hasSpoilertrue または false
    • unitNumber数値null になる場合あり

      0以上

    • sourceSpoilerオブジェクトnull になる場合あり
      • kindテキスト
        使用できる値mangamanhwamanhuawebtoonnovelother
      • unit数値null になる場合あり

        0以上

    • imagesオブジェクトのリスト
      • urlテキスト (uri)
      • width整数

        0〜9007199254740991

      • height整数

        0〜9007199254740991

      • altテキストnull になる場合あり
      • variantWidths整数のリスト

        0〜9007199254740991

    • linkオブジェクトnull になる場合あり
      • urlテキスト (uri)
      • hostテキスト
      • titleテキストnull になる場合あり
      • descriptionテキストnull になる場合あり
      • imageオブジェクトnull になる場合あり
        • urlテキスト (uri)
        • width整数

          0〜9007199254740991

        • height整数

          0〜9007199254740991

        • altテキストnull になる場合あり
        • variantWidths整数のリスト

          0〜9007199254740991

      • isPendingtrue または false
    • score整数null になる場合あり

      -9007199254740991〜9007199254740991

    • reactionsオブジェクトのリスト
      • kindテキスト
        使用できる値lovelaughwowsadclapfirethinkangrypartycry
      • count整数

        0〜9007199254740991

    • isByPostAuthortrue または false
    • isByModeratortrue または false
    • createdAtテキスト (date-time)
    • editedAtテキスト (date-time)null になる場合あり
    • depth整数

      0〜9007199254740991

    • replyCount整数

      0〜9007199254740991

    • replies__schema0のリスト
  • nextCursorテキストnull になる場合あり

エラー

他の操作と同様に、この操作も無効なパラメーターでは400、何も見つからない場合は404、リクエストが多すぎる場合は429を返すことがあります。すべてのエラーは同じ形式です。

エラーについて読む