API SMS, API SMPP API MS Scheduler
Guide de l'utilisateur
API SMS, API SMPP API MS Scheduler
| Modifié: | 6/24/2025 |
| Version: | 1.7 |
| Auteur: | Kenny Colander Norden, KCN |
Ce document est destiné au destinataire désigné uniquement et peut contenir des informations privilégiées, exclusives ou autrement privées. Si vous l'avez reçu par erreur, veuillez en informer immédiatement l'expéditeur et supprimer l'original. Toute autre utilisation du document par vous est interdite.
Historique des changements
| Tour | Date | By | Changements par rapport à la version précédente |
| 1.0 | 2010-03-16 | KCN | Créé |
| 1. | 2019-06-11 | TPE | Logos LINK mis à jour |
| 1. | 2019-09-27 | PNI | Ajout d'une référence à la spécification SMPP 3.4 |
| 1. | 2019-10-31 | EP | Remarque sur la période de validité tag |
| 1. | 2020-08-28 | KCN | Ajout d'informations concernant les versions TLS prises en charge |
| 2. | 2022-01-10 | KCN | Ajout d'informations supplémentaires concernant les rapports de livraison Informations mises à jour concernant TLS 1.3 |
| 2. | 2025-06-03 | GM | Code de résultat ajouté 2108 |
| 2. | 2025-06-24 | AK | Quota ajouté |
Introduction
LINK Mobility est un distributeur de SMS depuis 2001 et a une grande expérience de travail avec les opérateurs et les agrégateurs de connexion. Cette plate-forme est conçue pour gérer de gros volumes de trafic, maintenir une haute disponibilité et faciliter l'acheminement du trafic via plusieurs connexions.
Ce document décrit l'interface SMPP de la plate-forme SMSC et les paramètres et commandes requis et ceux pris en charge.
Ce document ne traitera pas de cas d'utilisation spécifiques tels que les messages concaténés, WAPpush, Flash SMS, etc. Plus d'informations sur ces cas peuvent être fournies en contactant le support.
Commandes prises en charge
Le serveur de LINK Mobility doit être traité comme SMPP 3.4. La spécification officielle peut être trouvée à https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Toutes les méthodes ne sont pas prises en charge et toutes les différences sont spécifiées ci-dessous.
4.1 Lier
Les commandes de liaison suivantes sont prises en charge.
- Émetteur
- émetteur-récepteur
- Récepteur
Paramètres requis :
- system_id – obtenu auprès du support
- mot de passe – obtenu auprès du support
Paramètres facultatifs:
- addr_ton – valeur par défaut si TON est défini sur Inconnu lors de la soumission.
- addr_npi - valeur par défaut si NPI est défini sur Inconnu lors de la soumission.
Paramètres non pris en charge :
- plage_adresses
4.2 Délier
La commande unbind est prise en charge.
4.3 Lien de demande
La commande inquire link est prise en charge et doit être appelée toutes les 60 secondes.
4.4 Soumettre
La méthode submit doit être utilisée pour la livraison des messages.
Paramètres requis :
- source_addr_ton
- source_addr_npi
- adresse_source
- destination_addr_ton
- destination_addr_npi
- adresse_dest
- classe_esm
- codage_données
- sm_longueur
- message court
Paramètres non pris en charge :
- type de service
- protocole_id
- drapeau_priorité
- planning_delivery_time
- remplacer_if_present_flag
- sm_default_msg_id
Note que la charge utile tag n'est pas pris en charge et un seul SMS peut être délivré par appel et il est recommandé que la validité_period tag a une valeur de 15 minutes au moins.
4.4.1 TON et NPI recommandés
Les TON et NPI suivants doivent être utilisés lors de l'envoi de messages à l'aide de la commande submit.
4.4.1.1 Source
Les combinaisons TON et NPI suivantes sont prises en charge pour l'adresse source. Toutes les autres combinaisons seront considérées comme non valides. La commande TON par défaut de la liaison sera utilisée si TON est défini sur Inconnu (0). La commande NPI par défaut de la liaison sera utilisée si NPI est défini sur Inconnu (0).
| TONNE | INP | Description |
| Alphanumérique (5) | Inconnu (0) RNIS (1) |
Sera traité comme un texte d'expéditeur alphanumérique |
| International (1) | Inconnu (0) RNIS (1) |
Sera traité comme MSISDN |
| National (2) Spécifique au réseau (3) Numéro d'abonné (4) Abrégé (6) |
Inconnu (0) RNIS (1) National (8) |
Sera traité comme un numéro court spécifique au pays. |
4.4.1.2 Destination
Les combinaisons TON et NPI suivantes sont prises en charge pour l'adresse de destination. Toutes les autres combinaisons seront traitées comme invalides. Le TON par défaut de la commande bind sera utilisé si TON est défini sur Inconnu (0). Le NPI par défaut de la commande bind sera utilisé si NPI est défini sur Inconnu (0).
| TONNE | INP | Description |
| International (1) | Inconnu (0) RNIS (1) |
Sera traité comme MSISDN |
4.4.2 Encodages pris en charge
Les encodages suivants sont pris en charge. X peut contenir n'importe quelle valeur.
| DCS | Codage |
| 0xX0 | Alphabet GSM par défaut avec extension |
| 0xX2 | binaire 8 bits |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Quota
5.1 Quota dépasséview
Un quota définit le nombre maximal de SMS pouvant être envoyés dans un intervalle de temps donné (par jour, par semaine, par mois ou indéfiniment). Chaque quota est identifié de manière unique par un quotaId (UUID) et est réinitialisé en fonction du fuseau horaire du client. Les quotas peuvent être attribués par pays, par région ou par défaut via Quota Pro.fileLes quotas peuvent également être attribués dynamiquement grâce au mappage de quotas. Ce mappage associe un identifiant de quota parent (UUID) et une clé de quota unique (par exemple, expéditeur ou utilisateur) à un identifiant de quota spécifique.
Un quota est défini en fonction de votre support local, de votre gestionnaire de compte attitré ou par défaut si rien n'est spécifié.
5.2 Statut 106 – Quota dépassé
Un message SMS peut être bloqué avec le code d'état 106 (« quota dépassé ») lorsque :
- Le message dépasse la limite définie pour son quotaId correspondant dans l'intervalle actuel.
- Le pays ou la région de destination n'a pas de quota attribué (c'est-à-dire qu'il est explicitement bloqué avec un mappage de quota nul dans le programme).file).
- Il n'y a pas de quota correspondant et aucun quota par défaut n'est défini, ce qui entraîne un rejet.
Dans ces cas, le système empêche le traitement ultérieur des messages afin de renforcer les limites basées sur le client ou la destination et d'éviter toute utilisation abusive.
Rapport de livraison
Seules les livraisons nulles ou finales avec un résultat réussi/échec sont prises en charge.
Format sur le rapport de livraison : id : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx fait date : aaMMjjHHmm stat :
Valeurs disponibles dans status :
- LIVRÉ
- EXPIRÉ
- REJETÉ
- NON LIVRÉ
- SUPPRIMÉ
6.1 Format du rapport de livraison étendu
Des informations détaillées dans les rapports de livraison peuvent être demandées en contact avec votre représentant commercial.
Format du rapport de livraison : id : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub : 000 dlvrd : 000 date de soumission :
aaMMjjHHmm date de fin : aaMMjjHHmm stat : se tromper: texte:
Valeurs disponibles dans status :
- LIVRÉ
- EXPIRÉ
- REJETÉ
- NON LIVRÉ
- SUPPRIMÉ
Les champs "sub" et "dlvrd" seront toujours définis sur 000, et le champ "text" sera toujours vide.
Voir le chapitre Codes d'erreur pour les valeurs du champ « err ».
Versions TLS prises en charge
TLS 1.2 ou TLS 1.3 est requis pour toutes les connexions TLS via SMPP.
La prise en charge de TLS 1.0 et 1.1 est interrompue depuis le 2020/11/15. Les versions 1.0 et 1.1 de TLS sont des protocoles plus anciens qui ont été dépréciés et sont considérés comme des risques de sécurité dans la communauté Internet.
LINK recommande fortement d'utiliser TLS si des connexions SMPP non chiffrées sont utilisées aujourd'hui. Les connexions SMPP non chiffrées sont obsolètes depuis le 2020/09/01 par LINK et seront supprimées à l'avenir. La date de suppression des connexions non chiffrées n'est pas encore décidée.
Les connexions vers le serveur SMPP pour TLS se font sur le port 3601 au lieu de non chiffrées sur le port 3600.
Vous pouvez toujours utiliser TLS même si votre implémentation SMPP ne prend pas en charge TLS à l'aide de stunnel, voir https://www.stunnel.org/
Codes d'erreur
Les codes d'erreur suivants peuvent être répondus dans le champ err si le champ est activé.
| Code d'erreur | Description |
| 0 | Erreur inconnue |
| 1 | Erreur de routage temporaire |
| 2 | Erreur de routage permanente |
| 3 | Limitation maximale dépassée |
| 4 | Temps mort |
| 5 | Erreur d'opérateur inconnu |
| 6 | Erreur de l'opérateur |
| 100 | Service non trouvé |
| 101 | Utilisateur non trouvé |
| 102 | Compte non trouvé |
| 103 | Mot de passe incorrect |
| 104 | Erreur de configuration |
| 105 | Erreur interne |
| 106 | Quota dépassé |
| 200 | OK |
| 1000 | Envoyé |
| 1001 | Livré |
| 1002 | Expiré |
| 1003 | Supprimé |
| 1004 | Mobile complet |
| 1005 | En file d'attente |
| 1006 | Non livré |
| 1007 | Livré, charge retardée |
| 1008 | Facturé, message non envoyé |
| 1009 | Facturé, message non délivré |
| 1010 | Périmé, absence de rapport de livraison opérateur |
| 1011 | Facturé, message envoyé (à l'opérateur) |
| 1012 | Mise en file d'attente à distance |
| 1013 | Message envoyé à l'opérateur, charge retardée |
| 2000 | Numéro de source invalide |
| 2001 | Le numéro court n'est pas pris en charge comme source |
| 2002 | Alpha n'est pas pris en charge en tant que source |
| 2003 | MSISDN n'est pas pris en charge comme numéro source |
| 2100 | Le numéro court n'est pas pris en charge comme destination |
| 2101 | Alpha n'est pas pris en charge comme destination |
| 2102 | MSISDN n'est pas pris en charge comme destination |
| 2103 | Opération bloquée |
| 2104 | Abonné inconnu |
| 2105 | Destination bloquée |
| 2106 | Erreur de numéro |
| 2107 | Destination temporairement bloquée |
| 2108 | Destination invalide |
| 2200 | Erreur de chargement |
| 2201 | L'abonné a un solde faible |
|
2202 |
Abonné exclu pour surfacturation (premium)
messages |
|
2203 |
L'abonné est trop jeune (pour ce service particulier)
contenu) |
| 2204 | Abonné prépayé non autorisé |
| 2205 | Service refusé par l'abonné |
| 2206 | Abonné non enregistré dans le système de paiement |
| 2207 | L'abonné a atteint le solde maximum |
| 2208 | Confirmation de l'utilisateur final requise |
| 2300 | Remboursé |
|
2301 |
Impossible de rembourser en raison d'un article illégal ou manquant
MSISDN |
| 2302 | Impossible de rembourser en raison d'un identifiant de message manquant |
| 2303 | En attente de remboursement |
| 2304 | Délai de remboursement |
| 2305 | Échec du remboursement |
| 3000 | L'encodage GSM n'est pas pris en charge |
| 3001 | L'encodage UCS2 n'est pas pris en charge |
| 3002 | L'encodage binaire n'est pas pris en charge |
| 4000 | Le rapport de livraison n'est pas pris en charge |
| 4001 | Contenu du message invalide |
| 4002 | Tarif invalide |
| 4003 | Données utilisateur invalides |
| 4004 | En-tête de données utilisateur invalide |
| 4005 | Codage des données invalide |
| 4006 | TVA invalide |
| 4007 | Contenu non pris en charge pour la destination |
Documents / Ressources
 |
API SMS de mobilité de lien, API SMPP API MS Scheduler [pdf] Guide de l'utilisateur API SMS API SMPP API MS Scheduler, API SMS API SMPP, API MS Scheduler, API Scheduler, API |