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

젬텍 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시)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

multipart/form-data — fileId(Max 64B), messagebaseId(선택, Max 40B), file(≤10MB, jpg/jpeg/png/gif)

string
required
length ≤ 64

파일 ID. {brandId}.USERCODE 형식으로 Unique 하게 생성되어야 한다. 동일 fileId 재업로드 시 기존 레코드와 충돌할 수 있다.

string
length ≤ 40

이미지 파일이 사용될 messagebase 템플릿 ID (신규포맷 MMS 전용). 지정 시 젬텍이 템플릿의 width/height 제약을 검증한다.

file
required

업로드 이미지 파일 (jpg / jpeg / png / gif). 수신 한도는 10MB 이며 젬텍 업로드 제한(1MB) 초과 시 서버에서 JPEG 로 리사이즈 후 전송된다.

Responses

413

파일 크기가 10MB 를 초과함

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json