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 ディストリビューターであり、通信事業者と接続アグリゲーターの両方と協力してきた経験が豊富です。 このプラットフォームは、大量のトラフィックを処理し、高可用性を維持し、複数の接続を介してトラフィックを簡単にルーティングできるように設計されています。
このドキュメントでは、SMSC プラットフォームへの SMPP インターフェイスと、必要なパラメータとコマンド、およびサポートされているパラメータについて説明します。
このドキュメントでは、連結メッセージ、WAPpush、Flash SMS などの特定のユースケースについては扱いません。これらのケースに関する詳細情報は、サポートにお問い合わせください。
サポートされているコマンド
LINK Mobility のサーバーは、SMPP 3.4 として扱う必要があります。 公式の仕様は次の場所にあります。 https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
すべての方法がサポートされているわけではありません。すべての違いを以下に示します。
4.1 バインド
次の bind コマンドがサポートされています。
- 送信機
- トランシーバー
- 受信機
必須パラメータ:
- system_id – サポートから取得
- パスワード – サポートから取得
オプションのパラメータ：
- addr_ton – 送信時に TON が Unknown に設定されている場合のデフォルト値。
- addr_npi – 送信時に NPI が Unknown に設定されている場合のデフォルト値。
サポートされていないパラメータ:
- アドレス範囲
4.2バインドを解除する
unbind コマンドがサポートされています。
4.3 お問い合わせリンク
inquire link コマンドがサポートされており、60 秒ごとに呼び出す必要があります。
4.4 提出する
メッセージの配信には submit メソッドを使用する必要があります。
必須パラメータ:
- ソースアドレストン
- ソースアドレス_npi
- ソースアドレス
- dest_addr_ton
- dest_addr_npi
- 宛先アドレス
- esm_class
- データコーディング
- sm_length
- ショートメッセージ
サポートされていないパラメータ:
- サービスの種類
- プロトコルID
- 優先フラグ
- スケジュール_配達_時間
- replace_if_present_flag
- sm_default_msg_id
注記 そのペイロード tag はサポートされておらず、通話ごとに XNUMX つの SMS のみが配信される可能性があります。 tag 少なくとも 15 分の長さの値があります。
4.4.1 推奨される TON と NPI
submit コマンドを使用してメッセージを送信する場合は、次の TON および NPI を使用する必要があります。
4.4.1.1 ソース
送信元アドレスには、以下のTONとNPIの組み合わせがサポートされています。それ以外の組み合わせは無効として扱われます。TONが不明(0)に設定されている場合は、bindコマンドのデフォルトのTONが使用されます。NPIが不明(0)に設定されている場合は、bindコマンドのデフォルトのNPIが使用されます。
| トン | インド | 説明 |
| 英数字 (5) | 不明 (0) ISDN (1) |
英数字の送信者テキストとして扱われます |
| インターナショナル (1) | 不明 (0) ISDN (1) |
MSISDN として扱われます |
| 全国（2） ネットワーク固有 (3) 加入者番号 (4) 略語（6） |
不明 (0) ISDN (1) 全国（8） |
国固有の短縮番号として扱われます。 |
4.4.1.2 宛先
次の TON と NPI の組み合わせが宛先アドレスとしてサポートされています。 他のすべての組み合わせは無効として扱われます。 TON が不明 (0) に設定されている場合、bind コマンドからのデフォルトの TON が使用されます。 NPI が不明 (0) に設定されている場合、bind コマンドからのデフォルトの NPI が使用されます。
| トン | インド | 説明 |
| インターナショナル (1) | 不明 (0) ISDN (1) |
MSISDN として扱われます |
4.4.2 サポートされているエンコーディング
次のエンコーディングがサポートされています。 X には任意の値を含めることができます。
| DCS | エンコーディング |
| 0xX0 | 拡張子付きのデフォルトの GSM アルファベット |
| 0xX2 | 8ビットバイナリ |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
クォータ
5.1 割り当て超過view
クォータは、指定された期間（日、週、月、または無期限など）に送信できるSMSメッセージの最大数を定義します。各クォータはクォータID（UUID）によって一意に識別され、顧客のタイムゾーンに応じてリセットされます。クォータは、Quota Proを通じて国、地域、またはデフォルトレベルで割り当てることができます。fileクォータマッピングを使用して、クォータを動的に割り当てることもできます。これは、親クォータID（UUID）と一意のクォータキー（送信者またはユーザーなど）を特定のクォータIDにマッピングします。
クォータは、ローカル サポート、担当アカウント マネージャーに従って設定されますが、何も指定されていない場合はデフォルトで設定されます。
5.2 ステータス 106 – クォータ超過
次の場合、SMS メッセージはステータス コード 106 (「クォータ超過」) でブロックされることがあります。
- メッセージは、現在の間隔内で対応する quotaId に定義された制限を超えています。
- 宛先の国または地域に割り当て済みのクォータがありません（つまり、プロファイラでnullのクォータマッピングによって明示的にブロックされています）。file).
- 一致するクォータがなく、デフォルトのクォータが定義されていないため、拒否されます。
このような場合、システムは顧客または送信先に基づく制限を強制し、誤用を避けるために、それ以上のメッセージ処理を防止します。
送達通知
なしまたは成功/失敗の結果を伴う最終配信のみがサポートされています。
配信レポートの形式: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 完了日: yyMMddHHmm 統計:
ステータスで使用可能な値:
- 配達
- 期限切れ
- 拒否
- 配達不能
- 削除済み
6.1 拡張配信レポートの形式
配送レポートの詳細情報については、営業担当者にお問い合わせください。
配信レポートのフォーマット: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 送信日:
yyMMddHHmm 完了日: yyMMddHHmm 統計:エラー:文章：
ステータスで使用可能な値:
- 配達
- 期限切れ
- 拒否
- 配達不能
- 削除済み
「sub」および「dlvrd」フィールドは常に 000 に設定され、「text」フィールドは常に空になります。
「err」フィールドの値については、「エラー コード」の章を参照してください。
サポートされている TLS バージョン
SMPP を介したすべての TLS 接続には、TLS 1.2 または TLS 1.3 が必要です。
TLS 1.0 および 1.1 のサポートは、2020-11-15 以降廃止されました。 TLS のバージョン 1.0 および 1.1 は、廃止され、インターネット コミュニティでセキュリティ リスクと見なされている古いプロトコルです。
現在、暗号化されていない SMPP 接続が使用されている場合、LINK は TLS を使用することを強くお勧めします。 暗号化されていない SMPP 接続は、LINK によって 2020 年 09 月 01 日に廃止され、将来的に削除される予定です。 暗号化されていない接続の削除の日付はまだ決定されていません。
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 | アルファはソースとしてサポートされていません |
| 2003 | MSISDN は送信元番号としてサポートされていません |
| 2100 | 短縮番号は宛先としてサポートされていません |
| 2101 | アルファは宛先としてサポートされていません |
| 2102 | MSISDN は宛先としてサポートされていません |
| 2103 | 操作がブロックされました |
| 2104 | 不明な加入者 |
| 2105 | 宛先がブロックされました |
| 2106 | 番号エラー |
| 2107 | 宛先が一時的にブロックされている |
| 2108 | 無効な宛先 |
| 2200 | 充電エラー |
| 2201 | サブスクライバーの残高が少ない |
|
2202 |
過剰請求（プレミアム）による加入禁止
メッセージ |
|
2203 |
加入者が若すぎる（この特定の
内容） |
| 2204 | 前払い加入者は許可されていません |
| 2205 | 加入者によって拒否されたサービス |
| 2206 | 加入者が支払いシステムに登録されていません |
| 2207 | サブスクライバーが最大残高に達しました |
| 2208 | エンドユーザーの確認が必要 |
| 2300 | 返金 |
|
2301 |
違法または紛失のため払い戻しできません
MSISDN |
| 2302 | messageId がないため、払い戻しできませんでした |
| 2303 | 払い戻し待ち |
| 2304 | 払い戻しのタイムアウト |
| 2305 | 払い戻しの失敗 |
| 3000 | GSM エンコーディングはサポートされていません |
| 3001 | UCS2 エンコーディングはサポートされていません |
| 3002 | バイナリ エンコーディングはサポートされていません |
| 4000 | 配信レポートはサポートされていません |
| 4001 | メッセージの内容が無効です |
| 4002 | 関税が無効です |
| 4003 | ユーザーデータが無効です |
| 4004 | ユーザー データ ヘッダーが無効です |
| 4005 | 無効なデータ コーディング |
| 4006 | 無効な付加価値税 |
| 4007 | 宛先でサポートされていないコンテンツ |
ドキュメント / リソース
 |
リンク モビリティ SMS API、SMPP API MS スケジューラ API [pdf] ユーザーガイド SMS API SMPP API MS スケジューラ API、SMS API SMPP API、MS スケジューラ API、スケジューラ API、API |