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 | 热塑性弹性体 | 更新了 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 分销商，在与运营商和连接聚合商合作方面拥有丰富的经验。 该平台旨在处理大量流量，保持高可用性并使其易于通过多个连接路由流量。
本文档描述了 SMPP 接口与 SMSC 平台之间的联系，以及需要哪些参数和命令以及支持哪些参数。
本文档不会处理特定用例，如串联消息、WAPpush、Flash SMS 等。您可以通过联系支持人员获取有关这些用例的更多信息。
支持的命令
LINK Mobility 的服务器应视为 SMPP 3.4。 官方规范可以在以下位置找到 https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
不支持所有方法，所有差异在下面说明。
4.1 绑定
支持以下绑定命令。
- 发射机
- 收发器
- 接收者
必需参数：
- system_id——从支持获得
- 密码 - 从支持获得
可选参数：
- addr_ton – 如果 TON 在提交期间设置为未知，则为默认值。
- addr_npi – 如果 NPI 在提交期间设置为未知，则为默认值。
不支持的参数：
- 地址范围
4.2 解绑
支持解除绑定命令。
4.3 查询链接
支持 inquire 链接命令，应每 60 秒调用一次。
4.4 提交
提交方法应该用于传递消息。
必需参数：
- 源地址顿
- 源地址_npi
- 源地址
- 目标地址顿
- 目标地址_npi
- 目标地址
- esm_类
- 数据编码
- sm_长度
- 短消息
不支持的参数：
- 服务类型
- 协议编号
- 优先级标志
- 计划交货时间
- 如果存在则替换标志
- sm_default_msg_id
笔记 有效载荷 tag 不支持，每次通话只能发送一条 SMS，建议将 validity_period tag 至少有 15 分钟的值。
4.4.1 推荐的 TON 和 NPI
使用提交命令发送消息时，应使用以下 TON 和 NPI。
4.4.1.1 来源
源地址支持以下 TON 和 NPI 组合。所有其他组合均视为无效。如果 TON 设置为未知 (0)，则将使用绑定命令中的默认 TON。如果 NPI 设置为未知 (0)，则将使用绑定命令中的默认 NPI。
| 吨 | 新产品导入 | 描述 |
| 字母数字 (5) | 未知 (0) 综合业务数字网 (1) |
将被视为字母数字发件人文本 |
| 国际 (1) | 未知 (0) 综合业务数字网 (1) |
将被视为 MSISDN |
| 全国 (2) 网络特定 (3) 用户号码 (4) 缩写（6） |
未知 (0) 综合业务数字网 (1) 全国 (8) |
将被视为国家特定的短号码。 |
4.4.1.2 目的地
目标地址支持以下 TON 和 NPI 组合。 所有其他组合将被视为无效。 如果 TON 设置为未知 (0)，则将使用绑定命令的默认 TON。 如果 NPI 设置为未知 (0)，则将使用绑定命令的默认 NPI。
| 吨 | 新产品导入 | 描述 |
| 国际 (1) | 未知 (0) 综合业务数字网 (1) |
将被视为 MSISDN |
4.4.2 支持的编码
支持以下编码。 X 可以包含任何值。
| 分布式控制系统 | 编码 |
| 0xX0 | 带扩展名的默认 GSM 字母表 |
| 0xX2 | 8 位二进制 |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
配额
5.1 配额超出view
配额定义了在指定时间间隔（例如每天、每周、每月或无限期）内可以发送的短信数量上限。每个配额由一个配额 ID (UUID) 唯一标识，并根据客户的时区进行重置。配额可以通过 Quota Pro 按国家/地区、地区或默认级别分配。file配额也可以使用配额映射 (Quota Mapping) 动态分配。这会将父配额 ID (UUID) 和唯一配额 Key（例如，发送者或用户）映射到特定的配额 ID。
配额是根据您的当地支持、您指定的客户经理设置的，如果未指定，则默认设置。
5.2 状态 106 – 超出配额
在以下情况下，短信可能会被阻止，状态代码为 106（“超出配额”）：
- 该消息超出了当前间隔内其相应quotaId的定义限制。
- 目的地国家或地区未分配配额（即，在 pro 中用空配额映射明确阻止）file).
- 没有匹配的配额，并且没有定义默认配额，导致被拒绝。
在这些情况下，系统会阻止进一步的消息处理，以强制执行基于客户或目的地的限制并避免滥用。
送货报告
仅支持无或最终交付成功/失败结果。
交货报告格式： id：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 完成日期：yyMMddHHmm 统计：
状态中的可用值：
- 交付
- 已到期
- 被拒
- 未交付
- 已删除
6.1 扩展发送报告格式
联系您的销售代表可能会要求提供交货报告中的更多信息。
交付报告格式：id：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxsub：000 dlvrd：000提交日期：
yyMMddHHmm 完成日期： yyMMddHHmm 状态：犯错：文本：
状态中的可用值：
- 交付
- 已到期
- 被拒
- 未交付
- 已删除
“sub”和“dlvrd”字段将始终设置为 000，而“text”字段将始终为空。
有关“err”字段的值，请参阅错误代码一章。
支持的 TLS 版本
通过 SMPP 的所有 TLS 连接都需要 TLS 1.2 或 TLS 1.3。
自 1.0 年 1.1 月 2020 日起停止支持 TLS 11 和 15。 TLS 的 1.0 和 1.1 版本是已弃用的旧协议，在 Internet 社区中被视为安全风险。
如果今天使用未加密的 SMPP 连接，LINK 强烈建议使用 TLS。 LINK 自 2020 年 09 月 01 日起弃用未加密的 SMPP 连接，并将在未来删除。 未加密连接删除的日期尚未确定。
与 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 | 不支持将 Alpha 作为来源 |
| 2003 | 不支持 MSISDN 作为源号码 |
| 2100 | 不支持短号码作为目的地 |
| 2101 | 不支持将 Alpha 作为目的地 |
| 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 | 增值税无效 |
| 4007 | 目标内容不受支持 |
文件/资源
 |
链路移动性 SMS API、SMPP API MS Scheduler API [pdf] 用户指南 SMS API SMPP API MS 调度程序 API、SMS API SMPP API、MS 调度程序 API、调度程序 API、API |