Beta

댓글 목록 (파일)

QUERYhttps://api.youvico.com/api/files/:id/comments
요청 제한
Default
API 권한
comments:read

파일의 댓글 목록을 조회합니다.

예시

curl -X QUERY 'https://api.youvico.com/api/files/FX1234567890ABCD/comments' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "sort": { "type": "createdAt", "direction": "asc" } }'
{
  "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.482913",
      "updatedAt": "2026-04-10 08:05:12.118204",
      "deletedAt": null,
      "reply": {
        "count": 1,
        "lastCreatedAt": "2026-04-10 08:10:00.215374"
      },
      "attachments": [
        {
          "id": "CA1234567890ABCD",
          "name": "review-note.pdf",
          "mimeType": "application/pdf",
          "size": 1250000
        }
      ],
      "reactions": [
        {
          "type": "👍",
          "count": 2,
          "me": true
        }
      ],
      "parent": null,
      "author": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
      }
    }
  ],
  "page": {
    "next": null,
    "prev": "WyIyMDI2LTA0LTEwIDA4OjAwOjAwLjQ4MjkxMyIsIjJmYjRlNjBiLTBkOWEtNDZmMy1hNGRjLWNiOWZlOGFkOWJlNiJd"
  }
}
요청
curl -X QUERY 'https://api.youvico.com/api/files/FX1234567890ABCD/comments' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"sort": {
"type": "createdAt",
"direction": "asc"
}
}'
응답200 OK
{
  "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.482913",
      "updatedAt": "2026-04-10 08:05:12.118204",
      "deletedAt": null,
      "reply": {
        "count": 1,
        "lastCreatedAt": "2026-04-10 08:10:00.215374"
      },
      "attachments": [
        {
          "id": "CA1234567890ABCD",
          "name": "review-note.pdf",
          "mimeType": "application/pdf",
          "size": 1250000
        }
      ],
      "reactions": [
        {
          "type": "👍",
          "count": 2,
          "me": true
        }
      ],
      "parent": null,
      "author": {
        "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
        "name": "Jin Seo",
        "avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
      }
    }
  ],
  "page": {
    "next": null,
    "prev": "WyIyMDI2LTA0LTEwIDA4OjAwOjAwLjQ4MjkxMyIsIjJmYjRlNjBiLTBkOWEtNDZmMy1hNGRjLWNiOWZlOGFkOWJlNiJd"
  }
}

요청

경로

idstringrequired
파일 ID

본문

sortobjectrequired
정렬 순서
sort.typestringrequired
정렬 기준 필드

가능한 값: createdAtanchor

예시: createdAt

sort.directionstringrequired
정렬 방향

가능한 값: ascdesc

예시: asc

keywordstring

2-255 characters

검색어
usersarray

1-20 items

댓글 작성자
users[].idstringrequired

UUID

작성자 사용자 ID
hasAnchorboolean
앵커가 있는 댓글인지 여부
nextstring

Maximum 2048 characters

page.next 커서
prevstring

Maximum 2048 characters

page.prev 커서

응답

200 OK를 반환합니다.

dataarray
댓글
data[].idstring
댓글 ID

예시: 2fb4e60b-0d9a-46f3-a4dc-cb9fe8ad9be6

data[].contentstring?
댓글 내용

예시: Please tighten the logo safe area.

data[].anchornumber?
동영상은 밀리초 단위 타임스탬프, 문서는 1부터 시작하는 페이지 번호

예시: 12000

data[].durationnumber?
anchor와 같은 단위의 댓글 구간 길이

예시: 3000

data[].createdAtstring
댓글 생성 일시

예시: 2026-04-10 08:00:00.482913

data[].updatedAtstring
댓글 마지막 수정 일시

예시: 2026-04-10 08:05:12.118204

data[].deletedAtstring?
댓글 삭제 일시

예시: null

data[].replyobject
답글 요약
data[].attachmentsarray
댓글 첨부 파일
data[].reactionsarray
이모지별 리액션
data[].parentobject?
상위 댓글

예시: null

data[].authorobject?
댓글 작성자
pageobject
페이지네이션 커서
page.nextstring?
다음 페이지 커서

예시: null

page.prevstring?
이전 페이지 커서

예시: WyIyMDI2LTA0LTEwIDA4OjAwOjAwLjQ4MjkxMyIsIjJmYjRlNjBiLTBkOWEtNDZmMy1hNGRjLWNiOWZlOGFkOWJlNiJd