API SMS, API SMPP API Penjadual MS
Panduan Pengguna
API SMS, API SMPP API Penjadual MS
| Diubah suai: | 6/24/2025 |
| Versi: | 1.7 |
| Pengarang: | Kenny Colander Norden, KCN |
Dokumen ini adalah untuk penerima yang ditetapkan sahaja dan mungkin mengandungi maklumat istimewa, proprietari atau sebaliknya peribadi. Jika anda tersilap menerimanya, sila maklumkan kepada pengirim dengan segera dan padamkan yang asal. Sebarang penggunaan lain dokumen oleh anda adalah dilarang.
Sejarah perubahan
| Rev | tarikh | By | Perubahan daripada keluaran sebelumnya |
| 1.0 | 2010-03-16 | KCN | Dicipta |
| 1. | 2019-06-11 | TPE | Logo LINK dikemas kini |
| 1. | 2019-09-27 | PNI | Rujukan tambahan kepada spesifikasi SMPP 3.4 |
| 1. | 2019-10-31 | EP | Pemerhatian tentang tempoh sah tag |
| 1. | 2020-08-28 | KCN | Menambah maklumat mengenai versi TLS yang disokong |
| 2. | 2022-01-10 | KCN | Menambah maklumat tambahan mengenai laporan penghantaran Maklumat terkini mengenai TLS 1.3 |
| 2. | 2025-06-03 | GM | Kod hasil tambah 2108 |
| 2. | 2025-06-24 | AK | Kuota ditambah |
pengenalan
LINK Mobility telah menjadi pengedar SMS sejak tahun 2001 dan mempunyai banyak pengalaman dalam bekerja dengan kedua-dua operator dan agregator sambungan. Platform ini direka bentuk untuk mengendalikan jumlah trafik yang besar, mengekalkan ketersediaan yang tinggi dan memudahkan laluan trafik melalui berbilang sambungan.
Ini adalah dokumen yang menerangkan antara muka SMPP ke platform SMSC dan parameter serta arahan yang diperlukan dan parameter mana yang disokong.
Dokumen ini tidak akan mengendalikan kes penggunaan tertentu sebagai mesej bercantum, WAPpush, SMS Flash, dsb. Maklumat lanjut tentang kes tersebut boleh diberikan dengan menghubungi sokongan.
Perintah yang disokong
Pelayan LINK Mobility harus dianggap sebagai SMPP 3.4. Spesifikasi rasmi boleh didapati di https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Semua kaedah tidak disokong, dan semua perbezaan dinyatakan di bawah.
4.1 Ikat
Perintah bind berikut disokong.
- Pemancar
- Pemancar
- Penerima
Parameter yang diperlukan:
- system_id – diperoleh daripada sokongan
- kata laluan – diperoleh daripada sokongan
Parameter pilihan:
- addr_ton – nilai lalai jika TON ditetapkan kepada Tidak diketahui semasa penyerahan.
- addr_npi – nilai lalai jika NPI ditetapkan kepada Tidak diketahui semasa penyerahan.
Parameter tidak disokong:
- julat_alamat
4.2 Buka Ikatan
Perintah unbind disokong.
4.3 Pautan pertanyaan
Perintah pautan pertanyaan disokong dan harus dipanggil setiap 60 saat.
4.4 Serahkan
Kaedah serah hendaklah digunakan untuk menyampaikan mesej.
Parameter yang diperlukan:
- source_addr_ton
- source_addr_npi
- source_addr
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- pengekodan_data
- sm_length
- mesej ringkas
Parameter tidak disokong:
- jenis_perkhidmatan
- protokol_id
- keutamaan_bendera
- jadual_masa_penghantaran
- gantikan_jika_bendera_hadir
- sm_default_msg_id
Nota bahawa muatan tag tidak disokong dan hanya satu SMS boleh dihantar setiap panggilan dan disyorkan bahawa tempoh_kesahan tag mempunyai nilai selama 15 minit sekurang-kurangnya.
4.4.1 TON dan NPI yang disyorkan
TON dan NPI berikut harus digunakan semasa menghantar mesej menggunakan arahan hantar.
4.4.1.1 Sumber
Gabungan TON dan NPI berikut disokong untuk alamat sumber. Semua kombinasi lain akan dianggap sebagai tidak sah. TON lalai daripada arahan bind akan digunakan jika TON ditetapkan kepada Tidak Diketahui (0). NPI lalai daripada arahan bind akan digunakan jika NPI ditetapkan kepada Tidak Diketahui (0).
| TON | NPI | Penerangan |
| Abjad angka (5) | Tidak diketahui (0) ISDN (1) |
Akan dianggap sebagai teks penghantar Alphanumeric |
| Antarabangsa (1) | Tidak diketahui (0) ISDN (1) |
Akan dilayan sebagai MSISDN |
| Kebangsaan (2) Khusus rangkaian (3) Nombor pelanggan (4) Disingkat (6) |
Tidak diketahui (0) ISDN (1) Kebangsaan (8) |
Akan dianggap sebagai nombor pendek khusus negara. |
4.4.1.2 Destinasi
Gabungan TON dan NPI berikut disokong untuk alamat destinasi. Semua kombinasi lain akan dianggap sebagai tidak sah. TON lalai daripada arahan bind akan digunakan jika TON ditetapkan kepada Tidak Diketahui (0). NPI lalai daripada arahan bind akan digunakan jika NPI ditetapkan kepada Tidak Diketahui (0).
| TON | NPI | Penerangan |
| Antarabangsa (1) | Tidak diketahui (0) ISDN (1) |
Akan dilayan sebagai MSISDN |
4.4.2 Pengekodan yang disokong
Pengekodan berikut disokong. X mungkin mengandungi sebarang nilai.
| DCS | Pengekodan |
| 0xX0 | Abjad GSM lalai dengan sambungan |
| 0xX2 | Perduaan 8-bit |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
Kuota
5.1 Kuota Habisview
Kuota mentakrifkan bilangan maksimum mesej SMS yang boleh dihantar dalam selang masa tertentu (seperti setiap hari, minggu, bulan atau selama-lamanya). Setiap kuota dikenal pasti secara unik oleh kuotaId (UUID) dan ditetapkan semula mengikut zon waktu pelanggan. Kuota boleh ditetapkan pada peringkat negara, wilayah atau lalai melalui Quota Profile. Kuota juga boleh ditetapkan secara dinamik menggunakan Pemetaan Kuota. Ini memetakan KuotaId induk (UUID) dan Kunci kuota unik (cth, pengirim atau pengguna) kepada kuotaId tertentu.
Kuota ditetapkan mengikut sokongan tempatan anda, pengurus akaun yang anda berikan atau secara lalai jika tiada apa yang dinyatakan.
5.2 Status 106 – Melebihi Kuota
Mesej SMS mungkin disekat dengan kod status 106 (“melebihi kuota”) apabila:
- Mesej melebihi had yang ditetapkan untuk kuotaId yang sepadan dalam selang semasa.
- Negara atau wilayah destinasi tidak mempunyai kuota yang ditetapkan (iaitu, disekat secara eksplisit dengan pemetaan kuota nol dalam profile).
- Tiada kuota yang sepadan dan tiada kuota lalai ditentukan, mengakibatkan penolakan.
Dalam kes ini, sistem menghalang pemprosesan mesej selanjutnya untuk menguatkuasakan had berasaskan pelanggan atau destinasi dan mengelakkan penyalahgunaan.
Laporan penghantaran
Hanya tiada atau penghantaran akhir dengan keputusan berjaya/gagal disokong.
Format laporan penghantaran: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx tarikh selesai: yyMMddHHmm stat:
Nilai yang tersedia dalam status:
- DELIVRD
- TAMAT TEMPOH
- DITOLAK
- UNDELIV
- DIHAPUSKAN
6.1 Format laporan penghantaran lanjutan
Maklumat lanjutan dalam laporan penghantaran mungkin diminta dengan menghubungi wakil jualan anda.
Format laporan penghantaran: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 tarikh hantar:
yyMMddHHmm tarikh selesai: yyMMddHHmm statistik: err: teks:
Nilai yang tersedia dalam status:
- DELIVRD
- TAMAT TEMPOH
- DITOLAK
- UNDELIV
- DIHAPUSKAN
Medan "sub" dan "dlvrd" akan sentiasa ditetapkan kepada 000 dan medan "teks" akan sentiasa kosong.
Lihat bab Kod ralat untuk nilai untuk medan "err".
Versi TLS yang disokong
TLS 1.2 atau TLS 1.3 diperlukan untuk semua sambungan TLS melalui SMPP.
Sokongan untuk TLS 1.0 dan 1.1 dihentikan sejak 2020-11-15. Versi 1.0 dan 1.1 TLS ialah protokol lama yang telah ditamatkan dan dianggap sebagai risiko keselamatan dalam komuniti Internet.
LINK amat mengesyorkan untuk menggunakan TLS jika sambungan SMPP yang tidak disulitkan sedang digunakan hari ini. Sambungan SMPP yang tidak disulitkan ditamatkan pada 2020-09-01 oleh LINK dan akan dialih keluar pada masa hadapan. Tarikh untuk penyingkiran sambungan tidak disulitkan belum diputuskan.
Sambungan ke pelayan SMPP untuk TLS adalah pada port 3601 dan bukannya tidak disulitkan pada port 3600.
Anda masih boleh menggunakan TLS walaupun pelaksanaan SMPP anda tidak menyokong TLS menggunakan stunnel, lihat https://www.stunnel.org/
Kod ralat
Kod ralat berikut mungkin dibalas dalam medan ralat jika medan itu didayakan.
| Kod ralat | Penerangan |
| 0 | Ralat tidak diketahui |
| 1 | Ralat penghalaan sementara |
| 2 | Ralat penghalaan kekal |
| 3 | Pendikitan maksimum melebihi |
| 4 | tamat masa |
| 5 | Ralat tidak diketahui operator |
| 6 | Ralat operator |
| 100 | Perkhidmatan tidak ditemui |
| 101 | Pengguna tidak ditemui |
| 102 | akaun tidak dijumpai |
| 103 | Kata laluan tidak sah |
| 104 | Ralat konfigurasi |
| 105 | Ralat dalaman |
| 106 | Kuota melebihi |
| 200 | OK |
| 1000 | Dihantar |
| 1001 | Dihantar |
| 1002 | Tamat tempoh |
| 1003 | Dipadamkan |
| 1004 | Mudah alih penuh |
| 1005 | Beratur |
| 1006 | Tidak dihantar |
| 1007 | Dihantar, caj tertunda |
| 1008 | Dicaj, mesej tidak dihantar |
| 1009 | Dicaj, mesej tidak dihantar |
| 1010 | Tamat tempoh, ketiadaan laporan penghantaran operator |
| 1011 | Dicaj, mesej dihantar (kepada operator) |
| 1012 | Beratur dari jauh |
| 1013 | Mesej dihantar kepada operator, pengecasan ditangguhkan |
| 2000 | Nombor sumber tidak sah |
| 2001 | Nombor pendek tidak disokong sebagai sumber |
| 2002 | Alpha tidak disokong sebagai sumber |
| 2003 | MSISDN tidak disokong sebagai nombor sumber |
| 2100 | Nombor pendek tidak disokong sebagai destinasi |
| 2101 | Alpha tidak disokong sebagai destinasi |
| 2102 | MSISDN tidak disokong sebagai destinasi |
| 2103 | Operasi disekat |
| 2104 | Pelanggan tidak dikenali |
| 2105 | Destinasi disekat |
| 2106 | Ralat nombor |
| 2107 | Destinasi disekat buat sementara waktu |
| 2108 | Destinasi tidak sah |
| 2200 | Ralat pengecasan |
| 2201 | Pelanggan mempunyai baki yang rendah |
|
2202 |
Pelanggan disekat kerana caj berlebihan (premium)
mesej |
|
2203 |
Pelanggan terlalu muda (untuk khusus ini
kandungan) |
| 2204 | Pelanggan prabayar tidak dibenarkan |
| 2205 | Perkhidmatan ditolak oleh pelanggan |
| 2206 | Pelanggan tidak berdaftar dalam sistem pembayaran |
| 2207 | Pelanggan telah mencapai baki maksimum |
| 2208 | Pengesahan pengguna akhir diperlukan |
| 2300 | Dipulangkan |
|
2301 |
Tidak dapat membayar balik kerana tidak sah atau hilang
MSISDN |
| 2302 | Tidak dapat membayar balik kerana tiada messageId |
| 2303 | Beratur untuk bayaran balik |
| 2304 | Tamat masa bayaran balik |
| 2305 | Kegagalan bayaran balik |
| 3000 | Pengekodan GSM tidak disokong |
| 3001 | Pengekodan UCS2 tidak disokong |
| 3002 | Pengekodan binari tidak disokong |
| 4000 | Laporan penghantaran tidak disokong |
| 4001 | Kandungan mesej tidak sah |
| 4002 | Tarif tidak sah |
| 4003 | Data pengguna tidak sah |
| 4004 | Pengepala data pengguna tidak sah |
| 4005 | Pengekodan data tidak sah |
| 4006 | VAT tidak sah |
| 4007 | Kandungan tidak disokong untuk destinasi |
Dokumen / Sumber
 |
API SMS mobiliti pautan, API Penjadual MSPP API [pdf] Panduan Pengguna API SMS API SMPP API Penjadual MS, API SMS SMPP API, API Penjadual MS, API Penjadual, API |