SMS API,SMPP API MS 스케줄러 API
사용자 가이드
SMS API,SMPP API MS 스케줄러 API
| 수정됨: | 6/24/2025 |
| 버전: | 1.7 |
| 작가: | 케니 콜랜더 노든, KCN |
이 문서는 지정된 수신자만을 위한 것이며 특권, 독점 또는 기타 개인 정보를 포함할 수 있습니다. 착오로 받으신 경우에는 즉시 발신인에게 알리고 원본은 삭제해주시기 바랍니다. 귀하가 문서를 다른 용도로 사용하는 것은 금지되어 있습니다.
변경 내역
| 회전 | 날짜 | By | 이전 릴리스의 변경 사항 |
| 1.0 | 2010-03-16 | 한국씨엔씨 | 생성됨 |
| 1. | 2019-06-11 | 티피에스(TPE) | 업데이트된 LINK 로고 |
| 1. | 2019-09-27 | PNI | SMPP 3.4 사양에 대한 참조 추가 |
| 1. | 2019-10-31 | EP | 유효기간에 대한 관찰 tag |
| 1. | 2020-08-28 | 한국씨엔씨 | 지원되는 TLS 버전에 대한 정보 추가 |
| 2. | 2022-01-10 | 한국씨엔씨 | 배달 보고서에 대한 추가 정보가 추가되었습니다. TLS 1.3에 대한 업데이트된 정보 |
| 2. | 2025-06-03 | GM | 결과 코드 2108이 추가되었습니다. |
| 2. | 2025-06-24 | AK | 할당량 추가됨 |
소개
LINK Mobility는 2001년부터 SMS 배포자였으며 운영자 및 연결 집계자와 함께 작업한 경험이 많습니다. 이 플랫폼은 대용량 트래픽을 처리하고 고가용성을 유지하며 여러 연결을 통해 트래픽을 쉽게 라우팅할 수 있도록 설계되었습니다.
이 문서는 SMSC 플랫폼에 대한 SMPP 인터페이스를 설명하고, 필요한 매개변수와 명령, 지원되는 매개변수를 설명합니다.
이 문서에서는 연결된 메시지, WAPpush, Flash SMS 등과 같은 특정 사용 사례를 다루지 않습니다. 이러한 사례에 대한 자세한 내용은 지원팀에 문의하여 제공받을 수 있습니다.
지원되는 명령
LINK Mobility의 서버는 SMPP 3.4로 취급해야 합니다. 공식 사양은 다음에서 찾을 수 있습니다. https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
모든 방법이 지원되는 것은 아니며 모든 차이점은 아래에 명시되어 있습니다.
4.1 바인드
다음 바인드 명령이 지원됩니다.
- 송신기
- 트랜시버
- 수화기
필수 매개변수:
- system_id – 지원팀에서 획득
- 암호 – 지원에서 얻음
선택적 매개 변수 :
- addr_ton – 제출하는 동안 TON이 Unknown으로 설정된 경우 기본값입니다.
- addr_npi – 제출하는 동안 NPI가 알 수 없음으로 설정된 경우 기본값입니다.
지원되지 않는 매개변수:
- 주소 범위
4.2 바인딩 해제
바인드 해제 명령이 지원됩니다.
4.3 문의 링크
조회 링크 명령이 지원되며 60초마다 호출해야 합니다.
4.4 제출
메시지 전달에는 submit 메소드를 사용해야 합니다.
필수 매개변수:
- 소스_주소_톤
- 소스_주소_npi
- 소스 주소
- 대상_주소_톤
- dest_addr_npi
- 목적지 주소
- esm_class
- 데이터 코딩
- sm_길이
- 짧은 메시지
지원되지 않는 매개변수:
- 서비스 종류
- 프로토콜_ID
- 우선순위_플래그
- 일정_배달_시간
- 교체_if_현재_플래그
- sm_default_msg_id
메모 그 페이로드 tag 지원되지 않으며 통화당 하나의 SMS만 전달될 수 있으며 validation_period를 권장합니다. tag 최소 15분 길이의 값을 가집니다.
4.4.1 권장 TON 및 NPI
submit 명령을 사용하여 메시지를 보낼 때 다음 TON 및 NPI를 사용해야 합니다.
4.4.1.1 출처
다음 TON 및 NPI 조합은 소스 주소에 대해 지원됩니다. 다른 모든 조합은 유효하지 않은 것으로 간주됩니다. TON이 알 수 없음(0)으로 설정된 경우 bind 명령의 기본 TON이 사용됩니다. NPI가 알 수 없음(0)으로 설정된 경우 bind 명령의 기본 NPI가 사용됩니다.
| 톤 | 국립과학수사연구원 | 설명 |
| 영숫자 (5) | 알 수 없음 (0) ISDN(1) |
영숫자 발신자 텍스트로 처리됩니다. |
| 국제 (1) | 알 수 없음 (0) ISDN(1) |
MSISDN으로 취급됩니다. |
| 내셔널 (2) 네트워크별(3) 가입자 수(4) 약어(6) |
알 수 없음 (0) ISDN(1) 내셔널 (8) |
국가별 짧은 번호로 취급됩니다. |
4.4.1.2 목적지
대상 주소에는 다음 TON 및 NPI 조합이 지원됩니다. 다른 모든 조합은 유효하지 않은 것으로 간주됩니다. TON이 알 수 없음(0)으로 설정된 경우 바인드 명령의 기본 TON이 사용됩니다. NPI가 알 수 없음(0)으로 설정된 경우 bind 명령의 기본 NPI가 사용됩니다.
| 톤 | 국립과학수사연구원 | 설명 |
| 국제 (1) | 알 수 없음 (0) ISDN(1) |
MSISDN으로 취급됩니다. |
4.4.2 지원되는 인코딩
다음 인코딩이 지원됩니다. X는 모든 값을 포함할 수 있습니다.
| 디씨에스 | 부호화 |
| 0xX0 | 확장자가 있는 기본 GSM 알파벳 |
| 0xX2 | 8비트 바이너리 |
| 0xX8 | UCS2(ISO-10646-UCS-2) |
몫
5.1 할당량 초과view
할당량은 지정된 기간(예: 일, 주, 월 또는 무기한) 내에 전송할 수 있는 최대 SMS 메시지 수를 정의합니다. 각 할당량은 할당량 ID(UUID)로 고유하게 식별되며 고객의 시간대에 따라 재설정됩니다. 할당량은 Quota Pro를 통해 국가, 지역 또는 기본 수준으로 할당할 수 있습니다.file할당량은 할당량 매핑을 사용하여 동적으로 할당할 수도 있습니다. 이 매핑은 부모 할당량 ID(UUID)와 고유 할당량 키(예: 발신자 또는 사용자)를 특정 할당량 ID에 매핑합니다.
할당량은 현지 지원, 지정된 계정 관리자에 따라 설정되며, 아무것도 지정하지 않으면 기본적으로 할당량이 설정됩니다.
5.2 상태 106 – 할당량 초과
다음과 같은 경우 SMS 메시지가 상태 코드 106("할당량 초과")으로 차단될 수 있습니다.
- 메시지가 현재 간격 내의 해당 quotaId에 대해 정의된 한도를 초과합니다.
- 대상 국가 또는 지역에 할당된 할당량이 없습니다(즉, 프로에서 null 할당량 매핑으로 명시적으로 차단됨)file).
- 일치하는 할당량이 없고 기본 할당량도 정의되어 있지 않아 거부됩니다.
이러한 경우, 시스템은 고객 또는 목적지 기반 제한을 적용하고 오용을 방지하기 위해 추가적인 메시지 처리를 방지합니다.
배송 보고서
없음 또는 성공/실패 결과가 있는 최종 배송만 지원됩니다.
배송 보고서 형식: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 완료 날짜: yyMMddHHmm 통계:
상태에서 사용 가능한 값:
- 배달
- 만료됨
- 거부됨
- 배달되지 않음
- 삭제됨
6.1 확장 배송 보고서 형식
배송 보고서의 확장 정보는 영업 담당자에게 문의하여 요청할 수 있습니다.
배송 보고서 형식: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 제출 날짜:
yyMMddHHmm 완료 날짜: yyMMddHHmm 통계: 오류: 텍스트:
상태에서 사용 가능한 값:
- 배달
- 만료됨
- 거부됨
- 배달되지 않음
- 삭제됨
"sub" 및 "dlvrd" 필드는 항상 000으로 설정되고 "text" 필드는 항상 비어 있습니다.
"err" 필드의 값은 오류 코드 장을 참조하십시오.
지원되는 TLS 버전
TLS 1.2 또는 TLS 1.3은 SMPP를 통한 모든 TLS 연결에 필요합니다.
TLS 1.0 및 1.1에 대한 지원은 2020-11-15 이후 중단됩니다. TLS 버전 1.0 및 1.1은 더 이상 사용되지 않는 이전 프로토콜이며 인터넷 커뮤니티에서 보안 위험으로 간주됩니다.
LINK는 현재 암호화되지 않은 SMPP 연결을 사용 중인 경우 TLS를 사용할 것을 강력히 권장합니다. 암호화되지 않은 SMPP 연결은 2020-09-01부터 LINK에 의해 더 이상 사용되지 않으며 향후 제거될 예정입니다. 암호화되지 않은 연결 제거 날짜는 아직 결정되지 않았습니다.
TLS용 SMPP 서버에 대한 연결은 포트 3601에서 암호화되지 않은 대신 포트 3600에서 이루어집니다.
SMPP 구현이 stunnel을 사용하는 TLS를 지원하지 않는 경우에도 여전히 TLS를 사용할 수 있습니다. https://www.stunnel.org/
오류 코드
다음 오류 코드는 필드가 활성화된 경우 err 필드에 응답될 수 있습니다.
| 오류 코드 | 설명 |
| 0 | 알수없는 오류 |
| 1 | 일시적인 라우팅 오류 |
| 2 | 영구 라우팅 오류 |
| 3 | 최대 스로틀링 초과 |
| 4 | 타임아웃 |
| 5 | 운영자 알 수 없는 오류 |
| 6 | 운영자 오류 |
| 100 | 서비스를 찾을 수 없음 |
| 101 | 사용자를 찾을 수 없습니다 |
| 102 | 계정을 찾지 못했습니다 |
| 103 | 유효하지 않은 비밀번호 |
| 104 | 구성 오류 |
| 105 | 내부 오류 |
| 106 | 할당량 초과 |
| 200 | OK |
| 1000 | 전송된 |
| 1001 | 전달됨 |
| 1002 | 만료됨 |
| 1003 | 삭제됨 |
| 1004 | 모바일 전체 |
| 1005 | 대기 중 |
| 1006 | 배달되지 않음 |
| 1007 | 배송 완료, 청구 지연 |
| 1008 | 청구됨, 메시지가 전송되지 않음 |
| 1009 | 청구됨, 메시지가 전달되지 않음 |
| 1010 | 만료, 운영자 배송 보고서 부재 |
| 1011 | 충전됨, 메시지 전송됨(교환원에게) |
| 1012 | 원격 대기 중 |
| 1013 | 교환원에게 메시지 전송, 충전 지연 |
| 2000 | 잘못된 소스 번호 |
| 2001 | 짧은 숫자는 소스로 지원되지 않습니다. |
| 2002 | 알파는 소스로 지원되지 않습니다. |
| 2003 | MSISDN은 소스 번호로 지원되지 않습니다. |
| 2100 | 짧은 번호는 대상으로 지원되지 않습니다. |
| 2101 | 알파는 대상으로 지원되지 않습니다. |
| 2102 | MSISDN은 대상으로 지원되지 않습니다. |
| 2103 | 작업이 차단됨 |
| 2104 | 알 수 없는 가입자 |
| 2105 | 차단된 목적지 |
| 2106 | 숫자 오류 |
| 2107 | 목적지가 일시적으로 차단됨 |
| 2108 | 잘못된 목적지 |
| 2200 | 충전 오류 |
| 2201 | 가입자의 잔액이 부족합니다. |
|
2202 |
과도한 요금 청구로 구독이 차단되었습니다(프리미엄)
메시지 |
|
2203 |
구독자가 너무 어리다(이 특정
콘텐츠) |
| 2204 | 선불 가입자는 허용되지 않습니다 |
| 2205 | 가입자가 거부한 서비스 |
| 2206 | 결제 시스템에 등록되지 않은 가입자 |
| 2207 | 구독자가 최대 잔액에 도달했습니다. |
| 2208 | 최종 사용자 확인 필요 |
| 2300 | 환불됨 |
|
2301 |
불법 또는 분실로 인해 환불이 불가능합니다.
한국어: |
| 2302 | messageId 누락으로 인해 환불할 수 없습니다. |
| 2303 | 환불 대기 중 |
| 2304 | 환불 시간 초과 |
| 2305 | 환불 실패 |
| 3000 | GSM 인코딩은 지원되지 않습니다 |
| 3001 | UCS2 인코딩은 지원되지 않습니다. |
| 3002 | 이진 인코딩은 지원되지 않습니다. |
| 4000 | 배달 보고서가 지원되지 않습니다. |
| 4001 | 잘못된 메시지 내용 |
| 4002 | 잘못된 관세 |
| 4003 | 잘못된 사용자 데이터 |
| 4004 | 잘못된 사용자 데이터 헤더 |
| 4005 | 잘못된 데이터 코딩 |
| 4006 | 잘못된 VAT |
| 4007 | 대상에 대해 지원되지 않는 콘텐츠 |
문서 / 리소스
 |
링크 모빌리티 SMS API,SMPP API MS 스케줄러 API [PDF 파일] 사용자 가이드 SMS API SMPP API MS 스케줄러 API, SMS API SMPP API, MS 스케줄러 API, 스케줄러 API, API |