Skip to content

댓글 목록 Tier 4

GET/api/files/:id/commentsCopied!

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

예시

ts
const comments = await client.comments.list("FX1234567890ABCD");
bash
youvico comment list --file FX1234567890ABCD
bash
curl 'https://api.youvico.com/api/files/FX1234567890ABCD/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY'
json
{
  "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, authornull입니다.

요청

경로

idstringrequired
파일 ID

쿼리

nextstring
다음 페이지 커서
prevstring
이전 페이지 커서

INFO

nextprev를 모두 지정하지 않으면, 가장 최근에 생성된 댓글 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