Hubungkan pengiriman SMS
ke layanan Anda.

Mulai cepat

1. Buat kunci API

   Setelah mendaftar, disetujui, dan login dengan OTP, buka Kelola kunci API untuk membuat kunci.

2. Siapkan kredit

   API memakai kredit dan tarif akun Anda. Biaya dipotong saat pengiriman diterima.

3. Kirim pesan dan cek hasilnya

   Simpan ID pengiriman dan cek hasilnya lewat API status.

Negara yang didukung

GET/api/v1/messages/countries

Cek negara aktif dan tarif yang berlaku lewat API. Tentukan negara dengan country saat mengirim, dan masukkan nomor dari negara yang sama dalam satu permintaan. Negara tanpa tarif tidak menerima pengiriman.

{ "currency": "USDT", "countries": [{ "country": "US", "unitPrice": 0.02 }] }

Autentikasi dengan kunci API

Sertakan header berikut di setiap permintaan API eksternal. Cookie login atau kode OTP tidak diperlukan.

Authorization: Bearer hex_live_KUNCI_API_ANDA

Kunci asli hanya ditampilkan sekali saat diterbitkan. Simpan di variabel lingkungan server dan jangan masukkan ke kode frontend. Kunci tidak dapat dipakai jika dicabut atau akun ditangguhkan. Anda dapat membuat hingga 5 kunci.

Kirim ke 1.000 nomor sekaligus

Kirim satu isi pesan ke banyak nomor. Permintaan divalidasi, dimasukkan ke antrean, lalu langsung dijawab. Untuk isi berbeda per nomor, gunakan permintaan terpisah dengan Idempotency-Key baru.

Jika ada satu saja nomor tidak valid atau duplikat, seluruh permintaan ditolak tanpa pengiriman maupun potongan saldo. Duplikat dicek setelah nomor diubah ke format internasional.

curl -X POST 'https://hexsms.com/api/v1/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: notice-20261024-001' \
  -d '{
    "country": "US",
    "text": "Your verification code is 482913.",
    "recipients": ["+12025550123", "+12025550124"]
  }'

{
  "id": "35bed356-b84a-452a-8e94-98b538972ecd",
  "country": "US",
  "state": "RUNNING",
  "total": 2,
  "segments": 1,
  "unitPrice": 0.025,
  "cost": 0.05,
  "createdAt": 1792800000000,
  "note": null,
  "replayed": false
}

Begini biaya dihitung

Jumlah nomor × segmen (segments) × harga satuan akun UCS-2 memuat hingga 70 karakter dalam 1 segmen, lalu 67 karakter per segmen. Karakter dasar GSM-7 memuat hingga 160 karakter dalam 1 segmen, lalu 153 per segmen. Karakter ekstensi dihitung 2, emoji dihitung menurut panjang UTF-16. unitPrice dan cost dalam USDT. Harga satuan dalam respons adalah harga yang berlaku; 0.025 di atas hanya contoh.

Cek hasil pengiriman per nomor

Gunakan id dari API pengiriman. Hanya pengiriman via API milik akun yang sama yang dapat dilihat. Endpoint ini mengembalikan hasil tersimpan. Jika butuh hasil terbaru dari operator, panggil API pembaruan status berikut terlebih dahulu.

curl 'https://hexsms.com/api/v1/messages/35bed356-b84a-452a-8e94-98b538972ecd?limit=1&offset=0' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "35bed356-b84a-452a-8e94-98b538972ecd",
  "country": "US",
  "state": "DONE",
  "total": 2, "segments": 1,
  "unitPrice": 0.025, "cost": 0.05,
  "createdAt": 1792800000000, "note": null,
  "summary": { "DELIVERED": 1, "PENDING": 1 },
  "messages": [
    {
      "id": "d2787184-d8b8-49c6-9c15-1db90a6d5516",
      "to": "12025550123",
      "status": "DELIVERED",
      "statusName": "DELIVERED_TO_HANDSET",
      "description": "Message delivered to handset",
      "error": null,
      "updatedAt": 1792800005000
    }
  ],
  "pagination": { "limit": 1, "offset": 0, "nextOffset": 1 }
}

limit bernilai 1–1.000 (default 100), offset 0–1.000 (default 0). Jika nextOffset bernilai null, itu halaman terakhir. summary adalah jumlah per status untuk semua nomor. to dikembalikan dalam format internasional tanpa +, waktu dalam milidetik Unix. Urutan hasil bisa berbeda dari urutan nomor saat dikirim; bedakan tiap message dengan id-nya.

Ambil status penerimaan terbaru

Memperbarui hasil tersimpan dari log operator. Body tidak diperlukan. Setelah diperbarui, baca kembali hasilnya dengan GET. Pengiriman yang sama dapat diperbarui sekali per 30 detik. Log operator dapat diakses selama 48 jam setelah pengiriman. Di lingkungan dengan webhook, hasil dapat diperbarui otomatis.

curl -X POST 'https://hexsms.com/api/v1/messages/35bed356-b84a-452a-8e94-98b538972ecd/refresh' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{ "id": "35bed356-b84a-452a-8e94-98b538972ecd", "updated": 2 }

updated adalah jumlah baris yang diperbarui. Nilainya bisa 0 jika pesan masih antre atau belum ada hasil baru. Disarankan memanggil GET dengan jeda minimal 10 detik dan meminta refresh hanya bila perlu.

Pahami kode status

state permintaan pengiriman

PREPARING disiapkan · RUNNING diproses · PAUSED dijeda · DONE antrean selesai · CANCELED dibatalkan

Operator dapat menambah kode status baru, jadi tangani juga status yang tidak dikenal. Alasan kegagalan dapat dilihat di statusName, description, dan error.

Cara menangani error

{ "error": "Kredit tidak cukup. Isi saldo lalu kirim ulang permintaan.", "code": "INSUFFICIENT_CREDITS" }

Setiap kunci API dapat mengirim hingga 120 permintaan per menit, gabungan pengiriman, cek status, dan pembaruan. Jika terkena batas, cek header Retry-After. API ini untuk integrasi antarserver; panggilan CORS dari browser tidak didukung.

Hubungkan dengan Node.js

const response = await fetch('https://hexsms.com/api/v1/messages', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + process.env.HEXSMS_API_KEY,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'notice-20261024-001'
  },
  body: JSON.stringify({
    country: 'US',
    text: 'Your order is on its way.',
    recipients: ['+12025550123', '+12025550124']
  })
});
const result = await response.json();
if (!response.ok) throw new Error(result.code + ': ' + result.error);
console.log(result.id); // Use this ID to check delivery status.

Buat kunci permintaan sekali per tugas, dan gunakan nilai yang sama saat mencoba ulang karena tidak ada respons. Mengirim ulang tugas yang sudah berhasil dengan kunci baru akan diproses sebagai pengiriman terpisah.