Memperkenalkan API Publik SMS4You: Otomatisasi Penerimaan SMS dan Pengelolaan Nomor
Kami dengan bangga mengumumkan peluncuran sesuatu yang telah lama ditunggu-tunggu oleh banyak dari Anda—API Publik SMS4You. Kini, semua hal yang sebelumnya Anda lakukan secara manual di akun Anda dapat dilakukan secara otomatis melalui skrip: membeli nomor, mengambil kode dari SMS dan email, serta memantau saldo dan tarif Anda. Skrip, bot, dan sistem pendaftaran Anda dapat berinteraksi langsung dengan SMS4You—tanpa perlu satu klik pun.
Di bawah ini, kami akan menjelaskan secara rinci apa yang telah kami luncurkan, mengapa Anda membutuhkannya, dan cara memulainya dalam lima menit.
Sekilas tentang Fitur Utama
API REST berfitur lengkap untuk aktivasi OTP (penerimaan SMS) dan aktivasi email.
Katalog negara, layanan, dan harga terkini—semua yang terlihat di akun Anda juga tersedia melalui API.
Webhooks: kode dan pembaruan status dikirim secara otomatis ke server Anda tanpa perlu melakukan polling terus-menerus.
Kompatibilitas dengan protokol SMS-Activate: port integrasi yang sudah ada hanya dengan mengubah satu alamat.
Otentikasi sederhana melalui token yang Anda buat sendiri di akun Anda.
Dokumentasi interaktif dengan kemampuan untuk menguji permintaan langsung di browser Anda.
Mengapa Anda Membutuhkan API
Membeli nomor secara manual memang bisa dilakukan jika jumlah aktivasi masih sedikit. Namun, begitu Anda harus menangani puluhan atau ratusan pendaftaran, pemrosesan massal, atau mengintegrasikan penerimaan SMS ke dalam produk Anda sendiri, mengklik antarmuka menjadi hal yang merepotkan. API ini memecahkan masalah ini dengan tepat: Anda cukup menentukan logikanya sekali dalam kode, dan semua proses lainnya akan berjalan secara otomatis, dalam skala apa pun dan kapan pun sepanjang hari.
Skenario umum yang menjadi dasar pengembangan API ini:
pendaftaran dan verifikasi akun otomatis di perangkat lunak Anda;
pemrosesan massal dan pengujian yang memerlukan sejumlah besar nomor telepon secara berurutan;
mengintegrasikan penerimaan kode SMS secara langsung ke dalam layanan atau produk Anda;
migrasi integrasi yang sudah ada yang awalnya dibuat untuk penyedia lain.
Apa yang Dapat Dilakukan oleh API ini
1. Aktivasi siap pakai: mulai dari pembelian nomor hingga penerimaan kode
Seluruh siklus hidup aktivasi dapat diakses melalui titik akhir REST yang intuitif:
pilih layanan dan negara, periksa ketersediaan dan harga;
beli nomor dengan satu permintaan;
ambil SMS yang diterima (atau email, jika aktivasi melalui email);
selesaikan, batalkan, atau minta SMS ulang—Anda memiliki kendali penuh atas statusnya.
Kedua produk utama didukung: penerimaan SMS (OTP) dan aktivasi melalui email. Setiap aktivasi memiliki pengenal unik yang dapat Anda gunakan untuk merujuknya nanti.
2. Katalog dan Harga Saat Ini
API ini menyediakan data real-time:
daftar negara beserta kode teleponnya;
daftar layanan (untuk SMS dan email);
harga untuk layanan atau negara tertentu, serta daftar harga lengkap dengan hasil per halaman.
Catatan penting: Harga yang ditampilkan sudah termasuk diskon pribadi Anda. Apa yang Anda lihat dalam respons API adalah jumlah yang persis akan dipotong dari saldo Anda.
3. Webhook: Kode Dikirimkan Secara Otomatis
Terus-menerus memeriksa server sambil menunggu pesan SMS sangat boros dan lambat. Itulah mengapa SMS4You menawarkan webhooks: begitu pesan baru tiba atau status aktivasi berubah, kami secara otomatis mengirimkan permintaan HTTP ke alamat yang Anda tentukan.
Anda menerima peristiwa secara instan, tanpa perlu melakukan polling;
Setiap permintaan ditandatangani dengan tanda tangan HMAC, sehingga Anda dapat memverifikasi bahwa permintaan tersebut benar-benar berasal dari kami;
Kami menerapkan mekanisme percobaan ulang jika server Anda sementara tidak tersedia;
Bagi yang membatasi lalu lintas masuk melalui daftar putih (whitelist), kami menerbitkan daftar alamat IP dari mana webhook dikirim.
Bersama dengan REST API, ini melengkapi integrasi: Anda mengirimkan permintaan sendiri dan menerima pembaruan melalui saluran push.
4. Kompatibilitas dengan SMS-Activate: Migrasi Tanpa Perlu Menulis Ulang
Ini adalah hal yang sangat kami banggakan. Jika Anda sudah memiliki perangkat lunak yang dibangun di sekitar API SMS-Activate, Anda tidak perlu menulis ulang integrasi Anda. SMS4You mendukung protokol yang kompatibel: cukup ganti alamat server dengan milik kami dan ganti kunci Anda sendiri.
Kode, pustaka, dan bot yang sudah ada akan tetap berfungsi seperti semula, tetapi kini dengan nomor telepon, harga, dan kualitas dari SMS4You. Hal ini membuat peralihan ke layanan kami hanya memerlukan satu baris kode di berkas konfigurasi Anda, bukan pengembangan berminggu-minggu.
5. Otentikasi yang Aman dan Sederhana
Tidak ada nama pengguna atau kata sandi dalam skrip Anda. Masuk ke akun Anda, buat token pribadi di tab Token API, dan gunakan dalam permintaan Anda. Anda dapat mengirimkan token dengan tiga cara—pilih yang paling nyaman untuk pustaka Anda:
di header
Authorization: Bearer <api token>;header
X-Api-Token: <api token>;sebagai parameter kueri
?api_token=<api token>.
Anda dapat membuat beberapa token (misalnya, satu token terpisah untuk setiap proyek) dan mencabut token yang bocor kapan saja tanpa memengaruhi token lainnya. Nilai token hanya ditampilkan sekali saat dibuat—setelah itu, nilai tersebut hanya disimpan oleh Anda.
6. Dokumentasi interaktif
Kami telah menyiapkan dokumentasi interaktif berdasarkan OpenAPI: setiap titik akhir dijelaskan, tipe setiap bidang ditentukan, dan Anda dapat menjalankan permintaan langsung dari halaman tanpa perlu membuka terminal. Terdapat juga bagian terpisah mengenai webhook dan protokol yang kompatibel dengan SMS-Activate.
Dokumentasi ini tersedia di docs.sms4you.org.
Mulailah dalam lima menit
URL API Dasar: https://api.sms4you.org/api/v1
Langkah 1. Periksa saldo akun dan diskon Anda
curl https://api.sms4you.org/api/v1/me \
-H "Authorization: Bearer YOU TOKEN"
{
"data": {
"name": "Ivan",
"email": "[email protected]",
"email_verified": true,
"balance": "12.3456",
"currency": "USD",
"discount_percent": 5
}
}
Langkah 2. Periksa harga layanan yang diinginkan
curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
-H "Authorization: Bearer YOU TOKEN"
Langkah 3. Beli nomor
curl -X POST https://api.sms4you.org/api/v1/activations \
-H "Authorization: Bearer YOU TOKEN" \
-H "Content-Type: application/json" \
-d '{"service_id": 123, "country_id": 7, "price": "0.20"}'
Respons tersebut akan berisi nomor telepon dan kode aktivasi.
Langkah 4. Buka SMS yang Anda terima
curl https://api.sms4you.org/api/v1/activations/{ACTIVATION_ID}/messages \
-H "Authorization: Bearer YOU TOKEN"
Dan jika Anda mengatur webhook, Anda bahkan tidak perlu melakukan langkah ini—kode tersebut akan dikirimkan kepada Anda secara otomatis.
Batasan dan Keandalan
Frekuensi permintaan dibatasi (hingga 120 permintaan per menit secara default) untuk memastikan layanan tetap stabil bagi semua orang.
Semua respons hadir dalam format yang seragam, termasuk pesan kesalahan: kode yang jelas, pesan yang dapat dibaca manusia, dan, jika diperlukan, detailnya. Memprosesnya dalam kode sangatlah mudah.
Alamat email yang terverifikasi diperlukan untuk pembelian—sebagai langkah keamanan standar.
Untuk siapa layanan ini
Pengembang yang perlu menerima pesan SMS di dalam produk mereka.
Tim arbitrase dan pemasaran yang menerima pendaftaran secara terus-menerus.
Tim QA yang menguji skenario yang melibatkan verifikasi nomor telepon.
Siapa pun yang sudah menggunakan perangkat lunak yang kompatibel dengan SMS-Activate dan menginginkan penyedia layanan tanpa repot melakukan migrasi.
Langkah Selanjutnya
API publik adalah fondasi yang akan terus kami kembangkan. Kami berencana memperluas cakupan dan kemampuan produk kami dengan mendengarkan permintaan Anda. Jika Anda tidak menemukan titik akhir (endpoint) atau skenario tertentu, hubungi kami melalui obrolan dukungan: kami membaca semua masukan dan memprioritaskan apa yang benar-benar dibutuhkan.
Cobalah sekarang juga:
Masuk ke akun Anda dan buat token di tab Token API.
Buka dokumentasi di docs.sms4you.org.
Lakukan permintaan pertama Anda—dan otomatiskan sisanya.
Nikmati integrasinya, dan semoga kode-kode Anda tiba tepat waktu.
