Dokumentasi REST API
API REST SMS & MMS
Kirim pesan aplikasi yang disetujui dan tangani penerimaan, peristiwa pengiriman, segmentasi, dan biaya.
Pilih API dan kredensial secara bersamaan
Akun dengan profil Pengembang & Otomatisasi, Bisnis, dan Penyedia komunikasi yang telah disetujui dapat mengintegrasikan layanan yang diaktifkan. Pengembang individu tidak perlu berpura-pura menjadi perusahaan. SMS/MMS dari aplikasi memerlukan persetujuan pengiriman dan registrasi yang berlaku. Layanan Pribadi & Keluarga tidak memiliki API pengiriman pesan yang dapat diakses pelanggan.
| Keluarga API | URL dasar | Autentikasi dan hasil |
|---|---|---|
| Komunikasi v3 | https://api.multitel.net/v3 | Kredensial Basic yang disetujui; token yang disediakan dan memenuhi syarat hanya untuk operasi yang mendukungnya. JSON status dan response. |
| Registrasi darurat | https://api.multi.tel/emergency | Kredensial Basic yang disetujui atau akses bearer yang disediakan secara khusus. JSON code, message, dan data. |
| Integrasi REST portal | Host dan operasi yang ditampilkan dalam referensi pengembang akun Anda | Gunakan kredensial, cakupan izin (scope), dan skema yang didokumentasikan untuk operasi tersebut. Permintaan sesi browser menggunakan antarmuka yang terpisah. |
Atur MULTITEL_API_USERNAME dan MULTITEL_API_PASSWORD melalui konfigurasi rahasia server Anda sebelum menggunakan contoh. Jangan pernah menanamkannya di JavaScript browser publik, URL, atau kontrol sumber. Kredensial khusus dikelola di pengaturan Integrasi API.
Siapkan permintaan SMS
Gunakan nomor pengirim milik akun yang telah disetujui dan mendukung SMS, penerima yang menyetujui pesan tersebut, serta registrasi Brand/Campaign atau verifikasi nomor bebas pulsa yang diperlukan. Contoh di bawah ini mengirim pesan sungguhan jika diisi dengan kredensial dan nomor yang berfungsi; ini bukan sandbox.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
--request POST \
--header "Content-Type: application/json" \
--data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
"https://api.multitel.net/v3/sendsms"Ganti placeholder pengirim dan penerima dengan nomor telepon dalam format internasional, hanya berupa angka dan termasuk kode negara. Untuk MMS, sertakan URL media yang didukung dan dapat diambil secara publik di media, serta verifikasi kelayakan dan harga MMS terlebih dahulu.
Diterima sistem belum berarti sampai ke penerima
Periksa status aplikasi luar dan hasil pengiriman pesan yang dikembalikan. Catat pengidentifikasi pesan yang diberikan layanan, dan ikuti status pengiriman serta peristiwa webhook. Pengiriman yang berhasil diajukan tidak membuktikan bahwa ponsel penerima menerima pesan tersebut.
Penagihan SMS dihitung per segmen. Pengodean dan panjang pesan dapat menghasilkan beberapa segmen; biaya media dan biaya terkait operator dapat berbeda dari SMS. Baca harga jual akun saat ini sebelum mengirim. Jangan pernah mengulangi pengiriman yang kehabisan waktu secara membabi buta: periksa dahulu hasil yang tercatat.
Menangani kesalahan dan percobaan ulang
- Kegagalan autentikasi atau izin
- Periksa status aktif kredensial API, layanan yang diizinkan, dan pembatasan IP sumber. Cookie sesi portal bukan kredensial integrasi.
- Kredit tidak mencukupi atau persetujuan belum terpenuhi
- Selesaikan masalah saldo akun, persetujuan pengiriman, atau persyaratan dokumen sebelum mengulangi operasi.
- Tidak ada hasil
- Tangani inventaris kosong atau nama pemanggil yang tidak ditemukan sebagai hasil yang wajar. Jangan berasumsi bahwa nomor yang sintaksnya valid memiliki semua layanan.
- Waktu tunggu jaringan habis atau layanan gagal
- Gunakan percobaan ulang terbatas dengan backoff untuk operasi baca. Untuk pembelian, pengiriman, atau registrasi, periksa dahulu status operasinya; mengulangi permintaan yang sudah diterima dapat menggandakan tindakan yang ditagih.
Dukungan idempotensi bergantung pada masing-masing keluarga API. Emergency API mendukung kunci percobaan ulang; hal itu tidak membuat permintaan v3 sembarang menjadi idempoten. Simpan stempel waktu, ID yang dikembalikan, dan respons yang telah disamarkan untuk dukungan.
Lanjutkan dengan referensi akun Anda
Referensi setelah masuk menyaring operasi berdasarkan izin dan layanan yang aktif pada akun Anda. Gunakan host, jenis kredensial, kolom permintaan, dan skema respons persis seperti yang tercantum di sana. Konsol dapat menjalankan operasi langsung, termasuk pembelian dan pengiriman pesan.