댓글 목록 (파일)
QUERY
https://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
keywordstring2-255 characters
검색어
usersarray1-20 items
댓글 작성자
users[].idstringrequiredUUID
작성자 사용자 ID
hasAnchorboolean앵커가 있는 댓글인지 여부
nextstringMaximum 2048 characters
page.next 커서
prevstringMaximum 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