본문으로 건너뛰기

파일 업로드

POST
/storage/v1/files

파일을 업로드합니다.

타입별 제한

타입용량 제한사용처권장 사이즈비율 제한링크 옵션확장자
KAKAO500KB-----
MMS200KB-----
DOCUMENT5MB-----
RCS1000KB-----
ATA500KB-----
KAKAO_HIGHLIGHT1000KB-----
PRIVATE5MB-----
FAX20MB-----
BMS5MBBMS_IMAGE, BMS_COMMERCE, BMS_PREMIUM_VIDEO(예정)800×400px2:1 이상 3:4 이하있음jpg, png
BMS_WIDE5MBBMS_WIDE800×600px2:1 이상 1:1 이하없음jpg, png
BMS_WIDE_MAIN_ITEM_LIST5MBBMS_WIDE_ITEM_LIST가로 400px 이상2:1없음jpg, png
BMS_WIDE_SUB_ITEM_LIST5MBBMS_WIDE_ITEM_LIST (2~4번째 이미지)가로 400px 이상1:1없음jpg, png
BMS_CAROUSEL_FEED_LIST5MBBMS_CAROUSEL_FEED800×600px or 800×400px2:1 이상 3:4 이하있음jpg, png
BMS_CAROUSEL_COMMERCE_LIST5MBBMS_CAROUSEL_COMMERCE800×600px or 800×400px2:1 이상 3:4 이하있음jpg, png

Body Params

NameTypeRequiredDescription
file
string
O
파일 (base64 encoded)
name
string
-
파일 이름
type
string
-
문서 타입(DOCUMENT, KAKAO, ATA, MMS, RCS, PRIVATE, KAKAO_HIGHLIGHT, FAX, BMS, BMS_WIDE, BMS_WIDE_MAIN_ITEM_LIST, BMS_WIDE_SUB_ITEM_LIST, BMS_CAROUSEL_FEED_LIST, BMS_CAROUSEL_COMMERCE_LIST)
link
string
-
이미지를 눌렀을 때 이동할 링크

Response

NameTypeShould ReturnDescription
kakao
Object
-
카카오 채널 발송(알림톡, 친구톡)에 사용되는 정보
type
string
O
문서 타입(DOCUMENT, KAKAO, ATA, MMS, RCS, PRIVATE, KAKAO_HIGHLIGHT, FAX, BMS, BMS_WIDE, BMS_WIDE_MAIN_ITEM_LIST, BMS_WIDE_SUB_ITEM_LIST, BMS_CAROUSEL_FEED_LIST, BMS_CAROUSEL_COMMERCE_LIST)
originalName
string
O
원본 파일 이름
link
string
-
이미지를 눌렀을 때 이동할 링크
fileId
string
O
파일 고유 아이디
name
string
O
파일 이름
url
string
O
파일 주소
accountId
string
O
계정 고유 아이디
references
Array<Array>
-
해당 파일 사용처 목록
dateCreated
date
O
최초 생성 날짜
dateUpdated
date
O
최근 수정 날짜

Structures

{4 properties
"file": "string",
"name": "string",
"type": "string",
"link": "string"
}
{11 properties
"kakao":
{2 properties...}
"daou": "string",
"biztalk": "string"
}
,
"type": "string",
"originalName": "string",
"link": "string",
"fileId": "string",
"name": "string",
"url": "string",
"accountId": "string",
"references":
[1 items...]
{
}
]
,
"dateCreated": "date",
"dateUpdated": "date"
}