3.2 컨텐츠(이미지) 관리

목차

• 1. 파일 업로드
• 2. 컨텐츠 조회
• Appendix

1. 파일 업로드

메시지 발송에 필요한 이미지나 파일을 등록합니다. 각 채널별 특성에 맞는 파일 형식과 크기를 준수해야 합니다.

📌 주의사항

1. 파일 ID는 고유해야 하며, 이미 등록된 ID는 사용할 수 없습니다.
2. 파일 크기는 채널별 제한을 초과할 수 없습니다.
3. 파일 형식은 채널별 지원 형식을 준수해야 합니다.
4. 등록된 파일은 유효기간이 있으며, 만료 시 재등록이 필요합니다.

---

1) 요청 (Request)

URL

POST https://mnt-api.msghub.uplus.co.kr/file/v1/{ch} HTTP/1.1

Headers

Name	Type	필수	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	multipart/form-data

Path Parameters

Name	Type	필수	설명
ch	String	●	채널(mms/rcs/friendtalk/push/rbc/rbc_bia)

Request Body

Name	Type	필수	설명
reqFile	Object	●	파일 요청 정보
filePart	Array	●	파일 목록

reqFile 객체

Name	Type	필수	설명
fileId	String	●	파일 ID (고유값)
wideYn	String	-	카카오 와이드 이미지 여부 (Y/N)
kkoItemListYn	String	-	카카오 아이템리스트 여부 (Y/N)
kkoCarouselFeedYn	String	-	카카오 캐러셀 피드 여부 (Y/N)
kkoCarouselCommerceYn	String	-	카카오 캐러셀 커머스 여부 (Y/N)
brandId	String	-	RCS 브랜드 ID

---

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지
data	Object	결과 데이터 정보
data.ch	String	채널
data.imgUrl	String	이미지 URL (카카오)
data.imgUrlLst	Array	이미지 URL 목록 (카카오)
data.fileId	String	파일 ID
data.fileExpDt	String	파일 만료일시

---

3) 요청 예시 (Sample)

Curl

curl -X POST "https://mnt-api.msghub.uplus.co.kr/file/v1/friendtalk" \
  -H "accept: */*" \
  -H "Content-Type:  multipart/form-data" \
  -H "Authorization: Bearer {token}" \
  -F "reqFile={
    "fileId": "my_image_01",
    "wideYn": "N",
    "kkoItemListYn": "Y",
    "kkoCarouselFeedYn": "N",
    "kkoCarouselCommerceYn": "N"
  }" -F "filePart=@100.jpg;type=image/jpeg"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": {
    "ch": "friendtalk",
    "imgUrl": "https://mud-kage.kakao.com/dn/b....I/lEC.......Xk/img.jpg",
    "imgUrlLst": ["https://mud-kage.kakao.com/dn/bt...zI/lE......Xk/img.jpg", ...],
    "fileId": "my_image_01",
    "fileExpDt": "2026-07-09T09:48:35"
  }
}

2. 컨텐츠 조회

등록된 컨텐츠(파일)를 조회합니다. 파일의 메타데이터와 실제 데이터를 함께 조회할 수 있습니다.

📌 주의사항

1. API 키는 필수 입력 항목입니다.
2. 채널과 파일 ID는 필수 입력 항목입니다.
3. 파일 데이터는 base64로 인코딩되어 반환됩니다.
4. 만료된 파일은 조회할 수 없습니다.

---

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/contents/v1/{apiKey}/{ch}/{fileId} HTTP/1.1

Headers

Name	Type	필수	설명
Authorization	String	●	사용자 인증 토큰

Path Parameters

Name	Type	필수	설명
apiKey	String	●	API 키
ch	String	●	채널(mms/rcs/friendtalk/push)
fileId	String	●	파일 ID

---

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/contents/v1/1/mms/FLE...o4" \
  -H "accept: */*" \
  -H "Authorization: Bearer {token}"

JSON Response

성공시 응답

Headers

헤더명	설명	예시 값
Content-Type	파일 유형에 따른 MIME 타입	image/jpeg
Content-Disposition	파일 처리 관련 정보	inline; filename=“FL…ERJ.jpg”
Content-Length	파일 크기 (바이트)	7922

Body

• 파일의 바이너리 데이터 포함

실패시 응답

{
  "code": "29009",
  "message": "요청한 데이터 없음"
}

Appendix

상품별 이미지 첨부 가능 규격

MMS

• 지원 형식: JPG, JPEG, GIF(GIF는 첫 프레임만 사용)
• 파일 크기: 최대 300KB
• 사이즈: 최대 1500×1440px

RCS

• RCS 공통
  • 지원 형식: JPG, JPEG, PNG, BMP, GIF
  • 파일 크기: 최대 1MB
• 이미지형(세로형)
  • 사이즈: 568x336px (권장)
• 이미지형(이미지 강조)
  • 사이즈: 900x900px 또는 900x1200px (필수)
• 썸네일형
  • 이미지 사이즈: 900x560px (필수)
  • 썸네일 이미지 사이즈: 300x300px (필수)
• SNS형
  • 사이즈: 900x900px (필수)
• SNS형(중간버튼)
  • 사이즈: 900x560px (필수)
• 슬라이드형(Small)
  • 사이즈: 360x336px (권장) / 360x1620px (최대)
• 슬라이드형(Medium)
  • 사이즈: 696x504px (권장) / 696x1620px (최대)

카카오 친구톡

• 친구톡 공통
  • 지원 형식: JPG, JPEG, PNG
  • 파일 크기: 최대 5MB
• 일반 이미지
  • 사이즈: 가로 500px 이상, 가로:세로 비율 2:1 이상 / 3:4 이하
• 와이드 이미지(wideYn=Y)
  • 사이즈: 800×600px (필수)
• 와이드 아이템 리스트 이미지(kkoItemListYn=Y)
  • 첫번째 이미지 사이즈: 가로 500px 이상, 가로:세로 비율 2:1
  • 이미지 사이즈: 가로 500px 이상, 가로:세로 비율 1:1
• 케러셀 피드(kkoCarouselFeedYn=Y)
  • 사이즈: 가로 500px 이상, 가로:세로 비율 2:1 이상 3:4 이하
• 케러셀 커머스(kkoCarouselCommerceYn=Y)
  • 사이즈: 가로 500px 이상, 가로:세로 비율 2:1 이상 3:4 이하

푸시

• 지원 형식: JPG, PNG
• 파일 크기: 최대 1MB

결과 코드

• 결과 코드