API SMS, API SMPP API MS Scheduler
Guia d'usuari
API SMS, API SMPP API MS Scheduler
| Modificat: | 6/24/2025 |
| Versió: | 1.7 |
| Autor: | Kenny Colander Norden, KCN |
Aquest document és només per al destinatari designat i pot contenir informació privilegiada, de propietat o d'una altra manera privada. Si l'heu rebut per error, aviseu immediatament al remitent i elimineu l'original. Qualsevol altre ús del document per part teva està prohibit.
Historial de canvis
| Rev | Data | By | Canvis respecte a la versió anterior |
| 1.0 | 2010-03-16 | KCN | Creat |
| 1. | 2019-06-11 | TPE | Logotips d'LINK actualitzats |
| 1. | 2019-09-27 | PNI | S'ha afegit una referència a l'especificació SMPP 3.4 |
| 1. | 2019-10-31 | EP | Observació sobre el període de vigència tag |
| 1. | 2020-08-28 | KCN | S'ha afegit informació sobre les versions de TLS compatibles |
| 2. | 2022-01-10 | KCN | S'ha afegit informació addicional sobre els informes de lliurament Informació actualitzada sobre TLS 1.3 |
| 2. | 2025-06-03 | GM | Codi de resultat afegit 2108 |
| 2. | 2025-06-24 | AK | Quota afegida |
Introducció
LINK Mobility és distribuïdor de SMS des de l'any 2001 i té molta experiència treballant tant amb operadors com amb agregadors de connexió. Aquesta plataforma està dissenyada per gestionar grans volums de trànsit, mantenir una alta disponibilitat i facilitar l'encaminament del trànsit a través de múltiples connexions.
Aquest document descriu la interfície SMPP amb la plataforma SMSC, els paràmetres i les ordres necessàries i els paràmetres compatibles.
Aquest document no tractarà casos d'ús específics com ara missatges concatenats, WAPpush, Flash SMS, etc. Podeu obtenir més informació sobre aquests casos contactant amb el servei d'assistència.
Ordres admeses
El servidor de LINK Mobility s'ha de tractar com SMPP 3.4. Les especificacions oficials es poden trobar a https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
No s'admeten tots els mètodes i totes les diferències s'especifiquen a continuació.
4.1 Lligar
S'admeten les ordres d'enllaç següents.
- Emissor
- Transceptor
- Receptor
Paràmetres necessaris:
- system_id: obtingut del suport
- contrasenya: obtinguda del suport
Paràmetres opcionals:
- addr_ton: valor per defecte si TON s'estableix en Desconegut durant l'enviament.
- addr_npi: valor per defecte si NPI s'estableix en Desconegut durant l'enviament.
Paràmetres no compatibles:
- rang_adreces
4.2 Desvincular
L'ordre unbind és compatible.
4.3 Enllaç de consulta
L'ordre inquire link és compatible i s'ha de cridar cada 60 segons.
4.4 Enviament
El mètode d'enviament s'ha d'utilitzar per enviar missatges.
Paràmetres necessaris:
- adreça_font_ton
- adreça_font_npi
- adreça_font
- dest_addr_ton
- dest_addr_npi
- dest_addr
- classe_esm
- codificació de dades
- sm_length
- missatge_breu
Paràmetres no compatibles:
- tipus_servei
- protocol_id
- bandera_prioritat
- calendari_hora_de_entrega
- substituir_si_present_bandera
- sm_default_msg_id
Nota que la càrrega útil tag no és compatible i només es pot lliurar un SMS per trucada i es recomana que validity_period tag té un valor de 15 minuts com a mínim.
4.4.1 TON i NPI recomanats
Els següents TON i NPI s'han d'utilitzar quan s'envien missatges mitjançant l'ordre d'enviament.
4.4.1.1 Font
Les combinacions TON i NPI següents són compatibles per a l'adreça d'origen. Totes les altres combinacions es tractaran com a no vàlides. S'utilitzarà el TON per defecte de l'ordre bind si TON està definit com a Desconegut (0). S'utilitzarà el NPI per defecte de l'ordre bind si NPI està definit com a Desconegut (0).
| TON | NPI | Descripció |
| Alfanumèric (5) | Desconegut (0) RDSI (1) |
Es tractarà com a text del remitent alfanumèric |
| Internacional (1) | Desconegut (0) RDSI (1) |
Es tractarà com MSISDN |
| Nacional (2) Específic de la xarxa (3) Número de subscriptor (4) Abreujat (6) |
Desconegut (0) RDSI (1) Nacional (8) |
Es tractarà com un número curt específic del país. |
4.4.1.2 Destinació
Les següents combinacions TON i NPI són compatibles per a l'adreça de destinació. Totes les altres combinacions seran tractades com a no vàlides. S'utilitzarà l'ordre predeterminada TON de l'enllaç si TON s'estableix a Desconegut (0). L'NPI predeterminat de l'ordre d'enllaç s'utilitzarà si NPI s'estableix a Desconegut (0).
| TON | NPI | Descripció |
| Internacional (1) | Desconegut (0) RDSI (1) |
Es tractarà com MSISDN |
4.4.2 Codificacions admeses
S'admeten les codificacions següents. X pot contenir qualsevol valor.
| DCS | Codificació |
| 0xX0 | Alfabet GSM per defecte amb extensió |
| 0xX2 | binari de 8 bits |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Quota
5.1 Quota superadaview
Una quota defineix el nombre màxim de missatges SMS que es poden enviar dins d'un interval de temps especificat (com ara per dia, setmana, mes o indefinidament). Cada quota s'identifica de manera única amb un quotaId (UUID) i es restableix segons la zona horària del client. Les quotes es poden assignar a nivell de país, regió o per defecte mitjançant un Quota Pro.fileLes quotes també es poden assignar dinàmicament mitjançant el mapatge de quotes. Això assigna un identificador de quota principal (UUID) i una clau de quota única (per exemple, remitent o usuari) a un identificador de quota específic.
Una quota s'estableix d'acord amb el vostre suport local, el vostre gestor de comptes assignat o per defecte si no s'especifica res.
5.2 Estat 106 – Quota superada
Un missatge SMS es pot bloquejar amb el codi d'estat 106 ("quota superada") quan:
- El missatge supera el límit definit per al seu quotaId corresponent dins de l'interval actual.
- El país o la regió de destinació no té cap quota assignada (és a dir, està bloquejat explícitament amb una assignació de quota nul·la al profile).
- No hi ha cap quota coincident i no s'ha definit cap quota per defecte, cosa que provoca el rebuig.
En aquests casos, el sistema impedeix que es processin més missatges per fer complir els límits basats en el client o la destinació i evitar-ne un mal ús.
Informe de lliurament
Només s'admet cap lliurament o l'entrega final amb un resultat correcte/fallit.
Format de l'informe de lliurament: identificador: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx data de realització: aaMMddHHmm estat:
Valors disponibles en estat:
- DELIVRD
- CADUCAT
- REBUTAT
- UNDELIV
- ELIMINAT
6.1 Format d'informe de lliurament estès
Es pot demanar informació ampliada als informes de lliurament en contacte amb el seu representant de vendes.
Format de l'informe de lliurament: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 data d'enviament:
aaMMddHHmm data de finalització: aaMMddHHmm estadística: err: text:
Valors disponibles en estat:
- DELIVRD
- CADUCAT
- REBUTAT
- UNDELIV
- ELIMINAT
Els camps "sub" i "dlvrd" sempre s'establiran en 000 i el camp "text" sempre estarà buit.
Vegeu el capítol Codis d'error per als valors del camp "err".
Versions TLS compatibles
Es requereix TLS 1.2 o TLS 1.3 per a totes les connexions TLS mitjançant SMPP.
El suport per a TLS 1.0 i 1.1 s'ha desactivat des del 2020-11-15. Les versions 1.0 i 1.1 de TLS són protocols antics que han quedat obsolets i es consideren riscos de seguretat a la comunitat d'Internet.
LINK recomana fer servir TLS si s'utilitzen connexions SMPP no xifrades avui dia. Les connexions SMPP no xifrades estan obsoletes a partir del 2020-09-01 per LINK i s'eliminaran en el futur. La data per a l'eliminació de connexions no xifrades encara no està decidida.
Les connexions cap al servidor SMPP per a TLS es troben al port 3601 en lloc de no xifrar al port 3600.
Encara podeu utilitzar TLS encara que la vostra implementació SMPP no admet TLS amb stunnel, vegeu https://www.stunnel.org/
Codis d'error
Els codis d'error següents es poden respondre al camp d'error si el camp està habilitat.
| Codi d'error | Descripció |
| 0 | Error desconegut |
| 1 | Error d'encaminament temporal |
| 2 | Error d'encaminament permanent |
| 3 | S'ha superat l'acceleració màxima |
| 4 | Temps mort |
| 5 | Error desconegut de l'operador |
| 6 | Error de l'operador |
| 100 | Servei no trobat |
| 101 | No s'ha trobat l'usuari |
| 102 | No s'ha trobat el compte |
| 103 | Contrasenya invàlida |
| 104 | Error de configuració |
| 105 | Error intern |
| 106 | Quota superada |
| 200 | OK |
| 1000 | Enviat |
| 1001 | Lliurat |
| 1002 | Caducat |
| 1003 | S'ha suprimit |
| 1004 | Mòbil ple |
| 1005 | En cua |
| 1006 | No lliurat |
| 1007 | Lliurat, càrrec retardat |
| 1008 | Carregat, missatge no enviat |
| 1009 | Cobrat, missatge no lliurat |
| 1010 | Caducat, absència d'informe de lliurament de l'operador |
| 1011 | Cobrat, missatge enviat (a l'operador) |
| 1012 | En cua remota |
| 1013 | Missatge enviat a l'operador, la càrrega s'ha retardat |
| 2000 | El número d'origen no és vàlid |
| 2001 | El número curt no s'admet com a font |
| 2002 | Alpha no és compatible com a font |
| 2003 | MSISDN no s'admet com a número d'origen |
| 2100 | El número curt no s'admet com a destinació |
| 2101 | Alpha no és compatible com a destinació |
| 2102 | MSISDN no és compatible com a destinació |
| 2103 | Operació bloquejada |
| 2104 | Subscriptor desconegut |
| 2105 | Destinació bloquejada |
| 2106 | Error de nombre |
| 2107 | Destinació bloquejada temporalment |
| 2108 | Destinació no vàlida |
| 2200 | Error de càrrega |
| 2201 | El subscriptor té un saldo baix |
|
2202 |
Subscriptor prohibit per sobrecàrrec (premium)
missatges |
|
2203 |
Subscriptor massa jove (per a aquest en particular)
contingut) |
| 2204 | No es permet l'abonat de prepagament |
| 2205 | Servei rebutjat per l'abonat |
| 2206 | Subscriptor no registrat al sistema de pagament |
| 2207 | El subscriptor ha assolit el saldo màxim |
| 2208 | Necessita confirmació de l'usuari final |
| 2300 | Reemborsat |
|
2301 |
No s'ha pogut reemborsar a causa de material il·legal o faltant
MSISDN |
| 2302 | No s'ha pogut reemborsar perquè falta l'identificador de missatge |
| 2303 | A la cua per a la devolució |
| 2304 | Temps d'espera de reemborsament |
| 2305 | Error de devolució |
| 3000 | La codificació GSM no és compatible |
| 3001 | La codificació UCS2 no és compatible |
| 3002 | La codificació binària no és compatible |
| 4000 | L'informe de lliurament no és compatible |
| 4001 | Contingut del missatge no vàlid |
| 4002 | Tarifa no vàlida |
| 4003 | Dades d'usuari no vàlides |
| 4004 | Capçalera de dades d'usuari no vàlida |
| 4005 | Codificació de dades no vàlida |
| 4006 | IVA no vàlid |
| 4007 | Contingut no compatible per a la destinació |
Documents/Recursos
 |
API SMS de mobilitat d'enllaços, API SMPP MS Scheduler API [pdfGuia de l'usuari SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, Scheduler API, API |