파일 업로드

목차

• Request
  • Authorization 인증 필요
  • Request Structure
  • Body Params
• Response
  • Response Structure
  • Response Description

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:write		ACTIVE	ACTIVE

Request Structure

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

Body Params

Name	Type	Required	Description
file	string	O	파일 (base64 encoded)
name	string		파일 이름
type	string		문서 타입(DOCUMENT, KAKAO, ATA, MMS, RCS, PRIVATE, KAKAO_HIGHLIGHT, FAX)
link	string		이미지를 눌렀을 때 이동할 링크

---

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 /

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

Response / kakao

Name	Type	Should Return	Description
daou	string		다우기술에 등록되어있는지 여부
biztalk	string		비즈톡에 등록되어있는지 여부

---

문서 생성일 : 2023-04-05