MMS 이미지 업로드

MMS에 활용할 이미지를 사전에 업로드하는 API입니다.

업로드할 이미지는 Request Body 에 안내된 사항을 참조하여 준비해주시기 바랍니다.

비밀키(secret_key)는 [서비스 콘솔 / Sub Account]에서 Sub Account 추가 후 [상세조회] 버튼을 클릭하여 확인할 수 있습니다.

Path variable

Path variable(각 URI 내 중괄호({}) 로 묶인 경로 변수)는 아래 내용을 참고하여 호출 시 누락되지 않도록 해주세요.

code	설명
user_id	사용자ID

MMS 이미지 업로드 API

POST https://tyrar0qvgf.apigw.ntruss.com/image/v1/mms/{user_id}

Headers

Name	Type	Description
Authorization*	string	사용자ID;secret_key
Content-Type*	string	multipart/form-data;charset=utf-8

Request Body

Name	Type	Description
image*	File	업로드할 이미지 파일 제한 사이즈 : 가로 1500 px, 세로 1440 px 파일 형식 : jpg 파일 크기 제한 : 최대 300 kB (업로드된 이미지는 3개월 후 삭제됩니다.)

200: OK 응답 반환 완료

400: Bad Request 응답 반환 실패

Response Body

API 요청 건 별 결과 코드(code 필드)로 정상 접수 여부를 확인할 수 있습니다.

키	타입	설명
file_name	string	이미지 파일명
image_url	string	이미지 경로 url
code	string	접수 결과 코드 (문서 하단 API PLEX 응답 코드 참조)
name	string	접수 결과 코드명
description	string	접수 결과 코드에 대한 설명

정상 요청(성공)

{
    "file_name": "mms_image_sample.jpg",
    "image_url": "https://kr.object.ncloudstorage.com/api-plex-upload/image/mms/{user_id}/mms_sample1.jpg",
    "code": "C100",
    "name": "success",
    "description": "success"
}

잘못된 요청 또는 에러

{
    "code": "C400_2",
    "name": "Invalid Parameter",
    "description": "image width must be (<= 1500 px)"
}

API PLEX 응답 코드

code	HTTP status	설명	상세 설명
C100	200	성공
C400_1	400	잘못된 데이터 타입	response body의 description 참조
C400_2	400	잘못된 요청 파라미터	response body의 description 참조
C400_3	400	필수 파라미터 누락	response body의 description 참조
C404_1	404	데이터를 찾을 수 없음	response body의 description 참조
C500_1	500	서버 내부 에러	response body의 description 참조