API SMS, API SMPP API MS Scheduler
Instrukcja użytkownika
API SMS, API SMPP API MS Scheduler
| Zmodyfikowano: | 6/24/2025 |
| Wersja: | 1.7 |
| Autor: | Kenny Colander Norden, KCN |
Niniejszy dokument jest przeznaczony wyłącznie dla wyznaczonego odbiorcy i może zawierać informacje uprzywilejowane, zastrzeżone lub w inny sposób prywatne. Jeżeli otrzymałeś go przez pomyłkę, prosimy o natychmiastowe powiadomienie nadawcy i usunięcie oryginału. Jakiekolwiek inne wykorzystanie dokumentu przez Ciebie jest zabronione.
Historia zmian
| Obrót silnika | Data | By | Zmiany w stosunku do poprzedniej wersji |
| 1.0 | 2010-03-16 | KCN | Stworzony |
| 1. | 2019-06-11 | TPE | Zaktualizowane logo LINK |
| 1. | 2019-09-27 | PNI | Dodano odniesienie do specyfikacji SMPP 3.4 |
| 1. | 2019-10-31 | EP | Uwaga dotycząca okresu ważności tag |
| 1. | 2020-08-28 | KCN | Dodano informacje dotyczące obsługiwanych wersji TLS |
| 2. | 2022-01-10 | KCN | Dodano dodatkowe informacje dotyczące raportów o dostawach Zaktualizowane informacje dotyczące protokołu TLS 1.3 |
| 2. | 2025-06-03 | GM | Dodano kod wyniku 2108 |
| 2. | 2025-06-24 | AK | Dodano kwotę |
Wstęp
LINK Mobility jest dystrybutorem SMS-ów od 2001 roku i ma duże doświadczenie we współpracy zarówno z operatorami, jak i agregatorami połączeń. Platforma ta została zaprojektowana tak, aby obsługiwać duże natężenie ruchu, utrzymywać wysoką dostępność i ułatwiać kierowanie ruchu przez wiele połączeń.
W tym dokumencie opisano interfejs SMPP do platformy SMSC oraz wymagane i obsługiwane parametry i polecenia.
W tym dokumencie nie omówimy konkretnych przypadków użycia, takich jak wiadomości łączone, WAPpush, Flash SMS itp. Więcej informacji na temat tych przypadków można uzyskać, kontaktując się z pomocą techniczną.
Obsługiwane polecenia
Serwer LINK Mobility należy traktować jako SMPP 3.4. Oficjalną specyfikację można znaleźć pod adresem https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Wszystkie metody nie są obsługiwane, a wszystkie różnice opisano poniżej.
4.1 Związanie
Obsługiwane są następujące polecenia wiązania.
- Nadajnik
- transciever
- Odbiornik
Wymagane parametry:
- system_id – uzyskany od wsparcia
- hasło – otrzymane od supportu
Parametry opcjonalne:
- adres_ton – wartość domyślna, jeśli podczas przesyłania TON jest ustawiony na Nieznany.
- adres_npi – wartość domyślna, jeśli podczas przesyłania NPI jest ustawione na Nieznany.
Nieobsługiwane parametry:
- zakres_adresów
4.2 Rozwiąż
Obsługiwane jest polecenie unbind.
4.3 Link do zapytania
Polecenie inquire link jest obsługiwane i powinno być wywoływane co 60 sekund.
4.4 Prześlij
Do dostarczania wiadomości należy używać metody przesyłania.
Wymagane parametry:
- adres_źródłowy
- adres_źródłowy_npi
- adres_źródłowy
- adres_docelowy
- dest_addr_npi
- adres_docelowy
- klasa_esm
- kodowanie_danych
- sm_długość
- krótka wiadomość
Nieobsługiwane parametry:
- Rodzaj usługi
- identyfikator_protokołu
- flaga_priorytetu
- harmonogram_dostawy_czas
- zamień_jeśli_obecna_flaga
- sm_default_msg_id
Notatka że ładunek tag nie jest obsługiwana i w ramach jednego połączenia może zostać dostarczona tylko jedna wiadomość SMS. Zaleca się, aby parametr valid_period tag ma wartość co najmniej 15 minut.
4.4.1 Zalecane TON i NPI
Podczas wysyłania wiadomości za pomocą polecenia przesyłania należy używać następujących TON i NPI.
4.4.1.1 Źródło
Poniższe kombinacje TON i NPI są obsługiwane dla adresu źródłowego. Wszystkie inne kombinacje będą traktowane jako nieprawidłowe. Domyślny TON z polecenia bind zostanie użyty, jeśli TON jest ustawiony na Nieznany (0). Domyślny NPI z polecenia bind zostanie użyty, jeśli NPI jest ustawiony na Nieznany (0).
| TONA | NPI | Opis |
| Alfanumeryczne (5) | Nieznany (0) ISDN (1) |
Będzie traktowany jako alfanumeryczny tekst nadawcy |
| Międzynarodowy (1) | Nieznany (0) ISDN (1) |
Będzie traktowany jako MSISDN |
| Narodowy (2) Specyficzny dla sieci (3) Numer abonenta (4) Skrócona wersja (6) |
Nieznany (0) ISDN (1) Narodowy (8) |
Będzie traktowany jako krótki numer specyficzny dla kraju. |
4.4.1.2 Miejsce docelowe
Dla adresu docelowego obsługiwane są następujące kombinacje TON i NPI. Wszystkie inne kombinacje będą traktowane jako nieprawidłowe. Domyślny TON z polecenia bind zostanie użyty, jeśli TON jest ustawiony na Nieznany (0). Domyślny NPI z polecenia bind zostanie użyty, jeśli NPI jest ustawione na Nieznany (0).
| TONA | NPI | Opis |
| Międzynarodowy (1) | Nieznany (0) ISDN (1) |
Będzie traktowany jako MSISDN |
4.4.2 Obsługiwane kodowania
Obsługiwane są następujące kodowania. X może zawierać dowolną wartość.
| DCS | Kodowanie |
| 0xX0 | Domyślny alfabet GSM z rozszerzeniem |
| 0xX2 | 8-bitowy binarny |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kontyngent
5.1 Przekroczenie kwotyview
Limit określa maksymalną liczbę wiadomości SMS, które można wysłać w określonym przedziale czasowym (np. w ciągu dnia, tygodnia, miesiąca lub w nieskończoność). Każdy limit jest jednoznacznie identyfikowany za pomocą identyfikatora limitu (UUID) i jest resetowany zgodnie ze strefą czasową klienta. Limity można przypisać na poziomie kraju, regionu lub domyślnym za pośrednictwem Quota Pro.fileKwotę można również dynamicznie przypisać za pomocą mapowania kwot. Mapuje to nadrzędny identyfikator kwoty (UUID) i unikalny klucz kwoty (np. nadawcę lub użytkownika) na konkretny identyfikator kwoty.
Limit jest ustalany zgodnie z lokalnym wsparciem, przydzielonym menedżerem konta lub domyślnie, jeśli nic nie zostało określone.
5.2 Status 106 – Przekroczono limit
Wiadomość SMS może zostać zablokowana z kodem statusu 106 („przekroczono limit”), gdy:
- Wiadomość przekracza zdefiniowany limit dla odpowiadającego jej quotaId w bieżącym interwale.
- Kraj lub region docelowy nie ma przypisanego żadnego limitu (tj. jest wyraźnie zablokowany z zerowym mapowaniem limitu w programie).file).
- Nie ma pasującego limitu i nie zdefiniowano limitu domyślnego, co skutkuje odrzuceniem.
W takich przypadkach system blokuje dalsze przetwarzanie wiadomości, aby wyegzekwować limity na podstawie klienta lub miejsca docelowego i zapobiec niewłaściwemu wykorzystaniu.
Raport dostawy
Obsługiwana jest tylko żadna dostawa lub ostateczna dostawa z wynikiem pomyślnym/nieudanym.
Format protokołu dostawy: identyfikator: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx data wykonania: rrMMddHHmm stan:
Dostępne wartości w statusie:
- DOSTARCZONY
- WYGASŁY
- ODRZUCONO
- NIEDOSTĘPNY
- USUNIĘTO
6.1 Rozszerzony format raportu dostawy
Dodatkowe informacje w raportach dostaw można uzyskać po skontaktowaniu się z przedstawicielem handlowym.
Format raportu dostawy: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 data wysłania:
yyMMddHHmm data wykonania: yyMMddHHmm statystyka: błądzić: tekst:
Dostępne wartości w statusie:
- DOSTARCZONY
- WYGASŁY
- ODRZUCONO
- NIEDOSTĘPNY
- USUNIĘTO
Pola „sub” i „dlvrd” będą zawsze ustawione na 000, a pole „text” będzie zawsze puste.
Patrz rozdział Kody błędów, aby zapoznać się z wartościami pola „err”.
Obsługiwane wersje TLS
Dla wszystkich połączeń TLS przez SMPP wymagany jest protokół TLS 1.2 lub TLS 1.3.
Obsługa protokołów TLS 1.0 i 1.1 została wycofana od 2020 r. Wersje 11 i 15 protokołu TLS to starsze protokoły, które zostały uznane za przestarzałe i uważane za zagrożenie bezpieczeństwa w społeczności internetowej.
LINK zdecydowanie zaleca używanie TLS, jeśli obecnie używane są nieszyfrowane połączenia SMPP. Nieszyfrowane połączenia SMPP są przestarzałe od 2020-09-01 przez firmę LINK i zostaną usunięte w przyszłości. Data usunięcia połączeń nieszyfrowanych nie jest jeszcze ustalona.
Połączenia z serwerem SMPP dla protokołu TLS odbywają się na porcie 3601, a nie na porcie nieszyfrowanym na porcie 3600.
Możesz nadal używać TLS, nawet jeśli twoja implementacja SMPP nie obsługuje TLS przy użyciu stunnel, zobacz https://www.stunnel.org/
Kody błędów
W polu błędu mogą pojawić się następujące kody błędów, jeśli pole jest włączone.
| Kod błędu | Opis |
| 0 | Nieznany błąd |
| 1 | Tymczasowy błąd routingu |
| 2 | Stały błąd routingu |
| 3 | Przekroczono maksymalne ograniczenie |
| 4 | Przekroczenie limitu czasu |
| 5 | Nieznany błąd operatora |
| 6 | Błąd operatora |
| 100 | Nie znaleziono usługi |
| 101 | Użytkownik nie został znaleziony |
| 102 | Konto nie znalezione |
| 103 | Nieprawidłowe hasło |
| 104 | Błąd konfiguracji |
| 105 | Błąd wewnętrzny |
| 106 | Przekroczono limit |
| 200 | OK |
| 1000 | Wysłano |
| 1001 | Dostarczony |
| 1002 | Wygasły |
| 1003 | Usunięto |
| 1004 | Komórka pełna |
| 1005 | W kolejce |
| 1006 | Nie dostarczono |
| 1007 | Dostarczono, opłata opóźniona |
| 1008 | Naładowano, wiadomość nie została wysłana |
| 1009 | Naładowano, wiadomość nie została dostarczona |
| 1010 | Wygasł, brak raportu doręczenia operatora |
| 1011 | Naładowano, wiadomość wysłana (do operatora) |
| 1012 | Zdalnie w kolejce |
| 1013 | Wiadomość wysłana do operatora, ładowanie opóźnione |
| 2000 | Nieprawidłowy numer źródłowy |
| 2001 | Krótki numer nie jest obsługiwany jako źródło |
| 2002 | Wersja alfa nie jest obsługiwana jako źródło |
| 2003 | MSISDN nie jest obsługiwany jako numer źródłowy |
| 2100 | Krótki numer nie jest obsługiwany jako miejsce docelowe |
| 2101 | Wersja alfa nie jest obsługiwana jako miejsce docelowe |
| 2102 | MSISDN nie jest obsługiwany jako miejsce docelowe |
| 2103 | Operacja zablokowana |
| 2104 | Nieznany abonent |
| 2105 | Miejsce docelowe zablokowane |
| 2106 | Błąd numeru |
| 2107 | Miejsce docelowe tymczasowo zablokowane |
| 2108 | Nieprawidłowy cel podróży |
| 2200 | Błąd ładowania |
| 2201 | Abonent ma niskie saldo |
|
2202 |
Abonent zablokowany za przepłacenie (premium)
wiadomości |
|
2203 |
Abonent jest za młody (w tym konkretnym przypadku)
zadowolony) |
| 2204 | Subskrybent przedpłacony nie jest dozwolony |
| 2205 | Usługa odrzucona przez abonenta |
| 2206 | Abonent niezarejestrowany w systemie płatności |
| 2207 | Abonent osiągnął maksymalne saldo |
| 2208 | Wymagane potwierdzenie użytkownika końcowego |
| 2300 | Zwrócono |
|
2301 |
Nie można dokonać zwrotu z powodu braku lub niezgodności z prawem
MSISDN |
| 2302 | Nie można dokonać zwrotu pieniędzy z powodu braku identyfikatora wiadomości |
| 2303 | W kolejce po zwrot pieniędzy |
| 2304 | Limit czasu zwrotu |
| 2305 | Niepowodzenie zwrotu pieniędzy |
| 3000 | Kodowanie GSM nie jest obsługiwane |
| 3001 | Kodowanie UCS2 nie jest obsługiwane |
| 3002 | Kodowanie binarne nie jest obsługiwane |
| 4000 | Raport doręczenia nie jest obsługiwany |
| 4001 | Nieprawidłowa treść wiadomości |
| 4002 | Nieprawidłowa taryfa |
| 4003 | Nieprawidłowe dane użytkownika |
| 4004 | Nieprawidłowy nagłówek danych użytkownika |
| 4005 | Nieprawidłowe kodowanie danych |
| 4006 | Nieprawidłowy podatek VAT |
| 4007 | Nieobsługiwana treść dla miejsca docelowego |
Dokumenty / Zasoby
 |
mobilność łącza API SMS, SMPP API MS Scheduler API [plik PDF] Instrukcja użytkownika API SMS SMPP API MS Harmonogram API, SMS API SMPP API, MS Harmonogram API, Harmonogram API, API |