이미지 사전 등록 #

채널별 이미지를 사전 등록 합니다.

Request

URL

POST /file/v1/{ch} HTTP/1.1
Authorization: Bearer {token}
Content-Type: multipart/form-data
Host: mnt-api.msghub.uplus.co.kr

Header

Name	Type	Required	Description
Authorization	String	true	사용자 인증 토큰

Path parameter

Name	Type	Required	Description
reqFile.fileId	String	true	파일 아이디 (^[a-zA-Z0-9-_]{0,20}$)
reqFile.wideYn	String	true	와이드 이미지 여부(*카카오 친구톡 이미지 등록 시 사용)
reqFile.brandId	String	false	RCS 파일 등록 시, 필수
filePart	String	true	파일

참고

파일 사이즈 제한

• mms : 300KB(가로 * 세로 : 1500px * 1420px)
• push : 1MB
• rcs : 1MB (멀티카드 타입의 경우 전체 복수개의 이미지 크기 합계가 1MB 이하여야함)
• friendtalk
  • 일반이미지
    • 권장 사이즈 : 720px*720px,
    • 제한 사이즈 : 가로 500px 미만, 가로:세로 비율 2:1 미만/3:4 초과 시 업로드 불가
  • 와이드이미지 : 2MB 이하 (800px * 600px)

Response

Name	Type	Description
code	String	이미지 사전 등록 요청 결과 코드
message	String	이미지 사전 등록 요청 결과 코드 설명
data	List	이미지 사전 등록 요청 결과 데이터 목록
data.imgUrl	String	이미지 URL * 요청 채널이 MMS, RCS인 경우 FileId를 사용하여 imgUrl 미제공
data.fileId	String	파일 ID
data.fileExpDt	String	파일 만료일시

Sample

Curl

curl -X POST "https://mnt-api.msghub.uplus.co.kr/file/v1/mms"
  -H  "accept: */*"
  -H  "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwiYWNjZXNzVXJsIjoiYXV0aCIsImlzcyI6ImNtLmxndXBsd..."
  -H  "Content-Type: multipart/form-data"
  -F 'reqFile={
          "fileId": "TestImage",
          "wideYn": "N"
      }'
  -F "filePart=@A.jpg;type=image/jpeg"

Response

{
  "code": "10000",
  "message": "성공",
  "data": {
      "imgUrl": "http://api.msghub.uplus.co.kr/contents/v1/1/mms/TestImage",
      "fileId": "TestImage",
      "fileExpDt": "2021-08-16T16:23:11"
  }
}

참고

결과 코드 참고