Beta

파일 조회

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

파일을 조회합니다.

예시

curl 'https://api.youvico.com/api/files/FX1234567890ABCD' \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "data": {
    "id": "FX1234567890ABCD",
    "createdAt": "2026-09-01 09:00:00.271845",
    "updatedAt": "2026-09-10 10:30:00.583126",
    "name": "launch-cut.mp4",
    "description": "Final review upload",
    "mode": "LOCAL",
    "mimeType": "video/mp4",
    "status": "UPLOADED",
    "tag": "NEED_REVIEW",
    "size": 82415032,
    "allowRestricted": true,
    "folder": {
      "id": "DX1234567890ABCD"
    },
    "uploader": {
      "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
      "name": "Jin Seo",
      "avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
    },
    "project": {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62"
    }
  }
}
요청
curl -X GET 'https://api.youvico.com/api/files/FX1234567890ABCD' \
-H 'Authorization: Bearer YOUR_API_KEY'
응답200 OK
{
  "data": {
    "id": "FX1234567890ABCD",
    "createdAt": "2026-09-01 09:00:00.271845",
    "updatedAt": "2026-09-10 10:30:00.583126",
    "name": "launch-cut.mp4",
    "description": "Final review upload",
    "mode": "LOCAL",
    "mimeType": "video/mp4",
    "status": "UPLOADED",
    "tag": "NEED_REVIEW",
    "size": 82415032,
    "allowRestricted": true,
    "folder": {
      "id": "DX1234567890ABCD"
    },
    "uploader": {
      "id": "f6035d1a-29df-4d80-8d72-f1bbdddfb6ff",
      "name": "Jin Seo",
      "avatarUrl": "https://files.youvico.com/users/f6035d1a-29df-4d80-8d72-f1bbdddfb6ff/A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6.avif"
    },
    "project": {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62"
    }
  }
}

요청

경로

idstringrequired
파일 ID

응답

200 OK를 반환합니다.

dataobject
파일
data.idstring
파일 ID

예시: FX1234567890ABCD

data.createdAtstring
파일 생성 일시

예시: 2026-09-01 09:00:00.271845

data.updatedAtstring
파일 마지막 수정 일시

예시: 2026-09-10 10:30:00.583126

data.namestring
파일 이름

예시: launch-cut.mp4

data.descriptionstring?
파일 설명

예시: Final review upload

data.modestring
파일 모드

가능한 값: LOCALYOUTUBE

예시: LOCAL

data.mimeTypestring?
MIME 타입

예시: video/mp4

data.statusstring
파일 상태

가능한 값: UPLOADINGUPLOADEDFAILED

예시: UPLOADED

data.tagstring
리뷰 태그

가능한 값: IN_PROGRESSNEED_REVIEWNEED_EDITON_HOLDAPPROVEDREJECTEDCLOSED

예시: NEED_REVIEW

data.sizenumber
파일 크기(바이트)

예시: 82415032

data.allowRestrictedboolean
제한된 리뷰어가 파일에 접근할 수 있는지 여부

예시: true

data.folderobject?
상위 폴더. 프로젝트 루트면 null
data.uploaderobject
업로더
data.projectobject
상위 프로젝트