Analisis teks pesan persis seperti yang akan dikirim
Hitung pengodean, panjang setelah pengodean, dan jumlah segmen SMS untuk teks yang ingin Anda kirim. Endpoint ini tidak mengirim SMS, mencadangkan rute, atau mengembalikan penawaran harga pengiriman. Sertakan teks final secara lengkap, termasuk catatan kaki, tautan, atau kalimat untuk berhenti berlangganan yang ditambahkan oleh alur kerja pengiriman Anda.
Permintaan
Lakukan autentikasi menggunakan akun API Anda yang telah diaktifkan dan alamat IP sumber yang diizinkan untuk akun tersebut. Simpan kredensial dalam penyimpanan rahasia di sisi server. Kirim string UTF-8 dalam kolom text; contoh ini menggunakan variabel lingkungan.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--data-urlencode 'text=Your message here' \
https://api.multitel.net/v3/smslengthMasukan yang dikodekan sebagai formulir didukung. Objek JSON seperti {"text":"Your message here"} juga diterima jika tidak ada kolom formulir atau kueri yang disertakan. Utamakan POST agar teks pesan tidak muncul dalam URL. Jika masukan formulir dan kueri sama-sama tersedia, masukan formulir yang digunakan. Jangan mencampur format permintaan.
Respons
{
"status": {
"code": "200",
"msg": ""
},
"response": {
"charset": 0,
"encoding": "GSM-7",
"count": 1,
"parts": 1,
"chars": 17,
"units": 17,
"single_limit": 160,
"multipart_limit": 153
}
}| Kolom | Arti |
|---|---|
| charset | 0 untuk GSM-7 atau 2 untuk UTF-16. |
| encoding | GSM-7 atau UTF-16. |
| parts, count | Dua nama untuk jumlah segmen SMS yang dihitung. Keduanya bernilai nol untuk teks kosong. |
| units, chars | Dua nama untuk jumlah unit hasil pengodean. Jumlahnya belum tentu sama dengan jumlah karakter yang terlihat. |
| single_limit | Batas jumlah unit hasil pengodean untuk satu segmen dengan pengodean yang dipilih. |
| multipart_limit | Batas jumlah unit hasil pengodean yang digunakan untuk setiap segmen setelah memperhitungkan ruang tambahan untuk penggabungan. |
Pengodean dan batas segmen
| Pengodean | Segmen tunggal | Segmen dalam pesan multibagian |
|---|---|---|
| GSM-7 | 160 septet | 153 septet |
| UTF-16 | 70 unit kode | 67 unit kode |
Karakter ekstensi GSM-7 seperti ^, kurung kurawal, kurung siku, garis miring terbalik, garis vertikal, tilde, dan simbol euro menggunakan dua septet. Karakter di luar GSM-7 mengalihkan penghitungan seluruh pesan ke UTF-16. Emoji di luar bidang multibahasa dasar menggunakan dua unit UTF-16; rangkaian emoji yang terlihat dapat memuat beberapa titik kode.
Sebagai contoh, 160 huruf GSM-7 biasa muat dalam satu segmen dan 161 memerlukan dua segmen. Delapan puluh karakter ^ menggunakan 160 unit dan muat dalam satu segmen; delapan puluh satu menggunakan 162 unit dan memerlukan dua segmen. Tiga puluh lima emoji sederhana di luar BMP menggunakan 70 unit UTF-16 dan muat dalam satu segmen; tiga puluh enam menggunakan 72 unit dan memerlukan dua segmen. Tanda penggabung dan emoji yang digabungkan dapat mengubah jumlah tersebut.
Kesalahan dan teks kosong
Kolom text yang tidak disertakan, larik/objek sebagai pengganti nilai skalar, atau UTF-8 yang tidak valid menghasilkan kode API 403. Baca nilai JSON status.code dan status.msg serta status HTTP; endpoint ini mengembalikan kode sebagai string. String kosong valid dan menghasilkan nol unit serta nol segmen.
Gunakan hasilnya sebelum mengirim
Kalkulator yang ditinjau tidak memuat operasi pengiriman pesan, pemanggilan layanan operator, atau pendebitan akun. Hasilnya merupakan analisis teks yang disertakan, bukan jaminan pengiriman atau tagihan akhir. Pengiriman dapat melibatkan tarif tujuan, biaya operator, persyaratan kampanye, dan perubahan teks tambahan. Hitung ulang setelah mengubah pesan, lalu gunakan alur kerja pengiriman yang telah disetujui dan harga akun yang berlaku saat ini.