본문으로 건너뛰기

파일 업로드

목차

Request

[POST] https://api.coolsms.co.kr/storage/v1/files

파일을 업로드합니다.

타입별 제한 사이즈

  • [KAKAO] : 500KB // 친구톡
  • [MMS] : 200KB
  • [DOCUMENT] : 5MB
  • [RCS] : 1000KB
  • [ATA] : 500KB // 알림톡
  • [KAKAO_HIGHLIGHT] : 1000KB // 하이라이트
  • [PRIVATE]
  • [FAX]

Authorization 인증 필요

Authorization 인증이란?

계정 권한회원 권한계정 상태회원 상태계정 인증
storage:writeACTIVEACTIVE

Request Structure

{
"file": "string",
"name": "string",
"type": "string",
"link": "string"
}

Body Params

NameTypeRequiredDescription
filestringO파일 (base64 encoded)
namestring파일 이름
typestring문서 타입(DOCUMENT, KAKAO, ATA, MMS, RCS, PRIVATE, KAKAO_HIGHLIGHT, FAX)
linkstring이미지를 눌렀을 때 이동할 링크

Response

Response Structure

{
"kakao": {
"daou": "string",
"biztalk": "string"
},
"type": "string",
"originalName": "string",
"link": "string",
"fileId": "string",
"name": "string",
"url": "string",
"accountId": "string",
"references": [
"string"
],
"dateCreated": "date",
"dateUpdated": "date"
}

Response Description

Response /
NameTypeShould ReturnDescription
kakaoobject카카오 채널 발송(알림톡, 친구톡)에 사용되는 정보
typestringO문서 타입(DOCUMENT, KAKAO, ATA, MMS, RCS, PRIVATE, KAKAO_HIGHLIGHT, FAX)
originalNamestringO원본 파일 이름
linkstring이미지를 눌렀을 때 이동할 링크
fileIdstringO파일 고유 아이디
namestringO파일 이름
urlstringO파일 주소
accountIdstringO계정 고유 아이디
referencesarray해당 파일 사용처 목록
dateCreateddateO최초 생성 날짜
dateUpdateddateO최근 수정 날짜
Response / kakao
NameTypeShould ReturnDescription
daoustring다우기술에 등록되어있는지 여부
biztalkstring비즈톡에 등록되어있는지 여부

문서 생성일 : 2023-04-05