LINK 모빌리티 구현 가이드 REST API SMS
LINK Mobility는 메시지 전달, 소액 결제 및 위치 기반 서비스를 위한 서비스를 제공합니다. 이 플랫폼은 서비스 제공자와 운영자 간의 투명한 화이트 라벨 콘텐츠 인수자 및 거래 라우터 역할을 합니다.
LINK Mobility는 SMS 전송과 같은 LINK Mobility 서비스에 액세스하는 데 사용할 수 있는 RESTful API를 제공합니다. 이 API는 사용하기 쉽고 모든 최신 언어 및 프레임워크와 호환되도록 설계되었습니다. 선택한 언어를 사용하여 애플리케이션은 Link Mobility REST API를 사용하여 강력한 메시징 및 결제 기능을 구현할 수 있습니다.
© LINK Mobility, 10년 2021월 XNUMX일
법적 정보
이 문서에 제공된 정보는 Netsize의 단독 재산이자 저작권입니다. 기밀이며 엄격히 정보 목적으로만 사용하도록 의도되었습니다. 구속력이 없으며 통지 없이 변경될 수 있습니다. 무단 공개 또는 사용은 불법으로 간주됩니다.
Netsize™와 linkmobility™는 프랑스, EEC 및 국제 지적 재산권법에 의해 보호됩니다.
기타 모든 상표는 해당 소유자의 단독 재산입니다.
본 문서에 포함된 어떠한 내용도 Netsize의 특허, 저작권 또는 상표에 대한 라이센스나 권리를 부여하는 것으로 해석되어서는 안 됩니다.
넷사이즈
Société anonyme au capital de 5 478 070유로
Siège social :62, avenue Emile Zola92100 불로뉴 – 프랑스
418 712 477 RCS 낭테르
http://www.LinkMobility.com
http://www.linkmobility.com
문서의 범위
이 문서는 서비스 제공자가 SMS용 LINK Mobility REST API를 사용하는 방법을 설명합니다. 서비스 제공자의 서비스를 구현하는 기술 아키텍트와 설계자를 대상으로 합니다.
1. 기본 사용법
SMS를 보내는 것은 매우 쉽습니다. LINK Mobility에 HTTP 요청을 보내면 됩니다. web 브라우저.
2. 기능적 이상view
LINK Mobility 시스템은 SMS 메시지에 대해 다음과 같은 기본 기능을 제공합니다.
텍스트나 바이너리(예: WAP Push) 프리미엄 및 표준 요금 메시지와 같은 MT(모바일 종료) SMS 메시지를 보냅니다.
제출된 MT 메시지에 대한 전달 보고서를 받습니다.
모바일 발신(MO) SMS 메시지 수신, 프리미엄 및 표준 요금.
SMS REST API는 표준 요금 MT SMS 메시지를 전송하는 데 전념합니다.
API는 모든 SMS 메시지를 비동기적으로 전송하여 다음과 같은 기능을 활성화합니다.
"방출 후 방치" - 서비스 제공자는 더 예측 가능한 응답 시간을 원하며 운영자의 결과를 기다리고 싶어하지 않습니다.
재시도 기능 – LINK Mobility는 운영자에게 일시적인 문제가 있는 경우 메시지를 다시 보냅니다.
2.1 SMS 메시지 보내기
서비스 제공자 Netsize 소비자
- MT 메시지 보내기
- 반환 메시지 ID
- SMS 메시지 전송
- 배달 보고서 전달
- 배송 보고서 보내기
SMS 메시지를 보내는 기본적인 흐름은 다음과 같습니다.
서비스 제공자는 LINK Mobility 시스템을 통해 수신자에게 SMS 메시지를 보내도록 요청합니다.
메시지 ID가 서비스 공급자에게 반환됩니다. 이 ID는 예를 들어 메시지를 올바른 배달 보고서와 연관시키는 데 사용할 수 있습니다.
LINK Mobility는 라우팅을 처리하고 SMS 메시지를 지정된 소비자에게 전달합니다.
전달 보고서가 트리거되는 경우는 SMS 메시지가 소비자 기기에 전달될 때입니다.
배달 보고서는 서비스 제공자에게 전송됩니다. 보고서에는 2단계에서 반환된 것과 동일한 메시지 ID가 포함됩니다.
대체 흐름: 잘못된 요청
요청에서 제공된 매개변수 또는 사용자 자격 증명이 유효하지 않으면 오류가 서비스 공급자에게 반환됩니다. 오류는 거부 이유를 나타내고 흐름은 종료됩니다. 메시지 ID는 반환되지 않습니다.
3. 엔드포인트
SMS 리소스는 다음 경로를 사용하여 액세스합니다.
/restapi/v1/sms
Example URL
https://europe.ipx.com/restapi/v1/sms
연결 보안을 위해 LINK Mobility REST API는 HTTPS를 통해서만 접근할 수 있습니다.
Link Mobility 서버 인증서는 Thawte Server CA에서 서명되었습니다.
4. 운영
SMS 서비스는 다음과 같은 작업을 제공합니다.
| 이름 | 길 |
| 보내다 | /restapi/v1/sms/전송 |
4.1 보내기
보내기 작업은 단일 수신자에게 SMS를 보내는 데 사용됩니다.
이 작업은 기본 사용자와 고급 사용자 모두를 대상으로 합니다. 가장 간단한 경우, SMS를 전달하려면 목적지 주소와 메시지 텍스트만 필요합니다. LINK Mobility는 데이터 코딩 체계를 감지하고 필요한 경우 메시지를 여러 메시지 부분으로 자동 연결합니다.
고급 사용을 위해 서비스 공급자는 사용자 데이터 헤더를 포함한 메시지 형식을 전체적으로 제어하기 위한 선택적 매개변수를 사용할 수 있습니다.
서비스 제공자는 연결된 메시지를 보낼 수 있지만, 사용자 데이터와 사용자 데이터 헤더는 서비스 제공자가 준비해야 하며, 메시지는 LINK Mobility를 향해 여러 번의 전송 요청을 통해 전송되어야 합니다.
5. 인증
모든 요청에는 HTTP 기본 인증 체계를 사용하여 사용자 이름과 비밀번호가 제출됩니다.
https://www.w3.org/Protocols/HTTP/1.0/spec.html#BasicAA
자격 증명은 HTTP 요청의 Authorization 헤더에 전송됩니다. 클라이언트는 여기에 설명된 대로 헤더 필드를 구성합니다.
https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side
예를 들어ample, 사용자 이름이 john이고 비밀번호가 changeme인 경우 결과 Authorization 헤더는 다음과 같습니다.
권한: 기본 am9objpjaGFuZ2VtZSA=
폴백으로 사용자 이름과 비밀번호를 요청 매개변수로 제출할 수 있습니다. 이는 기본 인증을 지원하지 않는 클라이언트에만 권장됩니다.
6. 요청 제출
6.1 쿼리 문자열
요청 매개변수는 이름/값 쌍을 포함하는 쿼리 문자열로 제출됩니다. 쿼리 문자열은 퍼센트 인코딩(Percent Encoding)을 사용하여 인코딩됩니다.URL 부호화).
http://www.w3schools.com/tags/ref_urlencode.asp
예를 들어ample, Hello World!는 Hello+World%21로 인코딩됩니다.
6.2 필수 요청 매개변수
| 이름 | 최대 길이 | 설명 |
| 목적지주소 | 40 | SMS 메시지를 보내야 하는 MSISDN(국가 코드로 시작). 예amp르: 46123456789. 일부 시장(소비자 MSISDN을 난독화해야 함)의 경우 이 값은 영숫자 별칭이 될 수도 있으며 접두사로 "#"가 붙습니다. |
| 메시지텍스트 | 1600 | SMS 메시지 내용. |
6.3 선택적 요청 매개변수(고급 사용용)
| 이름 | 최대 길이 | 설명 |
| 출발지주소 | 16 | 발신 SMS 메시지의 발신 주소입니다. 발신 주소 유형은 originatorTON 매개변수로 정의됩니다. 짧은 숫자의 최대 길이는 16입니다. 알파벳 숫자 발신자는 최대 길이가 11자인 GSM 기본 알파벳으로 제한됩니다. MSISDN 발신자 최대 길이는 15입니다(destinationAddress 요소와 동일한 형식 사용). originatingAddress 및 originatingTON이 시스템에서 선택된 경우 생략할 수 있습니다. 이 기능은 시장 및 구성에 따라 달라집니다. 동작은 운영자 통합에 따라 달라질 수 있습니다. |
| 발신자TON | 1 | 발신 주소의 번호 유형(TON): 0 – 짧은 숫자 1 – 알파벳 숫자(최대 길이 11) 2 – MSISDN originatingAddress 및 originatingTON이 시스템에서 선택될 경우 생략할 수 있습니다. 이 기능은 시장 및 구성에 따라 달라집니다. 동작은 운영자 통합에 따라 달라질 수 있습니다. |
| 사용자 데이터 헤더 | 280 | 사용자 데이터 헤더와 사용자 데이터는 최대 140개, 즉 280진수로 인코딩된 경우 XNUMX개 옥텟을 포함할 수 있습니다. 이 매개변수는 항상 XNUMX진수로 인코딩됩니다. |
| 디씨에스 | 3 | 데이터 코딩 체계. 동작은 운영자 통합에 따라 달라질 수 있습니다. |
| 피디 | 3 | 프로토콜 ID. 동작은 운영자 통합에 따라 달라질 수 있습니다. |
| 상대적유효시간 | 6 | 상대적 유효 시간(초)(LINK Mobility에 제출하는 시간과 비교). 최대값은 604800(7일)이고 기본값은 48시간입니다. 동작은 운영자 통합에 따라 달라질 수 있습니다. |
| 배달시간 | 20 | 가장 타임스트amp SMS 메시지를 전달해야 하는 시점(지연된 전달 시간). 날짜 시간 형식 섹션을 참조하세요. |
| 상태보고플래그 | 1 | 보고서 요청 전달: 0 – 배달 보고서 없음(기본값) 1 – 배송 보고서 요청됨 9 – 서버 전달 보고서 요청됨(LINK Mobility는 보고서를 서비스 공급자에게 전달하지 않지만 보고서 등에서 사용할 수 있도록 함) |
| camp이름 | 50 | LINK Mobility 거래는 tag이 이름으로 ged됩니다. Link Mobility 보고서에서 거래를 그룹화하는 데 사용됩니다. |
| 최대 연결된 메시지 | 1 | 1~10 사이의 값으로 허용되는 연결된 메시지 수를 정의합니다. 기본값은 3입니다. |
| 상관관계ID | 100 | 배달 보고서에 반영될 서비스 제공자가 제공한 ID입니다. |
| 사용자 이름 | 100 | HTTP 기본 인증에 대한 대안으로 제공됩니다. |
| 비밀번호 | 100 | HTTP 기본 인증에 대한 대안으로 제공됩니다. |
6.4 HTTP 요청 방법
최대 상호 운용성을 위해 API는 HTTP GET 및 POST 요청 방법을 모두 지원합니다. 다른 HTTP 방법은 허용되지 않습니다.
6.4.1 가져오기
인코딩된 쿼리 문자열이 추가됩니다. URL.
얻다
https://europe.ipx.com/restapi/v1/sms/send?destinationAddress=461234
56789&messageText=안녕하세요+세상%21
권한: 기본 am9objpjaGFuZ2VtZSA=
6.4.2 포스트
인코딩된 쿼리 문자열은 HTTP 요청 메시지 본문에 제출됩니다. Content-Type은 application/x-www-form-입니다.url인코딩.
우편 https://europe.ipx.com/restapi/v1/sms/send
호스트: europe.ipx.com
콘텐츠 유형 : application / x-www-form-url인코딩됨
권한: 기본 am9objpjaGFuZ2VtZSA=
콘텐츠 길이: 57
목적지주소=46123456789&messageText=Hello+World%21
6.5 날짜 및 시간
날짜와 시간을 나타내는 REST API의 매개변수는 항상 UTC 시간대(협정 세계시)입니다. Timestamps는 다음과 같은 정확한 형식의 문자열로 표현됩니다.
2017-04-25T23:20:50Z
이는 UTC 기준으로 20년 50월 23일 25시 2017분 XNUMX초를 나타냅니다.
7. 응답 메시지
요청 메시지를 받고 해석한 후 API는 HTTP 응답 메시지로 응답합니다.
7.1 HTTP 상태 코드
REST API는 처리된 요청에 대해 항상 HTTP 상태 코드 200 OK를 반환합니다. 메시지 본문에는 정확한 결과를 결정하는 데 사용되는 매개변수 responseCode가 포함되어 있습니다.
7.2 메시지 본문
메시지 본문은 요청의 결과를 설명하는 JSON으로 구성됩니다.
http://json.org/
Link Mobility JSON은 Google JSON 스타일 가이드를 준수합니다.
https://google.github.io/styleguide/jsoncstyleguide.xml
7.3 응답 매개변수
| 이름 | 최대 길이 | 설명 |
| 응답코드 | 3 | 0은 성공적인 거래를 나타냅니다. |
| 응답메시지 | 255 | 응답 텍스트 설명(예: 오류 텍스트) |
| 가장 빠른amp | 20 | LINK Mobility가 요청을 처리한 날짜 및 시간입니다. (날짜/시간 형식 섹션 참조). |
| 추적ID | 36 | Link Mobility 내부 식별자. 지원 및 문제 해결에 사용됩니다. |
| 메시지 ID | 10 x 36 | 성공적인 각 메시지에 대한 LINK Mobility 고유 메시지 ID 배열입니다(메시지가 연결된 경우 여러 메시지 ID가 반환됨). 실패시에는 생략됩니다. |
7.4 실amp응답
성공
HTTP/1.1 200 확인
콘텐츠 유형: application/json
콘텐츠 길이: 144
날짜: 목, 15 2016월 13 20:31:XNUMX GMT
{“responseCode”:0,”responseMessage”:”성공”,”timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
가독성을 위해 동일한 JSON을 포맷한 것은 다음과 같습니다.
{
“응답코드“:0,
“응답메시지":"성공",
“가장 빠른amp“:”2016-0915T13:20:31Z”,
“추적ID“:”f678d30879fd4adc25f2”,
“메시지 ID“:[“1-4850879008”] }
실패
HTTP/1.1 200 확인
콘텐츠 유형: application/json
콘텐츠 길이: 148
날짜: 목, 15 2016월 13 20:31:XNUMX GMT
{“responseCode”:1,”responseMessage”:”잘못된 로그인 또는 무단 API 사용”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
성공
HTTP/1.1 200 확인
콘텐츠 유형: application/json
콘텐츠 길이: 144
날짜: 목, 15 2016월 13 20:31:XNUMX GMT
{“responseCode”:0,”responseMessage”:”성공”,”timestamp”:”2016-09-15T13:20:31Z”, “traceId”:”f678d30879fd4adc25f2″,”messageIds”:[“1-4850879008”]}
가독성을 위해 동일한 JSON을 포맷한 것은 다음과 같습니다.
{
“응답코드“:0,
“응답메시지":"성공",
“가장 빠른amp“:”2016-0915T13:20:31Z”,
“추적ID“:”f678d30879fd4adc25f2”,
“메시지 ID“:[“1-4850879008”] }
실패
HTTP/1.1 200 확인
콘텐츠 유형: application/json
콘텐츠 길이: 148
날짜: 목, 15 2016월 13 20:31:XNUMX GMT
{“responseCode”:1,”responseMessage”:”잘못된 로그인 또는 무단 API 사용”,”timestamp”:”2016-09-15T13:20:31Z”,”traceId”:”f678d30879fd4adc25f2″}
7.5 응답 코드
다음 응답 코드는 전송 응답에서 반환될 수 있습니다.
| 암호 | 텍스트 | 설명 |
| 0 | 성공 | 성공적으로 실행되었습니다. |
| 1 | 잘못된 로그인 또는 허가되지 않은 API 사용 | 사용자 이름 또는 비밀번호가 잘못되었거나 서비스 제공자가 LINK Mobility에 의해 차단되었습니다. |
| 2 | 소비자는 Link Mobility에 의해 차단되었습니다. | 소비자가 LINK Mobility에 의해 차단되었습니다. |
| 3 | LINK Mobility에서 작업이 제공되지 않습니다. | 서비스 공급자에 대한 작업이 차단되었습니다. |
| 4 | 소비자는 LINK Mobility에 대해 알지 못합니다. | LINK Mobility에서는 소비자에 대해 잘 모릅니다. 또는 요청에 별칭이 사용된 경우 별칭을 찾을 수 없습니다. |
| 5 | 소비자는 LINK Mobility에서 이 서비스를 차단했습니다. | 소비자는 LINK Mobility에서 이 서비스를 차단했습니다. |
| 6 | 출발지 주소가 지원되지 않습니다. | 발신 주소가 지원되지 않습니다. |
| 7 | 계정에서 알파 발신 주소가 지원되지 않습니다. | 알파 원본 주소는 해당 계정에서 지원되지 않습니다. |
| 8 | MSISDN 발신 주소가 지원되지 않습니다. | MSISDN 발신 주소가 지원되지 않습니다. |
| 9 | GSM 확장 지원되지 않음 | GSM 확장은 지원되지 않습니다. |
| 10 | 유니코드가 지원되지 않습니다 | 유니코드는 지원되지 않습니다. |
| 11 | 상태 보고서가 지원되지 않습니다. | 상태 보고서가 지원되지 않습니다. |
| 12 | 필수 기능이 지원되지 않습니다. | 메시지를 보내는 데 필요한 기능(위의 기능 제외)이 지원되지 않습니다. |
| 13 | 콘텐츠 제공자 최대 제한 속도를 초과했습니다. | 서비스 제공자가 LINK Mobility에 SMS 메시지를 너무 빨리 보내고 있습니다. |
| 14 | 계정에서 프로토콜 ID가 지원되지 않습니다. | 프로토콜 ID가 지원되지 않습니다. |
| 15 | 메시지 연결 제한을 초과했습니다. | 연결된 메시지 수가 요청된 최대 수를 초과했습니다. |
| 16 | 메시지를 라우팅할 수 없습니다. | LINK Mobility가 메시지를 라우팅하지 못했습니다. |
| 17 | 금지된 기간 | 해당 시간대에는 메시지를 보낼 수 없습니다. |
| 18 | 서비스 제공자 계정의 잔액이 너무 낮습니다. | 잔액이 너무 낮아 서비스 제공자가 차단되었습니다. |
| 50 | 부분적인 성공 | 여러 수신자에게 SMS 메시지를 보내는 데 부분적으로 성공했습니다. |
| 99 | 내부 서버 오류 | 기타 Link Mobility 오류가 있는 경우, 자세한 내용은 LINK Mobility 지원팀에 문의하세요. |
| 100 | 잘못된 목적지 주소입니다 | 대상 주소(MSISDN 또는 별칭)가 잘못되었습니다. |
| 102 | 잘못된 참조(링크) ID | 참조 ID가 잘못되었습니다. 참조 ID가 이미 사용 중이거나, 너무 오래되었거나, 알 수 없는 것일 수 있습니다. |
| 103 | 잘못된 계정 이름입니다 | 계정 이름이 잘못되었습니다. |
| 105 | 잘못된 서비스 메타 데이터입니다. | 서비스 메타 데이터가 잘못되었습니다. |
| 106 | 잘못된 출발지 주소입니다 | 출발지 주소가 잘못되었습니다. |
| 107 | 잘못된 영숫자 발신 주소입니다. | 영숫자로 구성된 발신 주소가 잘못되었습니다. |
| 108 | 유효 시간이 잘못되었습니다 | 유효시간이 잘못되었습니다. |
| 109 | 잘못된 배달 시간 | 배달 시간이 잘못되었습니다. |
| 110 | 잘못된 메시지 내용/사용자 데이터입니다. | 사용자 데이터, 즉 SMS 메시지가 잘못되었습니다. |
| 111 | 잘못된 메시지 길이 | SMS 메시지 길이가 잘못되었습니다. |
| 112 | 잘못된 사용자 데이터 헤더 | 사용자 데이터 헤더가 잘못되었습니다. |
| 113 | 잘못된 데이터 코딩 방식 | DCS가 잘못되었습니다. |
| 114 | 잘못된 프로토콜 ID | PID가 잘못되었습니다. |
| 115 | 잘못된 상태 보고서 플래그 | 상태 보고서 플래그가 잘못되었습니다. |
| 116 | 잘못된 TON | 발신자 TON이 잘못되었습니다. |
| 117 | 잘못된 camp이름을 정렬하다 | 씨ampaign 이름이 잘못되었습니다. |
| 120 | 연결된 메시지의 최대 개수에 대한 제한이 잘못되었습니다. | 연결된 메시지의 최대 개수가 올바르지 않습니다. |
| 121 | 잘못된 msisdn 발신 주소 | MSISDN 발신 주소가 잘못되었습니다. |
| 122 | 잘못된 상관관계 ID | 상관관계 ID가 잘못되었습니다. |
8. 옵션 기능
8.1 MSISDN 수정
MSISDN 수정은 요청 시 LINK Mobility 지원팀에서 활성화할 수 있는 선택 기능입니다.
이 기능은 목적지 주소를 수정하고 필요한 E.164 형식에 맞춥니다. 형식 수정 외에도 시스템은 해당되는 경우 국제 프랑스어 숫자를 올바른 DOM-TOM(départements et territoires d'outre-mer) 숫자로 변환하는 것과 같은 시장별 기능을 수행할 수도 있습니다.
아래는 몇 가지 예입니다.amp수정 사항:
| 제출된 목적지 주소 | 수정된 목적지 주소 |
| +46(0)702233445 | 46702233445 |
| (0046)72233445 | 46702233445 |
| +460702233445 | 46702233445 |
| 46(0)702233445 | 46702233445 |
| 46070-2233445 | 46702233445 |
| 0046702233445 | 46702233445 |
| +46(0)702233445aaa | 46702233445 |
| 336005199999 | 2626005199999 (프랑스어 숫자를 DOM-TOM 숫자로 변환) |
또한, 선택한 시장에 대한 국가 전화 번호를 허용할 수 있습니다. 이 기능이 활성화되면 다른 시장의 모든 국제 번호는 선택한 시장과 구별하기 위해 처음에 `+' 기호와 함께 전송해야 합니다.
아래에는 몇 가지 예가 있습니다.amp기본 국가 번호 시장으로 스웨덴(국가 코드 46)을 사용할 경우 수정 사항이 적용됩니다.
| 제출된 목적지 주소 | 수정된 목적지 주소 |
| 0702233445 | 46702233445 |
| 070-2233 445 | 46702233445 |
| 070.2233.4455 | 46702233445 |
| 460702233445 | 46702233445 |
| +460702233445 | 46702233445 |
| +458022334455 | 458022334455 |
| 45802233445 | '+' 기호가 없으므로 유효하지 않습니다. |
수정된 MSISDN은 LINK Mobility에서 사용되며 전달 보고서에서 반환됩니다.
자세한 내용은 LINK Mobility 지원팀에 문의하세요.
8.2 문자 교체
문자 교체는 요청 시 LINK Mobility 지원팀에서 활성화할 수 있는 선택 기능입니다.
이 기능은 DCS가 "GSM"(17)으로 설정된 경우 사용자 데이터(SMS 텍스트)의 비 GSM 알파벳 문자를 동등한 GSM 알파벳 문자로 변환합니다. 예를 들어ample "Seqüencia de teste em Português"는 "Seqüencia de teste em Portugues"로 번역됩니다.
9. 배달 보고서
서비스 제공자는 프로비저닝된 경우 전송된 MT 메시지에 대한 SMS 메시지 전달 보고서 또는 전달 알림을 요청할 수 있습니다. 이러한 보고서는 MT 메시지가 대상 소비자에게 전달되거나 삭제될 때(예: 만료되거나 어떤 이유로 라우팅할 수 없음) 운영자 SMSC에서 트리거됩니다.
SMS 메시지의 최종 상태만 서비스 제공자에게 보고됩니다. 즉, 전달됨 또는 삭제됨. MT 메시지당 하나의 보고서만 생성됩니다. 삭제된 상태의 경우 이유 코드가 적용될 수 있습니다. 이 이유 코드는 SMS 메시지가 전달되지 않은 이유를 지정합니다.
보고서는 LINK Mobility를 통해 라우팅되고 HTTP 프로토콜을 사용하여 서비스 공급자에게 전송됩니다.
보고서를 받으려면 서비스 제공자는 다음을 구현해야 합니다.ampJava Servlet 또는 ASP.NET 페이지. 둘 다 HTTP GET 또는 POST 요청을 수신합니다.
매개변수
요청에는 다음과 같은 매개변수가 포함됩니다.
| 매개변수 | 유형 | M/O/I* | 기본값 | 최대 길이 | 설명 |
| 메시지 ID | 끈 | M | – | 22 | 이 보고서에 해당하는 MT 메시지의 메시지 ID입니다. |
| 목적지주소 | 끈 | M | – | 40 | 소비자의 MSISDN, 즉 원래 MT 메시지의 대상 주소입니다. |
| 상태 코드 | 정수 | M | 1 | 상태 코드는 MT 메시지의 상태를 나타냅니다. 적용 가능한 상태 코드는 다음과 같습니다. 0 – 전달됨 2 – 삭제됨(이유 코드 적용) |
|
| 타임스트amp | 끈 | M | – | 20 | LINK Mobility가 배달 보고서를 수신한 시간을 나타내는 시간입니다. 타임스의 시간대amp CET 또는 CEST(EU의 여름시간 정의에 따름)입니다. 형식: yyyyMMdd HH:mm:ss. |
| 연산자 | 끈 | M | – | 100 | SMS 메시지를 보낼 때 사용된 운영자 이름 또는 SMS 메시지를 보낼 때 사용된 계정 이름입니다. 사용 가능한 사업자 목록은 LINK Mobility 지원팀에서 제공합니다. |
| 이유 코드 | 정수 | O | – | 3 | 사유 코드는 메시지가 삭제됨 상태가 된 이유를 나타냅니다. 적용 가능한 사유 코드는 다음과 같습니다. 100 – 만료됨 101 – 거부됨 102 – 형식 오류 103 – 기타 오류 110 – 구독자 불명 111 – 구독자 차단 112 – 구독자가 프로비저닝되지 않음 113 – 구독자 불가 120 – SMSC 실패 121 – SMSC 혼잡 122 – SMSC 로밍 130 – 핸드셋 오류 131 – 핸드셋 메모리 초과 동작은 운영자 통합에 따라 달라질 수 있습니다. |
| 운영자시간Stamp | 끈 | O | – | 20 | 운영자의 SMSC에서 보고서가 트리거된 시간을 나타내는 시간입니다(운영자가 제공한 경우). 타임스의 시간대amp CET 또는 CEST(EU의 여름시간 정의에 따름)입니다. 형식: yyyyMMdd HH:mm:ss. |
| 상태 텍스트 | 끈 | O | – | 255 | 운영자로부터 추가 정보를 위한 자리 표시자, 예: 상태/이유에 대한 일반 텍스트 설명. 동작은 운영자 통합에 따라 다를 수 있습니다. |
| 상관 관계 ID | 끈 | O | – | 100 | SendRequest 또는 SendTextRequest에 제공된 상관관계 ID입니다. |
| OperatorNetworkCode | 정수 | O | – | 6 | 통신사의 모바일 네트워크 코드(MCC + MNC). |
* M = 필수, O = 선택, I = 무시.
서비스 제공자는 대상에 LINK Mobility를 제공해야 합니다. URL 배달 보고서(선택적으로 HTTP 기본 인증에 대한 자격 증명 포함). 서비스 공급자는 사용할 기본 HTTP 방법을 선택할 수 있습니다.
HTTP POST (권장)
HTTP 요청.
ExampHTTP GET을 사용하여 (성공적으로 전달됨):
https://user:password@www.serviceprovider.com/receivereport?%20MessageId=122&DestinationAddress=46762050312&Operator=Vodafone&TimeStamp=20100401%2007%3A47%3A44&StatusCode=0
ExampHTTP GET을 사용하여 (전달되지 않음, Operator가 timest를 제공함)amp 이벤트를 위해):
매개변수는 다음과 같습니다 URL 인코딩됨
문자 인코딩:
서비스 제공자는 사용할 기본 문자 인코딩을 선택할 수 있습니다.
UTF-8(권장)
ISO-8859-1 표준.
9.1 서비스 제공자 확인
서비스 제공자는 각 배달 보고서를 확인해야 합니다. 확인은 긍정적일 수 있습니다. 즉, 배달 보고서를 성공적으로 수신했거나 부정적일 수 있습니다. 즉, 실패했습니다.
참고: LINK Mobility는 배달 보고서에 대한 확인에 대한 읽기 시간 초과가 30초입니다. 시간 초과는 배달 재시도(재시도가 활성화된 경우) 또는 배달 취소(재시도가 비활성화된 경우)를 트리거합니다. 즉, 서비스 제공자 애플리케이션은 특히 부하가 높은 경우 빠른 응답 시간을 보장해야 합니다.
배송 보고서를 처리하기 전에 LINK Mobility에 배송 보고서를 확인하는 것이 좋습니다.
긍정적 및 부정적 확인에 대한 규칙은 다음과 같이 설명됩니다.
긍정적 확인, ACK, 전달 보고서 전달됨:
다음 XML 형식의 콘텐츠와 결합된 HTTP 200 범위 응답 코드:
부정 확인, NAK, 배달 보고서가 전달되지 않음:
예를 들어 긍정적인 확인 외의 모든 답변ample, 부정 확인은 HTTP 오류 코드나 다음 XML 콘텐츠에 의해 트리거됩니다.
XML 콘텐츠는 LINK Mobility 재시도 메커니즘을 제어하는 데 사용할 수 있습니다. NAK가 활성화된 경우 재시도를 유발합니다. 재시도 메커니즘에 대해 구성되지 않은 서비스 공급자의 경우 XML 콘텐츠는 선택 사항입니다.
아래는 HTTP POST 요청 및 응답입니다.amp서비스 제공자에게 전달된 배달 보고서의 le:
HTTP 요청:
POST /컨텍스트/앱 HTTP/1.1
콘텐츠 유형 : application / x-www-form-url인코딩됨;문자셋=utf-8
호스트: 서버:포트
콘텐츠 길이: xx
MessageId=213123213&DestinationAddress=46762050312&Operator=Telia& OperatorTimeStamp=20130607%2010%3A45%3A00&TimeStamp=20130607%2010%3A 45%3A02&StatusCode=0
HTTP 응답:
HTTP/1.1 200 확인
콘텐츠 유형: text/plain
9.2 재시도
LINK Mobility 시스템은 실패한, 즉 확인되지 않은 배달 보고서 배달에 대해 재시도를 수행할 수 있습니다. 서비스 제공자는 선호하는 재시도 동작을 선택할 수 있습니다.
다시 시도하지 마세요 (기본값) – 연결 시도가 실패하거나 읽기 시간이 초과되거나 HTTP 오류 코드가 발생하면 메시지가 삭제됩니다.
다시 해 보다 – 메시지는 모든 유형의 연결 문제, 읽기 시간 초과 또는 부정 확인에 대해 다시 전송됩니다.
NAK에 대한 재시도가 활성화된 경우 LINK Mobility에서 재시도를 생성하는 시나리오와 재시도가 작동하는 방식을 이해하는 것이 중요합니다. 각 서비스 공급자는 자체 재시도 대기열을 가지고 있으며, 여기서 메시지는 메시지 타임스에 따라 정렬됩니다.amp. Link Mobility는 서비스 공급자에게 전달되는 개별 메시지 순서가 보장되지 않더라도 항상 오래된 메시지를 먼저 전달하려고 합니다. 메시지가 재시도 대기열에서 삭제되는 주된 이유는 두 가지 이유 중 하나입니다. 메시지 TTL이 만료되거나(이론적으로) 재시도 대기열이 가득 찼습니다. TTL은 운영자와 계정에 따라 다릅니다. 즉, 운영자 및 메시지 유형(예: 프리미엄 SMS 또는 표준 요금 SMS 메시지)에 따라 달라질 수 있습니다.
재시도가 활성화된 서비스 공급자는 MT 메시지의 고유 ID를 확인하여 메시지가 이미 수신되지 않았는지 확인해야 합니다.
배달 보고서 처리 중 오류가 발생하는 경우 서비스 제공자는 다음과 같은 간단한 규칙을 준수하는 것이 중요합니다. 오류의 이유가 다음과 같은 경우 일시적(예: 데이터베이스를 사용할 수 없음)이면 NAK를 반환해야 합니다. LINK Mobility는 메시지를 다시 보냅니다.
영구 시도와 재시도는 동일한 종류의 문제를 일으킬 가능성이 높으므로 ACK를 반환해야 합니다. 예를 들어amp메시지를 올바르게 구문 분석할 수 없거나 예기치 않은 런타임 오류가 발생한 경우입니다.
이에 따라 조치하면 배달 보고서가 반복적으로 재전송되어 차단이나 처리량 저하가 발생하지 않도록 할 수 있습니다.
10. 구현 팁
1. 귀하의 사용이 가능합니다 web 브라우저에서 API에 요청을 제출합니다. 이를 통해 개발 도구 없이도 서비스를 탐색하고 평가하기가 매우 쉽습니다.
2. JSON 등의 확장 프로그램과 함께 Chrome이나 Firefox를 사용하는 것이 좋습니다.View 보기 좋게 포맷된 JSON을 표시합니다.
3. 우리는 SoapUI를 사용하여 POST와 기본 인증을 테스트하고 원시 HTTP 요청과 응답 메시지를 검사했습니다.
4. 씨URL 도구는 기본 인증을 사용하여 POST 요청을 제출하는 데 유용합니다. 예를 참조하십시오.amp아래에 있습니다.
curl 우편 \
-H “콘텐츠 유형: application/x-www-form-url인코딩됨” \
-H “권한: 기본 am9objpjaGFuZ2VtZSA=" \
https://europe.ipx.com/restapi/v1/sms/send \
–데이터 “목적지주소=46123456789&메시지텍스트=Hello+World%21”
_______________
개인화된 커뮤니케이션을 혁신하다
문서 / 리소스
 |
LINK 모빌리티 구현 가이드 REST API SMS [PDF 파일] 사용자 가이드 모빌리티 구현 가이드 REST API SMS, 모빌리티, 구현 가이드 REST API SMS, REST API SMS, API SMS, SMS |
