API

파일 정보 조회

작성일 2026.03.18 | 수정일 2026.03.18

GET/storage/v1/files/:fileId

Parameters

fileId*— 조회할 파일 ID(32자)

특정 파일의 상세 정보를 조회합니다.

Response

Name	Type	Required	Description
fileId	string	*	파일 고유 ID (접두사: ST01FZ, 32자)
accountId	string	*	계정 고유 ID
name	string	*	파일명
originalName	string		원본 파일명
url	string	*	파일 접근 URL (S3)
type	string	*	파일 타입
link	string\|null		파일 연결 URL
width	number		이미지 가로 크기 (px)
height	number		이미지 세로 크기 (px)
fileSize	number	*	파일 크기 (bytes)
references	array	*	파일 참조 목록 (업로드 직후에는 빈 배열)
dateCreated	string	*	생성일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)

Structure

Response

{
  "fileId": "ST01FZ_abc12345678901234567890",
  "accountId": "12345678901234",
  "name": "프로모션 배너",
  "originalName": "NyT7u.jpg",
  "url": "https://coolsms-storage.s3.ap-northeast-2.amazonaws.com/12345678901234/ST01FZ_abc12345678901234567890",
  "type": "KAKAO",
  "link": "https://example.com/promotion",
  "width": 800,
  "height": 400,
  "fileSize": 102400,
  "references": [],
  "dateCreated": "2024-07-01T12:00:00.000Z",
  "dateUpdated": "2024-07-01T12:00:00.000Z"
}