Kirim permintaan pengiriman SMS
Kirim permintaan SMS teks internasional; satu antarmuka dengan dual autentikasi (Bearer API Key / CheckSum).
Kirim permintaan pengiriman SMS
curl -X POST "https://api.innosms.com/intsms/v2/om/sms/submit" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"sender": "INNOTEST",
"tdFlag": 1,
"message": "Flash sale today only, up to 50 percent off",
"productType": "market",
"phoneNumbers": "+6591234567,+6591234568,+6591234569",
"validityPeriod": "+000001000000000R"
}'Pengiriman diproses; kode status HTTP selalu 200, kode bisnis membedakan penerimaan dan penolakan.
{
"msg": "success",
"code": "000000",
"data": {
"messageId": "ORDER-20261112-0002",
"errorPhone": [
"+6591234568"
]
},
"requestId": "REQ-20261112-0002"
}Contoh respons dari kontrak yang ditinjau, bukan hasil permintaan nyata.
Menerima pengiriman SMS teks internasional secara asinkron untuk satu atau beberapa nomor. Mendukung dua mode autentikasi: Bearer API Key, atau header CheckSum (AppID, Nonce, CurTime, CheckSum) saat Authorization kosong. Daftar putih IP level apiKey wajib dikonfigurasi dan IP klien harus cocok. Kode status HTTP selalu 200; hasil bisnis dibedakan melalui kode enam digit, 000000 berarti diterima.
Gunakan AppKey InnoPaaS sebagai Bearer token. Buat atau kelola key di halaman API keys Console. Panduan API key
Authorization
Authorizationstring<bearer>wajibParameter Header
X-Custom-TraceIdstringopsionalOptional customer trace ID. When provided it is echoed back in the response header and used as the request identifier.
256Body
application/jsonuidstringopsionalID pesan pelanggan, opsional, maksimal 128 karakter; dikembalikan sebagai data.messageId untuk pengiriman multi-nomor.
128senderstringopsionalSender ID, opsional, maksimal 20 karakter.
20tdFlagintegeropsionalPenanda berhenti berlangganan, opsional; 1 aktif, 0 atau tidak diisi nonaktif.
messagestringwajibIsi SMS, wajib, maksimal 3000 karakter.
3000accountNamestringopsionalNama akun, opsional; jika kosong digunakan akun yang terkait dengan API Key.
callbackUrlstringopsionalURL callback laporan status, opsional.
productTypestringwajibTipe produk, wajib. notify=SMS verifikasi/notifikasi, market=SMS pemasaran; tidak peka huruf besar/kecil, nilai selain market diperlakukan sebagai notify.
phoneNumbersstringwajibNomor penerima, wajib, format internasional (kode negara+nomor), beberapa nomor dipisah koma.
validityPeriodstringopsionalMasa berlaku SMS, opsional, format waktu relatif [+-]YYMMDDhhmmss000R.
Respons
application/jsonPengiriman diproses; kode status HTTP selalu 200, kode bisnis membedakan penerimaan dan penolakan.
msgstringopsionalDeskripsi hasil (bahasa Inggris).
codestringopsionalKode bisnis enam digit, 000000 berarti diterima.
dataobjectnullopsionalData penerimaan; field kosong tidak disertakan dalam body JSON.
requestIdstringopsionalIdentifikasi permintaan ini; dikembalikan apa adanya jika permintaan membawa X-Custom-TraceId.
{
"msg": "success",
"code": "000000",
"data": {
"messageId": "ORDER-20261112-0002",
"errorPhone": [
"+6591234568"
]
},
"requestId": "REQ-20261112-0002"
}Contoh respons dari kontrak yang ditinjau, bukan hasil permintaan nyata.