SMS API
    • PDF

    SMS API

    • PDF

    기사 요약

    기본 정보

    API URL

    https://sens.apigw.fin-ntruss.com/sms/v2
    
    참고

    네이버 클라우드 플랫폼에서 제공되는 Simple & Easy Notification Service 의 API는 금융 보안 요건에 따라 인터넷을 통합 접근이 불가능합니다. 인터넷을 통한 접근이 필요할 경우 SSL VPN을 통해서만 접근할 수 있습니다. SSL VPN 접속 방법은 SSL VPN 접속을 참고해 주십시오.

    SENS SMS API Swagger 바로가기

    API Header

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

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

    메시지

    메시지 발송

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

    요청 URL

    POST https://sens.apigw.fin-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

    항목MandatoryType설명비고
    serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

    Headers

    요청 Body

    {
        "type":"(SMS | LMS | MMS)",
        "contentType":"(COMM | AD)",
        "countryCode":"string",
        "from":"string",
        "subject":"string",
        "content":"string",
        "messages":[
            {
                "to":"string",
                "subject":"string",
                "content":"string"
            }
        ],
        "files":[
            {
                "fileId": "string"
            }
        ],
        "reserveTime": "yyyy-MM-dd HH:mm",
        "reserveTimeZone": "string"
    }
    
    항목MandatoryType설명비고
    typeMandatoryStringSMS TypeSMS, LMS, MMS (소문자 가능)
    contentTypeOptionalString메시지 TypeCOMM: 일반메시지
    AD: 광고메시지
    (default: COMM)
    countryCodeOptionalString국가번호SENS에서 제공하는 국가로의 발송만 가능
    (default: 82)
    국제 SMS 발송 국가 목록
    fromMandatoryString발신번호사전 등록된 발신번호만 사용 가능
    subjectOptionalString기본 메시지 제목LMS, MMS에서만 사용 가능
    - LMS, MMS: 최대 40byte
    contentMandatoryString기본 메시지 내용SMS: 최대 90byte
    LMS, MMS: 최대 2000byte
    messagesMandatoryObject메시지 정보아래 항목들 참조 (messages.XXX)
    최대 100개
    messages.toMandatoryString수신번호- 를 제외한 숫자만 입력 가능
    messages.subjectOptionalString개별 메시지 제목LMS, MMS에서만 사용 가능
    - LMS, MMS: 최대 40byte
    messages.contentOptionalString개별 메시지 내용SMS: 최대 90byte
    LMS, MMS: 최대 2000byte
    files.fileIdOptionalString파일 아이디MMS에서만 사용 가능
    파일 업로드 참조
    reserveTimeOptionalString예약 일시메시지 발송 예약 일시 (yyyy-MM-dd HH:mm)
    reserveTimeZoneOptionalString예약 일시 타임존예약 일시 타임존 (기본: Asia/Seoul)
    * 지원 타임존 목록
    * TZ database name 값 사용
    • 최대 지원 가능한 사이즈 초과 시 잘림 처리되어 발송 됩니다.
    • 메시지(subject, content) 인코딩은 EUC-KR 기준으로 발송되며, 지원하지 않는 이모지 문자 포함 시 발송에 실패합니다.
    • messages 내에 subject, content를 정의하지 않으면 기본 subject, content로 지정된 값으로 발송 됩니다.
    • messages 내에 subject, content가 기본 subject, content 보다 우선순위가 높습니다.
    • type이 MMS인데 첨부하려는 파일이 없는경우 LMS로 발송됩니다.

    응답 Body

    {
        "requestId":"string",
        "requestTime":"string",
        "statusCode":"string",
        "statusName":"string"
    }
    
    항목MandatoryType설명비고
    requestIdMandatoryString요청 아이디
    requestTimeMandatoryDateTime요청 시간yyyy-MM-dd'T'HH:mm:ss.SSS
    statusCodeMandatoryString요청 상태 코드202 - 성공
    그외 - 실패
    * HTTP Status 규격을 따름
    statusNameMandatoryString요청 상태명success - 성공
    fail - 실패

    응답 Status

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

    파일 업로드

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

    요청 URL

    POST https://sens.apigw.fin-ntruss.com/sms/v2/services/{serviceId}/files
    
    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

    항목MandatoryType설명비고
    serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

    Headers

    요청 Body

    {
        "fileName":"string",
        "fileBody":"string"
    }
    
    항목MandatoryType설명비고
    fileNameMandatoryString파일 이름- .jpg, .jpeg 확장자를 가진 파일 이름
    - 최대 40자
    fileBodyMandatoryString파일 바디- .jpg, .jpeg 이미지를 Base64로 인코딩한 값
    - 원 파일 기준 최대 300Kbyte
    - 해상도 최대 1500 * 1440
    참고

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

    응답 Body

    {
        "fileId":"string",
        "createTime":"string",
        "expireTime":"string"
    }
    
    항목MandatoryType설명비고
    fileIdMandatoryString파일 아이디MMS 메시지 발송 시 활용
    createTimeMandatoryDateTime파일 업로드 시간
    expireTimeMandatoryDateTime파일 만료 시간

    응답 Status

    HTTP StatusDesc
    200OK (업로드 완료)
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    429Too Many Requests
    500Internal Server Error

    메시지 발송 요청 조회

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

    요청 URL

    GET https://sens.apigw.fin-ntruss.com/sms/v2/services/{serviceId}/messages
    
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    
    

    Path Variables

    항목MandatoryType설명비고
    serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

    Parameters

    항목MandatoryType설명비고
    requestIdMandatoryString요청 아이디발송 요청 아이디
    requestStartTimeMandatoryString조회 시간 시작 시각yyyy-MM-dd HH:mm:ss
    requestEndTimeMandatoryString조회 시간 종료 시각yyyy-MM-dd HH:mm:ss
    completeStartTimeMandatoryString발송 완료 시작 시간yyyy-MM-dd HH:mm:ss
    completeEndTimeMandatoryString발송 완료 종료 시간yyyy-MM-dd HH:mm:ss
    messageIdOptionalString메시지 아이디
    typeOptionalString메세지 타입SMS, LMS, MMS
    contentTypeOptionalString콘텐츠 타입- COMM: 일반 메시지
    - AD: 광고 메시지
    countryCodeOptionalString국가 코드
    statusOptionalString발송 요청 상태- READY: 대기
    - PROCESSING: 처리 중
    - COMPLETED: 처리 완료
    fromOptionalString메세지 발신 번호붙임표 (-)를 제외한 번호
    toOptionalString메세지 수신 번호붙임표 (-)를 제외한 번호
    statusNameOptionalString단말 수신 상태- SUCCESS: 성공
    - FAIL: 실패
    pageIndexOptionalInteger페이지 번호default: 0
    pageSizeOptionalInteger페이지 크기default: 20, max: 100
    requestId를 포함한 조회시, default: 1000
    참고
    • 메시지 발송 이력은 최근 90일 이내의 이력만 조회할 수 있습니다.
    • requestId 또는 requestStartTime + requestEndTime 또는 completeStartTime + completeEndTime 중에 하나는 필수입니다.
    • requestStartTime + requestEndTime과 completeStartTime + completeEndTime은 동시에 사용할 수 없습니다.
    • requestStartTime ~ requestEndTime의 조회 범위는 최대 30일로 제한됩니다.
    • completeStartTime ~ completeEndTime의 조회 범위는 최대 24시간으로 제한됩니다.

    Headers

    API Header 바로가기

    요청 Body

    없음
    

    응답 Body

    {
        "statusCode": "string",
        "statusName": "string",
        "messages": [
            {
                "requestId": "string",
                "campaignId": "string",
                "messageId": "string",
                "requestTime": "string",
                "contentType": "string",
                "type": "string",
                "countryCode": "string",
                "from": "string",
                "to": "string",
                "completeTime": "string",
                "telcoCode": "string",
                "status": "string",
                "statusCode": "string",
                "statusName": "string",
                "statusMessage": "string"
            }
        ],
        "pageIndex": "integer",
        "pageSize": "integer",
        "itemCount": "integer",
        "hasMore": "boolean"
    }
    
    항목MandatoryType설명비고
    statusCodeMandatoryString메시징 서버로의 발송 요청 상태- 202: 성공
    - 그 외: 실패
    - HTTP Status 규격을 따름
    statusNameMandatoryString메시징 서버로의 발송 요청 상태명- success: 성공
    - reserved: 예약 중
    - fail: 실패
    messages.requestIdMandatoryString메시지 요청 아이디
    messages.messageIdMandatoryString메시지 아이디
    messages.requestTimeMandatoryString발송 요청 시간yyyy-MM-dd HH:mm:ss
    messages.contentTypeMandatoryString메시지 Type- COMM: 일반 메시지
    - AD: 광고 메시지
    messages.countryCodeMandatoryString국가 번호
    messages.fromMandatoryString발신번호
    messages.toMandatoryString수신번호
    messages.statusMandatoryString발송 요청 상태- READY: 대기
    - PROCESSING: 처리 중
    - COMPLETED: 처리 완료
    messages.statusCodeOptionalString단말 수신 상태 결과 코드- 0: 성공
    - 그 외: 실패 (오류 코드 표 참고
    messages.statusNameOptionalString단말 수신 상태 결과명- success: 성공
    - fail: 실패
    messages.statusMessageOptionalString단말 수신 상태 결과 메시지
    messages.completeTimeOptionalString발송 완료 시간yyyy-MM-dd HH:mm:ss
    messages.telcoCodeOptionalString통신사코드
    pageIndexMandatoryInteger페이지 인덱스 (0부터 시작)
    pageSizeMandatoryInteger페이지 사이즈
    itemCountMandatoryInteger조회한 페이지 내의 메시지 수
    hasMoreMandatoryBoolean다음 페이지 존재 여부
    참고

    요청 상태가 완료(status: COMPLETED)가 되기 전에는 수신 결과에 해당하는 아래 필드들은 조회되지 않습니다.

    • statusCode
    • statusName
    • statusMessage
    • completeTime
    • telcoCode

    메시징 서버로의 발송 요청 상태명이 reserved(예약중)인 경우에는, messages 필드들은 조회되지 않습니다.

    응답 Status

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

    메시지 발송 결과 조회

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

    요청 URL

    GET https://sens.apigw.fin-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

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

    Headers

    요청 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",
                        "fileId":"string"
                    }
                ]
            }
        ]
    }
    
    항목MandatoryType설명비고
    statusCodeMandatoryString메시징 서버로의 발송 요청 상태200: 성공
    그외: 실패
    statusNameMandatoryString메시징 서버로의 발송 요청 상태명success - 성공
    fail - 실패
    messages.requestTimeMandatoryDateTime요청 시간yyyy-MM-dd HH:mm:ss
    messages.contentTypeMandatoryString메시지 TypeCOMM: 일반메시지
    AD: 광고메시지
    messages.contentMandatoryString메시지 내용발송 요청했던 content가 그대로 조회되지만,
    실제 발송시에는 type별 길이 제한에 맞춰 발송
    messages.countryCodeMandatoryString국가번호
    messages.fromMandatoryString발신번호
    messages.toMandatoryString수신번호
    messages.statusMandatoryString메시징 서버에서의 발송 처리 상태READY: 대기
    PROCESSING: 처리 중
    COMPLETED: 처리 완료
    messages.statusCodeMandatoryString단말 수신 상태 결과 코드- 0: 성공
    - 그 외: 실패 (오류 코드 표 참고
    messages.statusNameMandatoryString단말 수신 상태 결과명- success: 성공
    - fail: 실패
    messages.statusMessageMandatoryString단말 수신 상태 결과 메시지
    messages.completeTimeMandatoryDateTime발송 완료 시간yyyy-MM-dd HH:mm:ss
    messages.telcoCodeMandatoryString통신사코드
    files.nameOptionalString첨부한 파일 이름MMS에서만 조회 가능
    files.fileIdOptionalString첨부한 파일 아이디MMS에서만 조회 가능
    참고

    메시지 발송 결과 이력은 최근 90일 이내의 이력만 조회할 수 있습니다.

    응답 Status

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

    예약 메시지

    예약 메시지 상태 조회

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

    GET https://sens.apigw.fin-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

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

    Headers

    요청 Body

    없음
    

    응답 Body

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

    예약 메시지 취소

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

    DELETE https://sens.apigw.fin-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

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

    Headers

    요청 Body

    없음
    

    응답 Body

    없음
    

    응답 Status

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

    080 수신거부 번호

    수신거부 번호 조회

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

    요청 URL

    GET https://sens.apigw.fin-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

    항목MandatoryType설명비고
    serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

    Parameters

    항목MandatoryType설명비고
    clientTelNoOptionalString수신거부 번호080 서비스 번호에 등록된 수신거부 번호
    pageSizeOptionalInteger페이지 사이즈default: 100
    0 ~ 100 사이의 숫자만 입력 가능
    pageIndexOptionalInteger페이지 인덱스default: 0
    startTimeOptionalInteger조회 시작 시간수신거부 등록 시간 기준
    default: 전체
    endTimeOptionalInteger조회 종료 시간수신거부 등록 시간 기준
    default: 전체

    Headers

    요청 Body

    없음
    

    응답 Body

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

    응답 Status

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

    수신거부 번호 등록

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

    요청 URL

    POST https://sens.apigw.fin-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

    항목MandatoryType설명비고
    serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

    Parameters

    없음
    

    Headers

    요청 Body

    [
        {
            "clientTelNo":"string"
        }
    ]
    
    항목MandatoryType설명비고
    clientTelNoMandatoryString수신거부 번호한번 요청에 1000건까지 요청 가능(List)

    응답 Body

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

    응답 Status

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

    수신거부 번호 삭제

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

    요청 URL

    DELETE https://sens.apigw.fin-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

    항목MandatoryType설명비고
    serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

    Parameters

    없음
    

    Headers

    요청 Body

    [
        {
            "clientTelNo":"string"
        }
    ]
    
    항목MandatoryType설명비고
    clientTelNoMandatoryString수신거부 번호한번 요청에 1000건까지 요청 가능(List)

    응답 Body

    없음
    

    응답 Status

    HTTP StatusDesc
    204No Content(삭제 완료)
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    429Too Many Requests
    500Internal 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)"
            }
        ]
    }
    

    광고 메시지

    {
        "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)"
            }
        ]
    }
    

    광고 메시지

    {
        "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":[
            {
                "fileId": "4fe2078b-5926-42f2-b6b3-0c7bab9b8c5a"
            }
        ]
    }
    

    예약 메시지

    {
        "reserveTime":"2019-07-25 17:09",
        "type":"MMS",
        "contentType":"COMM",
        "from":"01012345678",
        "subject":"제목",
        "content":"내용",
        "messages":[
            {
                "to":"01012345678",
                "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
                "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
            }
        ],
        "files":[
            {
                "fileId": "4fe2078b-5926-42f2-b6b3-0c7bab9b8c5a"
            }
        ]
    }
    

    광고 메시지

    {
        "type":"MMS",
        "contentType":"AD",
        "from":"01012345678",
        "subject":"제목",
        "content":"(광고) 업체명 내용 [무료 수신거부]08012345678",
        "messages":[
            {
                "to":"01012345678",
                "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
                "content":"(광고) 업체명 위의 content와 별도로 해당 번호로만 보내는 내용(optional) [무료 수신거부]08012345678"
            }
        ],
        "files":[
            {
                "fileId": "4fe2078b-5926-42f2-b6b3-0c7bab9b8c5a"
            }
        ]
    }
    

    오류 코드

    EMMA v.3 수신 결과 코드

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

    IB G/W Report Code

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

    IB G/W Response Code

    코드의미
    1001Server Busy (RS 내부 저장 Queue Full)
    1002수신번호 형식 오류
    1003회신번호 형식 오류
    1004SPAM
    1005사용 건수 초과
    1006첨부 파일 없음
    1007첨부 파일 있음
    1008첨부 파일 저장 실패
    1009CLIENT_MSG_KEY 없음
    1010CONTENT 없음
    1011CALLBACK 없음
    1012RECIPIENT_INFO 없음
    1013SUBJECT 없음
    1014첨부 파일 KEY 없음
    1015첨부 파일 NAME 없음
    1016첨부 파일 크기 없음
    1017첨부 파일 Content 없음
    1018전송 권한 없음
    1019TTL 초과
    1020charset conversion error
    S000중계사 요청 실패 (서버 에러)
    S001중계사 요청 실패 (서버 에러)
    S002중계사 요청 실패 (잘못된 요청)
    S003중계사 요청 실패 (스팸 처리)
    S004쿼터 초과
    S005잘못된 MMS 파일
    S006MMS 파일을 찾을 수 없음
    S007MMS 파일 만료
    S008MMS 파일 크기 초과
    S009MMS 파일 해상도 초과
    S010MMS 파일 업로드 쿼터 초과
    S011MMS 파일 업로드 실패
    S012발신번호 세칙 오류
    S998예기치 못한 서버 오류
    S999기타 오류

    IB EMMA

    코드의미
    E900Invalid-IB 전송키가 없는 경우
    E901수신번호가 없는 경우
    E902동보인 경우) 수신번호순번이 없는 경우
    E903제목 없는 경우
    E904메시지가 없는 경우
    E905회신번호가 없는 경우
    E906메시지키가 없는 경우
    E907동보 여부가 없는 경우
    E908서비스 타입이 없는 경우
    E909전송요청시각이 없는 경우
    E910TTL 타임이 없는 경우
    E911서비스 타입이 MMS MT인 경우, 첨부파일 확장자가 없는 경우
    E912서비스 타입이 MMS MT인 경우, attach_file 폴더에 첨부파일이 없는 경우
    E913서비스 타입이 MMS MT인 경우, 첨부파일 사이즈가 0인 경우
    E914서비스 타입이 MMS MT인 경우, 메시지 테이블에는 파일그룹키가 있는데 파일 테이 블에 데이터가 없는 경우
    E915중복메시지
    E916인증서버 차단번호
    E917고객DB 차단번호
    E918USER CALLBACK FAIL
    E919발송 제한 시간인 경우, 메시지 재발송 처리가 금지 된 경우
    E920서비스 타입이 LMS MT인 경우, 메시지 테이블에 파일그룹키가 있는 경우
    E921서비스 타입이 MMS MT인 경우, 메시지 테이블에 파일그룹키가 없는 경우
    E922동보단어 제약문자 사용 오류
    E999기타오류

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    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.