댓글 목록 Tier 4

GET/api/files/:id/commentsCopied!

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

예시

SDK

const comments = await client.comments.list("FX1234567890ABCD");

CLI

youvico comment list --file FX1234567890ABCD

cURL

curl 'https://api.youvico.com/api/files/FX1234567890ABCD/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6",
      "content": "Please tighten the logo safe area.",
      "anchor": null,
      "duration": 12400,
      "createdAt": "2026-04-10 08:00:00.000000",
      "updatedAt": "2026-04-10 08:10:00.000000",
      "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, anchor, duration, author는 null입니다.

요청

경로

idstringrequired

파일 ID

쿼리

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[].anchornumber?

댓글과 연결된 재생 위치

Example: 12

data[].durationnumber?

댓글과 연결된 타임스탬프 또는 구간 값

Example: 12400

data[].createdAtstring

댓글 생성 일시

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

data[].updatedAtstring

댓글 마지막 수정 일시

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

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