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 查詢連結
支援查詢連結命令，並且應每 60 秒調用一次。
4.4 提交
應該使用submit方法來傳遞訊息。
所需參數：
- 來源位址頓
- 來源位址npi
- 來源位址
- 目標地址頓
- 目標位址_npi
- 目標地址
- esm_類
- 資料編碼
- sm_長度
- 短訊息
不支援的參數：
- 服務類型
- 協定ID
- 優先標誌
- 計劃交貨時間
- 如果存在則替換標誌
- sm_default_msg_id
筆記 有效負載 tag 不支持，每次通話只能發送一條短信，建議validation_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：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 完成日期：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 版本是較舊的協議，已被棄用，並被網路社群視為安全風險。
如果目前使用未加密的 SMPP 連接，LINK 強烈建議使用 TLS。自 2020 年 09 月 01 日起，LINK 已棄用未加密的 SMPP 連接，並將在將來刪除。未加密連線刪除的日期尚未確定。
與 SMPP 伺服器的 TLS 連線位於連接埠 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 |