댓글 목록 Tier 4

GET/api/versions/:id/commentsCopied!

버전의 최상위 댓글을 생성 시간 순으로 반환합니다. 커서 페이지네이션을 사용합니다.

요청

Path

idstringrequired

버전 ID

Query

nextstring

다음 페이지 커서

prevstring

이전 페이지 커서

INFO

next와 prev를 모두 지정하지 않으면 가장 최근에 작성된 댓글 25개를 반환합니다.

응답

200 OK를 반환합니다.

dataarray

댓글 목록

data[].idstring

댓글 ID

Example: 2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6

data[].contentstring?

댓글 내용

Example: Please tighten the logo safe area.

data[].startTimenumber?

시작 타임스탬프. 영상/YouTube는 ms, PDF/Image는 페이지 번호

Example: 12400

data[].endTimenumber?

종료 타임스탬프. 영상/YouTube는 ms, PDF/Image는 페이지 번호

Example: 18900

data[].drawingboolean?

드로잉 첨부 여부

Example: true

data[].createdAtstring

댓글 생성일

Example: 2026-04-10 08:00:00.000000

data[].updatedAtstring

댓글 수정일

Example: 2026-04-10 08:10:00.000000

data[].versionobject

상위 버전

data[].version.idstring

상위 버전 ID

Example: 8fe89e5a-1d8f-4302-8437-fb0390ecf8eb

data[].authorobject?

댓글 작성자

data[].author.idstring

작성자 사용자 ID

Example: f6035d1a-29df-4d80-8d72-f1bbdddfb6ff

data[].author.namestring

작성자 표시 이름

Example: Jin Seo

data[].author.avatarUrlstring?

작성자 아바타 URL

Example: https://cdn.youvico.com/avatar/jin.png

pageobject

페이지네이션 커서

page.nextstring?

다음 페이지 커서

Example: null

page.prevstring?

이전 페이지 커서

Example: MjAyNi0wNC0xMFQwODowMDowMC4wMDBa

예시

bash

curl 'https://api.youvico.com/api/versions/8fe89e5a-1d8f-4302-8437-fb0390ecf8eb/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY'

json

{
  "data": [
    {
      "id": "2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6",
      "content": "Please tighten the logo safe area.",
      "startTime": 12400,
      "endTime": 18900,
      "drawing": true,
      "createdAt": "2026-04-10 08:00:00.000000",
      "updatedAt": "2026-04-10 08:10:00.000000",
      "version": {
        "id": "8fe89e5a-1d8f-4302-8437-fb0390ecf8eb"
      },
      "author": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://cdn.youvico.com/avatar/jin.png"
      }
    }
  ],
  "page": {
    "next": null,
    "prev": "MjAyNi0wNC0xMFQwODowMDowMC4wMDBa"
  }
}

INFO

삭제된 최상위 댓글도 살아 있는 답글이 있는 경우 여전히 나타날 수 있습니다. 삭제된 댓글이 반환될 때 content, startTime, endTime, drawing, author는 null입니다.

댓글 목록 Tier 4 ​

요청 ​

Path ​

Query ​

응답 ​

예시 ​

댓글 목록 Tier 4

요청

Path

Query

응답

예시