Kirimkan pesan pertama Anda di suatu sore
REST API biasa untuk mengirim, melacak, dan menerima SMS — autentikasi token, webhook dan SDK real-time, tanpa hal eksotik untuk dipelajari.
Tiga gerakan, mulai disampaikan
Setiap integrasi memiliki alur pendek yang sama — autentikasi, kirim, lalu lacak.
Kirim kunci akses Anda sebagai header Token, dengan Tipe Konten: aplikasi/json, pada setiap permintaan.
POST dari, ke dan konten. Responsnya segera muncul kembali dengan msgid dan kode kesalahan.
Kami POST atau DAPATKAN laporan status ke URL panggilan balik Anda saat pesan mencapai keadaan akhirnya.
Satu permintaan, dalam bahasa yang sudah Anda gunakan
POST pengirim, penerima, dan konten Anda dengan header Token. Responsnya muncul kembali saat kita menerimanya.
01curl -X POST https://secure.smslocal.com/api/service/enterprise-service/external/sms \02 -H "Token: $SMSLOCAL_TOKEN" \03 -H "Content-Type: application/json" \04 -d '{05 "from": "SMSLOCAL",06 "to": "14155550123",07 "content": "Your code is 481920."08 }'msgstr "9f2a7c10-4b2e-..."
arah "mt"
kode kesalahan 0
Simpan msgstr — begitulah cara Anda melacak pesan ini dari sini.
Membaca pesan dari atas ke bawah
Pengiriman, status, dan acara masuk semuanya kembali ke bentuk yang sama — pelajari sekali.
ID pesan
msgstr — dicetak saat pesan dibuat. Ini adalah pegangan yang Anda gunakan untuk memeriksa statusnya nanti.
Pengirim
dari — nomor telepon, atau ID alfanumerik hingga 11 karakter, identitas apa pun yang dilihat penerima Anda.
Penerima
ke — nomor tujuan pesan, termasuk kode negara.
Pengkodean
pengkodean data — GSM7 memuat 160 karakter per bagian; beralih ke Unicode dan turun menjadi 70. Lanjutkan, dan itu digabungkan menjadi bagian-bagian tambahan.
Arah
arah — setiap pesan adalah mt (Anda mengirimkannya) atau mo (Anda menerimanya), bentuknya sama saja.
Kode Kesalahan
kode kesalahan — dikembalikan pada respons pengiriman dan setiap laporan status. 0 berarti diterima; hal lain memberi tahu Anda apa yang salah.
Satu titik akhir, dua kata kerja
POST untuk mengirim, GET untuk memeriksa status — URL yang sama dan header Token yang sama.
Mengirim
Kirim pesan dan segera dapatkan kembali pesan dan kode kesalahan.
Kembali msgstr + kode kesalahanMelacak
Cari pesan yang sudah Anda kirim untuk memeriksa statusnya saat ini.
Kembali pesan + statusLaporan status, saat hal itu terjadi
Tetapkan URL panggilan balik dan setiap pengiriman, kegagalan, dan balasan masuk akan dikirim ke sana sebagai GET atau POST — tidak perlu polling.
Dapatkan kunci API Anda
Mulai integrasi dalam hitungan menit dengan REST API kami.
Dokumen pengembang — pertanyaan umum
Berikan access key Anda di header Token pada setiap permintaan — Token: {accessKey} — bersama dengan Content-Type: application/json.
Setiap pengiriman akan menghasilkan pesan kembali. Arahkan kami ke URL panggilan balik dan kami POST atau DAPATKAN laporan status ke URL tersebut saat pesan mencapai status akhirnya — subtanggal, tanggal selesai, dan kode status yang dihasilkan disertakan.
mt (ponsel dihentikan) adalah pesan yang Anda kirim; mo (berasal dari ponsel) adalah balasan yang Anda terima. Keduanya menggunakan bentuk objek pesan yang sama.
Pengiriman dicoba ulang sesuai dengan kebijakan coba ulang — tidak ada yang dibatalkan secara diam-diam, namun titik akhir yang tidak pernah mengakui akan terus menerima percobaan ulang.
160 karakter pada pengkodean GSM7, atau 70 pada Unicode. Melewati batas dan pesan akan digabungkan menjadi beberapa bagian, masing-masing ditagih secara terpisah.