본문으로 건너뛰기

댓글 목록

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로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기