---
title: "RCS MMS용 이미지 파일 업로드 (젬텍 연동)"
method: POST
path: "/v2/messages/rcs/mms/image/upload"
tags: ["RCS"]
---

# RCS MMS용 이미지 파일 업로드 (젬텍 연동)

`POST /v2/messages/rcs/mms/image/upload`

## Request

- Base URL: `https://api.sendon.io`
- URL: `https://api.sendon.io/v2/messages/rcs/mms/image/upload`
- Auth: HTTP basic

젬텍 NGS RCS API 규격서 §4 (파일 업로드) 에 대응한다.
프론트엔드가 fileId / messagebaseId / file 을 직접 지정해 업로드하고
성공 시 발급된 `fileId` 를 이후 MMS 발송 시 media 필드로 사용한다.

### 파일 제약
- 지원 확장자: jpg, jpeg, png, gif
- 수신 최대 크기: 10MB. 젬텍 내부 제한(1MB) 초과 시 서버가 자동으로 JPEG 로 리사이즈하여 전송한다.
- 1회 요청당 파일 1개 (단건)

### fileId 생성 규칙
- `{brandId}.{userCode}` 형식으로 Unique 하게 생성 (Max 64 Byte)

### 발송 가능기간 (expdate)
- RCS 용: D+365일 0시까지 (파일 유효기간 D+456일 0시)

## Request body `multipart/form-data`

- RcsMmsUploadImageRequestDto
  - `fileId` string, required: 파일 ID. `{brandId}.{userCode}` 형식으로 Unique 하게 생성되어야 한다. 동일 fileId 재업로드 시 기존 레코드와 충돌할 수 있다.
  - `messagebaseId` string: 이미지 파일이 사용될 messagebase 템플릿 ID (신규포맷 MMS 전용). 지정 시 젬텍이 템플릿의 width/height 제약을 검증한다.
  - `file` string, binary, required: 업로드 이미지 파일 (jpg / jpeg / png / gif). 수신 한도는 10MB 이며 젬텍 업로드 제한(1MB) 초과 시 서버에서 JPEG 로 리사이즈 후 전송된다.

## Response `200`

업로드 성공. data 필드에 젬텍 응답(result/message/fileId/expdate) 과 wasTranscoded 가 담긴다.

- RcsMmsUploadImageResponseDto
  - `code` number, required: 응답 코드
  - `message` string, required: 응답 메시지
  - `data` RcsMmsUploadImageData, required
    - `result` number, required: 젬텍 결과 코드. 성공 시 1000.
    - `message` string, required: 젬텍 결과 메시지 (Max 60 Byte)
    - `fileId` string: 업로드된 파일 ID (Max 64 Byte)
    - `expdate` string: 파일 발송 가능기간 (ISO 8601, RCS 용 D+365일 0시까지)
    - `wasTranscoded` boolean: 젬텍 전송 전 서버에서 JPEG 리사이즈 수행 여부

## Other responses

- `400`: 파일 누락, 확장자 위반, fileId 형식 오류 등 클라이언트 입력 오류
- `413`: 파일 크기가 10MB 를 초과함

## Changes

- **2026-11-03** `71dc377792d9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sendon/apis/sendon-api/changes/v2/messages/rcs/mms/image/upload/post.md)

---

[API](https://skmtc.dev/sendon/apis/sendon-api.md) - [All operations](https://skmtc.dev/sendon/apis/sendon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sendon/apis/sendon-api/revisions/71dc377792d9?raw)