SEsendon
RCS

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

Changed on

젬텍 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시)
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

Request body multipart/form-data

fileIdstring required

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

messagebaseIdstring

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

filestring binary required

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

Example request

{
  "fileId": "BR.xxxxxxx.20250401xxxxxx"
}

Response

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

codenumber required

응답 코드

messagestring required

응답 메시지

Example response

{
  "code": 200,
  "message": "성공",
  "data": {
    "result": 1000,
    "message": "Success",
    "fileId": "BR.xxxxxxx.20250401xxxxxx",
    "expdate": "2026-04-02T00:00:00.000+09:00"
  }
}

Changes