> For the complete documentation index, see [llms.txt](https://biztech.gitbook.io/rapi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://biztech.gitbook.io/rapi/file.md). # 파일 관리 ### 파일 등록 * 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

메시지베이스 폼 ID

(정규식패턴: ^[0-9A-Za-z]{1,10}$)

**Response**


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

### ### RCS MMS 이미지 규격 ![](https://4146020217-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBojRKejigyBw6ztWgp7u%2Fuploads%2Fjh8mZKkXnDgN0p1V2c0O%2Fimage.png?alt=media\&token=427789ab-57cf-4a04-ac1a-9209b6a5cf9d)