dokumen

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.

Mulai cepat

Tiga gerakan, mulai disampaikan

Setiap integrasi memiliki alur pendek yang sama — autentikasi, kirim, lalu lacak.

01 · OtentikasiToken: sk_live_9f2a7c10Tipe Konten: application/json ✓

Kirim kunci akses Anda sebagai header Token, dengan Tipe Konten: aplikasi/json, pada setiap permintaan.

02 · MengirimPOST /eksternal/sms{ msgstr: "9f2a7c10", kode kesalahan: 0 }

POST dari, ke dan konten. Responsnya segera muncul kembali dengan msgid dan kode kesalahan.

03 · MelacakDAPATKAN /laporan?status=Kirim200 oke

Kami POST atau DAPATKAN laporan status ke URL panggilan balik Anda saat pesan mencapai keadaan akhirnya.

Mengirim

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  }'
201 · Diterima

msgstr "9f2a7c10-4b2e-..."

arah "mt"

kode kesalahan 0

Simpan msgstr — begitulah cara Anda melacak pesan ini dari sini.

Objek pesan

Membaca pesan dari atas ke bawah

Pengiriman, status, dan acara masuk semuanya kembali ke bentuk yang sama — pelajari sekali.

01ID pesan

ID pesan

msgstr — dicetak saat pesan dibuat. Ini adalah pegangan yang Anda gunakan untuk memeriksa statusnya nanti.

02Pengirim

Pengirim

dari — nomor telepon, atau ID alfanumerik hingga 11 karakter, identitas apa pun yang dilihat penerima Anda.

03Penerima

Penerima

ke — nomor tujuan pesan, termasuk kode negara.

04Pengkodean

Pengkodean

pengkodean data — GSM7 memuat 160 karakter per bagian; beralih ke Unicode dan turun menjadi 70. Lanjutkan, dan itu digabungkan menjadi bagian-bagian tambahan.

05Arah

Arah

arah — setiap pesan adalah mt (Anda mengirimkannya) atau mo (Anda menerimanya), bentuknya sama saja.

06Kode Kesalahan

Kode Kesalahan

kode kesalahan — dikembalikan pada respons pengiriman dan setiap laporan status. 0 berarti diterima; hal lain memberi tahu Anda apa yang salah.

Referensi

Satu titik akhir, dua kata kerja

POST untuk mengirim, GET untuk memeriksa status — URL yang sama dan header Token yang sama.

POS

Mengirim

Kirim pesan dan segera dapatkan kembali pesan dan kode kesalahan.

Kembali msgstr + kode kesalahan
MENDAPATKAN

Melacak

Cari pesan yang sudah Anda kirim untuk memeriksa statusnya saat ini.

Kembali pesan + status
Webhook

Laporan 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.

terkirimmsgstr 9f2a7c10 · status Pengiriman
masukbalasan diterima · arah mo
gagalmsgstr 4c81e2 · status Gagal
Titik akhir Anda200 oke
Memulai

Dapatkan kunci API Anda

Mulai integrasi dalam hitungan menit dengan REST API kami.

Jawaban Atas Pertanyaan Anda

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.