첨부 파일 업로드

Prev Next

MMS 발송을 위해 파일을 업로드합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /sms/v2/services/{serviceId}/files

요청 헤더

Simple & Easy Notification Service API에서 공통으로 사용하는 헤더에 대한 정보는 Simple & Easy Notification Service 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
serviceId String Required SMS 서비스 아이디

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
fileName String Required 첨부 파일 이름
  • 0~40자
  • jpg, jpeg 확장자를 가진 파일 이름
fileBody String Required 첨부 파일 내용(Kbyte)
  • 0~300
  • jpg, jpeg 이미지를 Base64로 인코딩한 값
  • 해상도 최대 1500x1440 허용
  • 접두어가 있는 경우, 삭제 필요(<예시> data:image/png;base64,)
참고

업로드하려는 파일 이름과 크기와 동일한 파일이 이미 존재하는 경우, 동일한 파일로 인지하여 파일을 재사용합니다. (6일 보관)

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://sens.apigw.fin-ntruss.com/sms/v2/services/ncp:sms:kr:50*********1:sens/files' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
    "fileName": "G0ufjqMy3wBpCucJenTaU.jpg",
    "fileBody": "/9j/4QC8RXhpZgAASUkqAAgAAAAGABIBAwABAAA...AAAAAAAAAAAAAAAAAAAAAAAAAAH/9k="
}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
fileId String Required 첨부 파일 아이디
createTime String Required 첨부 파일 생성 일시
  • YYYY-MM-DDTHH:mm:ss.sss 형식
expireTime String Required 첨부 파일 만료 일시
  • YYYY-MM-DDTHH:mm:ss.sss 형식

응답 상태 코드

Simple & Easy Notification Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Simple & Easy Notification Service 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "fileId": "a136************************74f7",
    "createTime": "2025-11-25T10:12:47.520",
    "expireTime": "2025-11-27T10:12:47.520"
}