댓글 목록 Tier 4

GET/api/files/:id/commentsCopied!

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

예시

SDK

const comments = await client.comments.listForFile("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": 12000,
      "duration": 3000,
      "createdAt": "2026-04-10 08:00:00.000000",
      "updatedAt": "2026-04-10 08:10:00.000000",
      "attachments": [],
      "author": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://cdn.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
      }
    }
  ],
  "page": {
    "next": null,
    "prev": "MjAyNi0wNC0xMFQwODowMDowMC4wMDBa"
  }
}

요청

경로

idstringrequired

파일 ID

쿼리

nextstring

다음 페이지 커서

prevstring

이전 페이지 커서

INFO

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

응답

200 OK를 반환합니다.

INFO

삭제된 최상위 댓글도 남아 있는 답글이 있으면 반환될 수 있습니다. 삭제된 댓글이 반환될 때 content, anchor, duration, author는 null이고 attachments는 빈 배열입니다.

dataarray

댓글

data[].idstring

댓글 ID

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

data[].contentstring?

댓글 내용

Example: Please tighten the logo safe area.

data[].anchornumber?

비디오는 밀리초 단위 타임스탬프, 문서는 1부터 시작하는 페이지 번호

Example: 12000

data[].durationnumber?

anchor와 같은 단위의 댓글 구간 길이

Example: 3000

data[].createdAtstring

댓글 생성 일시

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

data[].updatedAtstring

댓글 마지막 수정 일시

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

data[].attachmentsarray

댓글 첨부파일 목록

data[].attachments[].idstring

댓글 첨부파일 ID

Example: CA1234567890ABCD

data[].attachments[].namestring

첨부파일 이름

Example: review-note.pdf

data[].attachments[].urlstring

첨부파일 URL

Example: https://cdn.youvico.com/workspaces/6ba7b810-9dad-11d1-80b4-00c04fd430c8/projects/bdbff5de-96d7-468f-9db0-85fe28bd6b62/FX1234567890ABCD/CA1234567890ABCD/A1b2C3d4E5f6G7h8.pdf

data[].attachments[].mimeTypestring?

첨부파일 MIME 타입

Example: application/pdf

data[].attachments[].sizenumber

첨부파일 크기(바이트)

Example: 1250000

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/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif

pageobject

페이지네이션 커서

page.nextstring?

다음 페이지 커서

Example: null

page.prevstring?

이전 페이지 커서

Example: MjAyNi0wNC0xMFQwODowMDowMC4wMDBa