메시지 발송

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

SMS/LMS/MMS 메시지를 발송합니다.

요청

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

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

요청 헤더

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

요청 경로 파라미터

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

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

요청 바디

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

필드 타입 필수 여부 설명
type String Required 메시지 타입
  • SMS | LMS | MMS
    • SMS: SMS 메시지
    • LMS: LMS 메시지
    • MMS: MMS 메시지
contentType String Optional 메시지 콘텐츠 타입
  • COMM (기본값) | AD
    • COMM: 일반용
    • AD: 광고용
countryCode String Optional 국가 코드
from String Required 발신 번호
subject String Optional 기본 메시지 제목(Byte)
  • 0~40
  • LMS, MMS에서만 사용 가능
content String Required 기본 메시지 내용(Byte)
  • SMS: 0~90
  • LMS, MMS: 0~2000
messages Array Required 메시지 정보
  • 최대 100건 입력 가능
files Array Optional 첨부 파일 목록
  • MMS에서만 사용 가능
  • type을 MMS로 선택해도 첨부 파일이 없으면 LMS로 발송
reserveTime String Optional 예약 일시
  • YYYY-MM-DD HH:mm 형식
  • 예약 발송할 경우, 입력
reserveTimeZone String Optional 예약 타임존
참고
  • 최대 지원 가능한 사이즈를 초과하면 일부 내용이 잘림 처리되어 발송됩니다.
  • 메시지 제목 및 내용 인코딩은 EUC-KR 기준으로 발송되며 지원하지 않는 이모지 문자를 포함하면 발송에 실패합니다.
  • messages 내의 subject, content가 기본 subject, content보다 우선 순위가 높습니다.
  • MMS 타입이지만 첨부 파일이 없으면 LMS로 발송됩니다.

messages

messages에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
to String Required 수신 번호
  • 숫자만 입력 가능
subject String Optional 개별 메시지 제목(Byte)
  • 0~40
  • LMS, MMS에서만 사용 가능
  • 미입력 시 기본 메시지 제목 적용
content String Optional 개별 메시지 내용(Byte)
  • SMS: 0~90
  • LMS, MMS: 0~2000
  • 미입력 시 기본 메시지 내용 적용

files

files에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
fileId String Required 첨부 파일 아이디

요청 예시

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

curl --location --request POST 'https://sens.apigw.ntruss.com/sms/v2/services/ncp:sms:kr:50*********1:sens/messages' \
--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 '{
    "type": "MMS",
    "contentType": "COMM",
    "countryCode": "82",
    "from": "010********",
    "subject": "Delivery Notification",
    "content": "Hello. This is for notifying your delivery status.",
    "messages": [
        {
            "to": "010********",
            "subject": "Delivery Noti",
            "content": "Hello, ******. This is for notifying your delivery status."
        }
    ],
    "files": [
        {
            "fileId": "a136************************74f7"
        }
    ],
    "reserveTime": "2025-11-25 09:50",
    "reserveTimeZone": "Asia/Seoul"
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드 타입 필수 여부 설명
requestId String Required 요청 아이디
requestTime String Required 요청 일시
  • YYYY-MM-DDTHH:mm:ss.sss 형식
statusCode String Required 상태 코드
  • HTTP 상태 코드 규칙을 따름
    • 202: 성공
    • 그 외: 실패
statusName String Required 상태
  • success | fail
    • success: 성공
    • fail: 실패

응답 상태 코드

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

응답 예시

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

{
    "requestId": "RSLA-*************-****-********-IZJQgZEc",
    "requestTime": "2025-11-25T09:39:40.535",
    "statusCode": "202",
    "statusName": "success"
}