Login
내용 x
SMS API
  • 인쇄
  • PDF
내용

SMS API

  • 인쇄
  • PDF

기본 정보

API URL

https://sens.apigw.ntruss.com/sms/v2

SENS SMS API Swagger 바로가기

API Header

항목 Mandatory 설명
Content-Type Mandatory 요청 Body Content Type을 application/json으로 지정 (POST)
x-ncp-apigw-timestamp Mandatory - 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타냄
- API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-iam-access-key Mandatory 포털 또는 Sub Account에서 발급받은 Access Key ID
x-ncp-apigw-signature-v2 Mandatory - 위 예제의 Body를 Access Key Id와 맵핑되는 SecretKey로 암호화한 서명
- HMAC 암호화 알고리즘은 HmacSHA256 사용

NAVER Cloud Platform 인증키 및 Signature 생성 가이드

메시지

메시지 발송

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

요청 URL

POST https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/messages

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디

Headers

API Header 바로가기

요청 Body

{
    "type":"(SMS | LMS | MMS)",
    "contentType":"(COMM | AD)",
    "countryCode":"string",
    "from":"string",
    "subject":"string",
    "content":"string",
    "messages":[
        {
            "to":"string",
            "subject":"string",
            "content":"string"
        }
    ],
    "files":[
        {
            "name":"string",
            "body":"string"
        }
    ],
    "reserveTime": "yyyy-MM-dd HH:mm",
    "reserveTimeZone": "string",
    "scheduleCode": "string"
}
항목 Mandatory Type 설명 비고
type Mandatory String SMS Type SMS, LMS, MMS (소문자 가능)
contentType Optional String 메시지 Type - COMM: 일반메시지
- AD: 광고메시지
- default: COMM
countryCode Optional String 국가 번호 - SENS에서 제공하는 국가로의 발송만 가능
- default: 82
- 국제 SMS 발송 국가 목록
from Mandatory String 발신번호 사전 등록된 발신번호만 사용 가능
subject Optional String 기본 메시지 제목 LMS, MMS에서만 사용 가능
- LMS, MMS: 최대 40byte
content Mandatory String 기본 메시지 내용 - SMS: 최대 80byte
- LMS, MMS: 최대 2000byte
messages Mandatory Object 메시지 정보 - 아래 항목 참조 (messages.XXX)
- 최대 100개
messages.to Mandatory String 수신번호 붙임표 ( - )를 제외한 숫자만 입력 가능
messages.subject Optional String 개별 메시지 제목 LMS, MMS에서만 사용 가능
- LMS, MMS: 최대 40byte
messages.content Optional String 개별 메시지 내용 - SMS: 최대 80byte
- LMS, MMS: 최대 2000byte
files.name Optional String 파일 이름 - MMS에서만 사용 가능
- 공백 사용 불가
- *.jpg, *.jpeg 확장자를 가진 파일 이름
- 최대 40자
files.body Optional String 파일 바디 - MMS에서만 사용 가능
- 공백 사용 불가
*.jpg, *.jpeg 이미지를 Base64로 인코딩한 값
- 원 파일 기준 최대 300Kbyte
- 파일 명 최대 40자
- 해상도 최대 1500 * 1440
reserveTime Optional String 예약 일시 메시지 발송 예약 일시 (yyyy-MM-dd HH:mm)
reserveTimeZone Optional String 예약 일시 타임존 - 예약 일시 타임존 (기본: Asia/Seoul)
- 지원 타임존 목록
- TZ database name 값 사용
scheduleCode Optional String 스케줄 코드 등록하려는 스케줄 코드
주의
  • 최대 지원 가능한 사이즈를 초과하면 일부 내용이 잘림 처리되어 발송됩니다.
  • 메시지(subject, content) 인코딩은 EUC-KR 기준으로 발송되며 지원하지 않는 이모지 문자를 포함하면 발송에 실패합니다.
참고
  • messages 내에 subject, content를 정의하지 않으면 기본 subject, content로 지정된 값으로 발송됩니다.
  • messages 내에 subject, content가 기본 subject, content 보다 우선 순위가 높습니다.
  • MMS type이지만 첨부하려는 파일이 없으면 LMS로 발송됩니다.
  • reserveTime, scheduleCode를 모두 요청하는 경우 예약 발송으로 처리됩니다. (예약 발송이 우선순위가 높습니다.)

응답 Body

{
    "requestId":"string",
    "requestTime":"string",
    "statusCode":"string",
    "statusName":"string"
}
항목 Mandatory Type 설명 비고
requestId Mandatory String 요청 아이디
requestTime Mandatory DateTime 요청 시간
statusCode Mandatory String 요청 상태 코드 - 202: 성공
- 그 외: 실패
- HTTP Status 규격을 따름
statusName Mandatory String 요청 상태명 - success: 성공
- fail: 실패

응답 Status

HTTP Status Desc
202 Accept (요청 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error

메시지 발송 요청 조회

메시지 발송 요청을 조회합니다.

요청 URL

GET https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/messages?requestId=

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디

Parameters

항목 Mandatory Type 설명 비고
requestId Mandatory String 요청 아이디 발송 요청 아이디

Headers

API Header 바로가기

요청 Body

없음

응답 Body

{
    "requestId":"string",
    "statusCode":"string",
    "statusName":"string",
    "messages":[
        {
            "messageId":"string",
            "requestTime":"string",
            "contentType":"string",
            "countryCode":"string",
            "from":"string",
            "to":"string"
        }
    ]
}
항목 Mandatory Type 설명 비고
requestId Mandatory String 요청 아이디
statusCode Mandatory String 요청 상태 코드 - 202: 성공
- 그 외: 실패
- HTTP Status 규격을 따름
statusName Mandatory String 요청 상태명 - success: 성공
- reserved: 예약 중
- scheduled: 스케줄 중
- fail: 실패
messages.messageId Mandatory String 메시지 아이디
messages.requestTime Mandatory DateTime 발송 요청 시간
messages.contentType Mandatory String 메시지 Type - COMM: 일반 메시지
- AD: 광고 메시지
messages.countryCode Mandatory String 국가 번호
messages.from Mandatory String 발신번호
messages.to Mandatory String 수신번호

응답 Status

HTTP Status Desc
200 OK (요청 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error

메시지 발송 결과 조회

메시지 발송 결과를 조회합니다.

요청 URL

GET https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/messages/{messageId}

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디
messageId Mandatory String 메시지 아이디 메시지 발송 요청 조회 시 반환되는 메시지 식별자

Headers

API Header 바로가기

요청 Body

없음

응답 Body

{
    "statusCode":"string",
    "statusName":"string",
    "messages":[
        {
            "requestTime":"string",
            "contentType":"string",
            "content":"string",
            "countryCode":"string",
            "from":"string",
            "to":"string",
            "status":"string",
            "statusCode":"string",
            "statusMessage":"string",
            "statusName":"string",
            "completeTime":"string",
            "telcoCode":"string",
            "files":[
                {
                    "name":"string"
                }
            ]
        }
    ]
}
항목 Mandatory Type 설명 비고
statusCode Mandatory String 메시징 서버로의 발송 요청 상태 - 200: 성공
- 그 외: 실패
statusName Mandatory String 메시징 서버로의 발송 요청 상태명 - success: 성공
- fail: 실패
messages.requestTime Mandatory DateTime 요청 시간
messages.contentType Mandatory String 메시지 Type - COMM: 일반 메시지
- AD: 광고 메시지
messages.content Mandatory String 메시지 내용 발송 요청했던 content가 그대로 조회나 실제 발송은 type별 길이 제한에 맞춰 발송
messages.countryCode Mandatory String 국가 번호
messages.from Mandatory String 발신번호
messages.to Mandatory String 수신번호
messages.status Mandatory String 메시징 서버에서의 발송 처리 상태 - READY: 대기
- PROCESSING: 처리 중
- COMPLETED: 처리 완료
messages.statusCode Mandatory String 단말 수신 상태 결과 코드 오류 코드 표 참고
messages.statusName Mandatory String 단말 수신 상태 결과명
messages.statusMessage Mandatory String 단말 수신 상태 결과 메시지
messages.completeTime Mandatory DateTime 발송 완료 시간
messages.telcoCode Mandatory String 통신사코드
files.name Optional String 첨부한 파일 이름 MMS에서만 조회 가능

응답 Status

HTTP Status Desc
200 OK (요청 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error

예약 메시지

예약 메시지 상태 조회

메시지 발송 예약 상태를 조회합니다.

GET https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/reservations/{reserveId}/reserve-status

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디
reserveId Mandatory String 예약 메시지 아이디 예약 발송 요청 조회 시 반환되는 메시지 식별자(requestId)

Headers

API Header 바로가기

요청 Body

없음

응답 Body

{
  "reserveId": "string",
  "reserveTimeZone": "string",
  "reserveTime": "string",
  "reserveStatus": "string"
}
항목 Mandatory Type 설명 비고
reserveId Mandatory String 예약 메시지 아이디 예약 발송 요청 조회 시 반환되는 메시지 식별자(requestId)
reserveTime Mandatory String 예약 일시 메시지 발송 예약 일시 (yyyy-MM-dd HH:mm)
reserveTimeZone Mandatory String 예약 일시 타임존 - 예약 일시 타임존 (기본: Asia/Seoul)
- 지원 타임존 목록
- TZ database name 값 사용
reserveStatus Mandatory String 예약 상태 - READY:발송 대기
- PROCESSING: 발송 요청 중
- CANCELED: 발송 취소
- FAIL: 발송 요청 실패
- DONE: 발송 요청 성공
- STALE: 발송 요청 실패 (시간 초과)

응답 Status

HTTP Status Desc
200 OK (조회 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error

예약 메시지 취소

메시지 발송 예약을 취소합니다.

DELETE https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/reservations/{reserveId}

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디
reserveId Mandatory String 예약 메시지 아이디 예약 발송 요청 조회 시 반환되는 메시지 식별자(requestId)

Headers

API Header 바로가기

요청 Body

없음

응답 Body

없음

응답 Status

HTTP Status Desc
204 No Content (삭제 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error

스케줄 메시지

스케줄 메시지 취소

메시지 발송 스케줄을 취소합니다.

DELETE https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/schedules/{scheduleCode}/messages/{messageId}

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디
scheduleCode Mandatory String 스케줄 코드 스케줄 등록시 사용한 코드
messageId Mandatory String 예약 메시지 아이디 스케줄 발송 요청 조회 시 반환되는 메시지 식별자(requestId)

Headers

API Header 바로가기

요청 Body

없음

응답 Body

없음

응답 Status

HTTP Status Desc
204 No Content (삭제 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error

080 수신거부 번호

수신거부 번호 조회

수신거부된 번호를 조회합니다.

요청 URL

GET https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/unsubscribes

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디

Parameters

항목 Mandatory Type 설명 비고
clientTelNo Optional String 수신거부 번호 080 서비스 번호에 등록된 수신거부 번호
pageSize Optional Integer 페이지 사이즈 - default: 100
- 0 ~ 100 사이의 숫자만 입력 가능
pageIndex Optional Integer 페이지 인덱스 default: 0
startTime Optional Integer 조회 시작 시간 - 수신거부 등록 시간 기준
- default: 전체
endTime Optional Integer 조회 종료 시간 - 수신거부 등록 시간 기준
- default: 전체

Headers

API Header 바로가기

요청 Body

없음

응답 Body

[
    {
     "clientTelNo": "string",
     "registerTime": "string",
     "registerType": "char"
    }
]
항목 Mandatory Type 설명 비고
clientTelNo Mandatory String 수신거부 번호
registerTime Mandatory String 등록 시간 foramt: LocalDateTime
registerType Mandatory Char 등록 수단 - M(manual): 수동 등록
- C(call): 전화 등록

응답 Status

HTTP Status Desc
200 OK
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error

수신거부 번호 등록

수신거부할 번호를 등록합니다.

요청 URL

POST https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/unsubscribes

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디

Parameters

없음

Headers

API Header 바로가기

요청 Body

[
    {
        "clientTelNo":"string"
    }
]
항목 Mandatory Type 설명 비고
clientTelNo Mandatory String 수신거부 번호 한 번에 1,000건까지 요청 가능(List)

응답 Body

[
    {
        "clientTelNo": "string",
        "registerTime": "string",
        "registerType": "char"
    }
]
항목 Mandatory Type 설명 비고
clientTelNo Mandatory String 수신거부 번호
registerTime Mandatory String 등록 시간 foramt: LocalDateTime
registerType Mandatory Char 등록 수단 - M(manual): 수동 등록
- C(call): 전화 등록

응답 Status

HTTP Status Desc
200 OK
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error

수신거부 번호 삭제

수신거부된 번호를 삭제합니다.

요청 URL

DELETE https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/unsubscribes

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

Path Variables

항목 Mandatory Type 설명 비고
serviceId Mandatory String 서비스 아이디 프로젝트 등록 시 발급받은 서비스 아이디

Parameters

없음

Headers

API Header 바로가기

요청 Body

[
    {
        "clientTelNo":"string"
    }
]
항목 Mandatory Type 설명 비고
clientTelNo Mandatory String 수신거부 번호 한 번에 1,000건까지 요청 가능(List)

응답 Body

없음

응답 Status

HTTP Status Desc
204 No Content(삭제 완료)
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error

메시지 발송 예제

SMS 메시지

일반 메시지

{
    "type":"SMS",
    "contentType":"COMM",
    "countryCode":"82",
    "from":"01012345678",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

예약 메시지

{
    "reserveTime":"2019-07-25 17:09",
    "type":"SMS",
    "contentType":"COMM",
    "countryCode":"82",
    "from":"01012345678",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

스케줄 메시지

{
    "scheduleCode":"every-pm-16",
    "type":"SMS",
    "contentType":"COMM",
    "countryCode":"82",
    "from":"01012345678",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

광고 메시지

{
    "type":"SMS",
    "contentType":"AD",
    "countryCode":"82",
    "from":"01012345678",
    "content":"(광고) 업체명 내용 [무료 수신거부]08012345678",
    "messages":[
        {
            "to":"01012345678",
            "content":"(광고) 업체명 위의 content와 별도로 해당 번호로만 보내는 내용(optional) [무료 수신거부]08012345678"
        }
    ]
}

LMS 메시지

일반 메시지

{
    "type":"LMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

예약 메시지

{
    "reserveTime":"2019-07-25 17:09",
    "type":"LMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

스케줄 메시지

{
    "scheduleCode":"every-pm-16",
    "type":"LMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

광고 메시지

{
    "type":"LMS",
    "contentType":"AD",
    "from":"01012345678",
    "subject":"제목",
    "content":"(광고) 업체명 내용 [무료 수신거부]08012345678",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"(광고) 업체명 위의 content와 별도로 해당 번호로만 보내는 내용(optional) [무료 수신거부]08012345678"
        }
    ]
}

MMS 메시지

일반 메시지

{
    "type":"MMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ],
    "files":[
        {
            "name":"test.jpg",
            "body":"/9j/asEfsmk..(생략)..siD=="
        }
    ]
}

예약 메시지

{
    "reserveTime":"2019-07-25 17:09",
    "type":"MMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ],
    "files":[
        {
            "name":"test.jpg",
            "body":"/9j/asEfsmk..(생략)..siD=="
        }
    ]
}

스케줄 메시지

{
    "scheduleCode":"every-pm-16",
    "type":"MMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ],
    "files":[
        {
            "name":"test.jpg",
            "body":"/9j/asEfsmk..(생략)..siD=="
        }
    ]
}

광고 메시지

{
    "type":"MMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"(광고) 업체명 내용 [무료 수신거부]08012345678",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"(광고) 업체명 위의 content와 별도로 해당 번호로만 보내는 내용(optional) [무료 수신거부]08012345678"
        }
    ],
    "files":[
        {
            "name":"test.jpg",
            "body":"/9j/asEfsmk..(생략)..siD=="
        }
    ]
}

오류 코드

EMMA v.3 수신 결과 코드

  • EMMA Version: EMMA V3.5.1 이상
  • IB G/W Report Code: 이통사 전송 후 받은 결과 코드
  • IB G/W Response Code: Infobank G/W가 메시지 수신 후 주는 결과 코드
  • IB EMMA: EMMA가 메시지 전송 요청에 대해 처리한 오류 코드

IB G/W Report Code

코드 분류 의미
0 success 성공
2000 failure 전송 시간 초과
2001 failure 전송 실패 (무선망단)
2002 failure 전송 실패 (무선망 -> 단말기단)
2003 failure 단말기 전원 꺼짐
2004 failure 단말기 메시지 버퍼 풀
2005 failure 음영지역
2006 failure 메시지 삭제됨
2007 failure 일시적인 단말 문제
3000 Invalid 전송할 수 없음
3001 Invalid 가입자 없음
3002 Invalid 성인 인증 실패
3003 Invalid 수신번호 형식 오류
3004 Invalid 단말기 서비스 일시 정지
3005 Invalid 단말기 호 처리 상태
3006 Invalid 착신 거절
3007 Invalid Callback URL을 받을 수 없는 폰
3008 Invalid 기타 단말기 문제
3009 Invalid 메시지 형식 오류
3010 Invalid MMS 미지원 단말
3011 Invalid 서버 오류
3012 Invalid 스팸
3013 Invalid 서비스 거부
3014 Invalid 기타
3015 Invalid 전송 경로 없음
3016 Invalid 첨부파일 사이즈 제한 실패
3017 Invalid 발신번호 변작 방지 세칙 위반
3018 Invalid 발신번호 변작 방지 서비스에 가입된 휴대폰 개인가입자 번호
3019 Invalid KISA 또는 미래부에서 모든 고객사에 대하여 차단 처리 요청한 발신번호
3022 Invalid Charset Conversion Error
3023 Invalid 발신번호 사전등록제를 통해 등록되지 않은 번호

IB G/W Response Code

코드 의미
1001 Server Busy (RS 내부 저장 Queue Full)
1002 수신번호 형식 오류
1003 회신번호 형식 오류
1004 SPAM
1005 사용 건수 초과
1006 첨부 파일 없음
1007 첨부 파일 있음
1008 첨부 파일 저장 실패
1009 CLIENT_MSG_KEY 없음
1010 CONTENT 없음
1011 CALLBACK 없음
1012 RECIPIENT_INFO 없음
1013 SUBJECT 없음
1014 첨부 파일 KEY 없음
1015 첨부 파일 NAME 없음
1016 첨부 파일 크기 없음
1017 첨부 파일 Content 없음
1018 전송 권한 없음
1019 TTL 초과
1020 charset conversion error

IB EMMA

코드 의미
E900 Invalid-IB 전송키가 없는 경우
E901 수신번호가 없는 경우
E902 동보인 경우) 수신번호순번이 없는 경우
E903 제목 없는 경우
E904 메시지가 없는 경우
E905 회신번호가 없는 경우
E906 메시지키가 없는 경우
E907 동보 여부가 없는 경우
E908 서비스 타입이 없는 경우
E909 전송 요청 시각이 없는 경우
E910 TTL 타임이 없는 경우
E911 서비스 타입이 MMS MT인 경우, 첨부파일 확장자가 없는 경우
E912 서비스 타입이 MMS MT인 경우, attach_file 폴더에 첨부파일이 없는 경우
E913 서비스 타입이 MMS MT인 경우, 첨부파일 사이즈가 0인 경우
E914 서비스 타입이 MMS MT인 경우, 메시지 테이블에는 파일그룹키가 있는데 파일 테이 블에 데이터가 없는 경우
E915 중복메시지
E916 인증서버 차단번호
E917 고객DB 차단번호
E918 USER CALLBACK FAIL
E919 발송 제한 시간인 경우, 메시지 재발송 처리가 금지 된 경우
E920 서비스 타입이 LMS MT인 경우, 메시지 테이블에 파일그룹키가 있는 경우
E921 서비스 타입이 MMS MT인 경우, 메시지 테이블에 파일그룹키가 없는 경우
E922 동보단어 제약문자 사용 오류
E999 기타오류
이 문서가 도움이 되었습니까?
What's Next
Change password!
Changing your password will log you out immediately. Use the new password to log back in.
Change profile
Success!
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
Logout