JSON · HTTPS · Kunci Bearer

Terima kod pengesahan dan hantar SMS dengan satu API SMS

API TODAY SMS ialah API pembangun yang menggabungkan API pengesahan SMS untuk menerima kod pada nombor sekali guna dan API penghantaran SMS untuk menghantar ke 227 negara, dengan satu kunci API dan satu baki. Setiap permintaan dan respons dalam JSON, dan harga serta peraturan bayaran balik sama seperti di laman web.

Lihat dokumen API Daftar dan dapatkan kunci

today-sms.com/api/v1

$ curl -X POST https://today-sms.com/api/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app":"telegram","country":"indonesia"}'
{
  "id": "N-7K2M-QX4P-9D3A",
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z"
}

$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "received",
  "sms": [
    { "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
  ]
}

$ curl -X POST https://today-sms.com/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":["+14155550100","+447700900123"],"text":"Your code is 482913"}'
{
  "id": "m_7Q2K9X",
  "status": "queued",
  "recipients": 2,
  "parts": 1,
  "encoding": "GSM-7",
  "cost": "0.0136"
}

$ curl https://today-sms.com/api/v1/messages/m_7Q2K9X \
  -H "Authorization: Bearer YOUR_API_KEY"

300 permintaan seminit
Satu kunci untuk terima dan hantar
Gagal atau tidak diterima dibayar balik ke baki
Isi dengan 12 kaedah kripto

Apa yang boleh anda lakukan dengan API SMS

API pengesahan SMS

Pilih aplikasi dan negara, beli nombor dan semak statusnya berkala untuk mendapatkan kod pengesahan. Jika tiada SMS diterima, jumlah penuh dikembalikan ke baki anda apabila masa tamat.

API penghantaran SMS

Hantar mesej anda kepada sehingga 1,000 penerima sekali gus dan dapatkan laporan penghantaran bagi setiap penerima. Tambah masa berjadual untuk menghantarnya pada masa itu.

API harga dan stok

Dapatkan negara dan harga bagi setiap aplikasi, bilangan nombor dan harga setiap SMS bagi setiap negara melalui API, dan paparkannya seadanya dalam perkhidmatan anda sendiri.

Satu baki

Penerimaan dan penghantaran menggunakan baki yang sama. Tambah nilai dengan USDT dan semak pada bila-bila masa melalui API.

Ringkasan kaedah

Dokumen penuh

Kaedah	Fungsi
GET/balance	Dapatkan baki
GET/apps	Senarai aplikasi
GET/prices?app=telegram	Negara dan harga bagi sesuatu aplikasi
POST/numbers	Beli nombor
GET/numbers/{id}	Status nombor dan SMS
POST/numbers/{id}/cancel	Batalkan nombor
POST/numbers/{id}/finish	Selesaikan nombor
GET/messages/prices	Harga SMS mengikut negara
POST/messages	Hantar SMS
GET/messages/{id}	Status penghantaran dan laporan penghantaran
POST/messages/{id}/cancel	Batalkan penghantaran berjadual

Apakah API SMS?

API SMS ialah sambungan yang membolehkan perisian anda menerima atau menghantar SMS dengan permintaan HTTP. Kod melakukan apa yang biasanya diklik oleh seseorang di skrin web, jadi tugasan berulang seperti ujian pendaftaran automatik, penghantaran kod pengesahan dan makluman pesanan berjalan tanpa campur tangan sesiapa.

API TODAY SMS menawarkan dua perkara sekali gus. Pertama, API pengesahan SMS (API pengaktifan SMS) untuk menerima kod pengesahan aplikasi pada nombor sekali guna, dan kedua, API penghantaran SMS untuk menghantar SMS ke telefon bimbit di seluruh dunia. Kedua-duanya menggunakan URL yang sama, kunci API yang sama dan baki yang sama, jadi tiada pendaftaran atau tambah nilai berasingan.

Bagaimana saya menggunakan API pengesahan SMS?

Ia mengambil empat langkah. Pilih kod aplikasi dengan GET /apps dan lihat negara serta harga dengan GET /prices?app=CODE. Beli nombor dengan POST /numbers untuk mendapatkan nombor dan id-nya, kemudian panggil GET /numbers/{id} setiap beberapa saat untuk menyemak sama ada kod telah tiba. Sebaik sahaja anda mendapat kod, tutup nombor dengan POST /numbers/{id}/finish.

Setiap nombor menunggu SMS selama 20 minit, dan SMS ke nombor yang sama dalam tempoh itu tidak dikenakan kos tambahan. Jika tiada SMS diterima, jumlah penuh dikembalikan ke baki anda apabila masa tamat, dan jika tiada apa-apa yang tiba, anda boleh membatalkan sendiri dengan POST /numbers/{id}/cancel mulai 120 saat selepas pembelian. Apabila anda memerlukan automasi pengesahan aplikasi atau API nombor maya pukal, ulangi sahaja aliran ini.

Bagaimana saya menggunakan API penghantaran SMS?

Hantar senarai penerima (to) dan teks mesej (text) ke POST /messages dan anda menerima id mesej, bilangan penerima, bilangan bahagian dan jumlah kos. Masukkan penerima dalam format antarabangsa dengan + dan kod negara, sehingga 1,000 setiap permintaan. Untuk menjadualkan, letakkan masa UTC dalam at.

Selepas menghantar, semak laporan penghantaran bagi setiap penerima dengan GET /messages/{id}. Terdapat empat status: pending, sent, delivered dan failed, dan jumlah untuk bahagian yang berakhir sebagai failed ditambah ke refunded dan dikembalikan ke baki anda. Batalkan penghantaran berjadual yang belum dihantar dengan POST /messages/{id}/cancel.

Gunakan kaedah yang sama untuk menghantar kod pengesahan (OTP). Setiap kod dikira sebagai satu SMS tanpa yuran pengesahan berasingan, dan anda boleh mendapatkan harga setiap SMS bagi setiap negara dengan GET /messages/prices untuk mengira kos anda.

Apakah yang perlu saya cari dalam API SMS yang berpatutan?

Lihat jumlah yang sebenarnya anda bayar, bukan sekadar harga setiap SMS dalam senarai harga. TODAY SMS tiada yuran bulanan dan hanya menolak bahagian yang anda hantar, dan bahagian yang gagal serta kod pengesahan yang tidak pernah tiba dibayar balik ke baki anda.

Seterusnya, lihat pengurusan kunci dan had. Anda mendapat satu kunci API setiap akaun dan boleh mencipta kunci baharu pada bila-bila masa, yang akan menyekat kunci lama dengan serta-merta. Permintaan dibenarkan sehingga 300 seminit, cukup untuk kebanyakan automasi. Akhir sekali, lihat pembayaran. Anda boleh menambah kredit dengan 12 kaedah kripto termasuk USDT, USDC dan BTC tanpa kad, jadi anda boleh bermula dengan segera dari mana-mana negara.

Bagaimana saya mendapatkan kunci API?

Buat akaun, dan sebaik sahaja tambah nilai pertama anda dikreditkan, anda boleh membuat kunci di halaman kunci API. Kunci hanya dipaparkan sekali semasa anda membuatnya, jadi simpannya di tempat yang selamat. Hantarnya bersama setiap permintaan dalam pengepala Authorization: Bearer.

Jika anda fikir kunci anda telah bocor, buat kunci baharu di halaman kunci API. Kunci lama terus berhenti berfungsi. Sesiapa yang memegang kunci anda boleh membeli nombor atau menghantar SMS dengan baki anda, jadi jangan sekali-kali meletakkannya dalam kod pelayar atau repositori awam.

Sambungkan API SMS hari ini

Pendaftaran hanya memerlukan satu token. Sebaik sahaja tambah nilai pertama anda dikreditkan, buat kunci API, tampal contoh daripada dokumen dan hantar permintaan pertama anda.