Skip to content

정보 가져오기 Default

GET/files/{id}Copied!

파일 정보를 조회해요.

접근 가능한 사용자

사용자비로그인 사용자

접근 권한

프로젝트 접근 방식

Request

Query

accessKeystring | undefined
접근 링크로 조회할 때 사용하는 접근 키

Path

idstringrequired
파일 ID

Response

Returns 200 OK.

idstring
파일 ID
namestring
파일 이름
descriptionstring?
파일 설명
modestring
파일 모드

Possible values: LOCALYOUTUBE

mimeTypestring?
파일 MIME 타입
statusstring
파일 상태

Possible values: UPLOADINGUPLOADEDFAILED

tagstring
파일 태그

Possible values: IN_PROGRESSNEED_REVIEWNEED_EDITON_HOLDAPPROVEDREJECTEDCLOSED

sizenumber
파일 크기
processingIdstring?
파일 처리 ID
allowRestrictedboolean
제한된 리뷰어 접근 허용 여부
ordernumber
표시 순서
projectobject
프로젝트 정보
project.idstring
프로젝트 ID
folderobject
폴더 정보
folder.idstring?
폴더 ID
resourcesarray
파일 리소스 목록
resources[].idstring
파일 리소스 ID
resources[].typestring
파일 리소스 타입

Possible values: ORIGINALSTREAM_MASTERSTREAM_VARIANTPROXY

resources[].urlstring
파일 리소스 URL
resources[].mimeTypestring?
파일 리소스 MIME 타입
resources[].sizenumber
파일 리소스 크기
resources[].metadataRecord<string, unknown>?
파일 리소스 메타데이터

Example

bash
curl 'https://api.youvico.com/files/6ba7b810-9dad-11d1-80b4-00c04fd430c8' \
  -H 'Authorization: Bearer xoau.aB3xK9p2QwR7sT4uV1nM8oP5qL6rN0yZ7eF2gH4jK...'
json
{
  "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "name": "design.png",
  "description": null,
  "mode": "LOCAL",
  "mimeType": "image/png",
  "status": "UPLOADED",
  "tag": "IN_PROGRESS",
  "size": 123456,
  "processingId": null,
  "allowRestricted": true,
  "order": 0,
  "project": { "id": "123e4567-e89b-12d3-a456-426614174000" },
  "folder": { "id": null },
  "resources": []
}