5. 파일 관리

파일 등록

• Maap 미디어 파일을 등록합니다.

• POST /rcsapi/v1/file/send

• Content-Type: multipart/form-data

Request

키	타입	필수	설명
file	File	O	업로드 파일
fileId	String	O	파일 ID
mimeType	String	O	Mime type (image/jpeg, image/png…)
usageType	String	O	사용 타입 (chatbot, messagebase, send)

Response

Code	String	결과 코드
Message	String	실패 시 결과 메시지
data		파일 상세 조회 (파일 상세조회 반환 값 참조)
pagination		페이지 상세 조회 (파일 상세조회 반환 값 참조)

파일 상세 조회

• Maap 미디어 파일을 조회합니다.

• GET /rcsapi/v1/file/info

• Query Parameter

Request

키	타입	필수	설명
comCode	String	O	통신사 코드 (SKT, KT, U+)
fileId	String	O	파일 ID

Response

키	-	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
data		Array	성공 시 데이터
	expiryDate	String	유효 기간
	fileId	String	파일 ID
	mimeType	String	Mime type (image/jpeg, image/png)
	Status	String	파일 상태 (ready, expired)
	usageType	String	사용 타입 (chatbot, messagebase, send)
pagination
	limit	Integer	조회 최대 건수 (기본:100, 최대:1000)
	offset	Integer	시작 offset 번호 (기본:0)
	total	Integer	총 개수

이미지 파일 조회

• GET /rcsapi/v1/brand/msgbase/v2/file/info

• Content-Type: application/json; charset=utf-8

Request

키	타입	필수	설명
brandId	String	O	BizCenter 에서 생성한 브랜드 ID
fileId	String	O	파일 ID (64byte)

Response

키	-	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
data		Array	성공 시 데이터
	fileId	String	등록된 파일의 ID
	url	String	등록된 파일의 URL 정보
	fileName	String	등록된 파일의 이름
	imageWidth	String	이미지 가로 크기
	imageHeight	String	이미지 세로 크기

이미지 파일 등록

• 이미지 템플릿에서 사용할 이미지 파일을 등록합니다.

  파일을 먼저 등록해야 이미지 템플릿 등록 시 fileId를 템플릿 내 지정할 수 있습니다.

• POST /rcsapi/v1/brand/msgbase/v2/file/create

• Content-Type: application/json; charset=utf-8

Request

키	타입	필수	설명
brandId	String	O	BizCenter 에서 생성한 브랜드 ID
fileId	File	O	업로드 파일

Response

키	-	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
data		Array	성공 시 데이터
	fileId	String	등록된 파일의 ID

기본 로고 이미지 조회

• RBC에서 템플릿용으로 제공되는 기본 로고 이미지 정보를 조회합니다.

  조회된 이미지 파일 ID를 템플릿 등록 시 사용할 수 있습니다.

• GET /rcsapi/v1/msgbaseform/logo

• Content-Type: application/json; charset=utf-8

Request

키	타입	필수	설명
messagebaseformId	String	O	메시지베이스 폼 ID (정규식패턴: ^[0-9A-Za-z]{1,10}$)

Response

키	-	타입	설명
code		String	결과 코드
message		String	실패 시 결과 메시지
data		Array	성공 시 데이터
	fileId	String	등록된 파일의 ID
	fileUrl	String	로고 이미지 파일 URL
	fileName	String	로고 이미지 파일 이름

RCS MMS 이미지 규격

ID	메시지 유형		카드 장수	카드 별 최대 버튼 수	본문 글자 수	이미지 사이즈 (가로*세로px)
SMwThT00	MMS	StandaIone Media Top	1	2	1300	568*528(권장)
SMwThM00	MMS	Standalone Media Top	1	2	1300	568*336(권장)
CMwMhM0300	MMS	Carousel Medium	3	2	RCS MMS 슬라이드형 글자/ 라인수 정의 참고	696*504(권장)
CMwMhM0400	MMS	Carousel Medium	4	2		696*504(권장)
CMwMhM0500	MMS	Carousel Medium	5	2		696*504(권장)
CMwMhM0600	MMS	Carousel Medium	6	2		696*504(권장)
CMwShS0300	MMS	Carousel Small	3	2		360*336(권장)
CMwShS0400	MMS	Carousel Small	4	2		360*336(권장)
CMwShS0500	MMS	Carousel Small	5	2		360*336(권장)
CMwShS0600	MMS	Carousel Small	6	2		360*336(권장)
OMH|TV0001	MMS	Highlighted lmage n Title	1	2		900*1200(필수)
OMHITS0001	MMS	Highlighted lmage n Title	1	2		900*900(필수)
OMHIMV0001	MMS	Hlghlighted lmage	1	2	subTitle 4/ subDesc 33 (최대 3벌)	900*1200(필수)
OMHIMS0001	MMS	Highlighted lmage	1	2		900*900(필수)
OMTBNV0001	MMS	Thumbnail	1	2	150	900560(필수)
OMTBNH0001	MMS	Thumbnail	1	2		900*560(필수)
OMSNSS0001	MMS	SNS	1	2		900*900(필수)
OMSNSH0001	MMS	SNS	1	2		900*560(필수)