파일 관리

파일 등록

• 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, LGU)
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
file	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 이미지 규격