Langsung ke konten
tomnumber

API verifikasi SMS

Beli nomor dan baca kode dari software Anda sendiri. API memakai saldo Anda, harga yang sama, dan aturan pengembalian dana 20 menit yang sama seperti di situs.

Kunci API dibuat di dalam akun Anda. Nomor yang dibeli lewat API memakai saldo yang sama dengan harga yang sama seperti di situs.

Buat akunKunci API

Mulai $0.0018 per nomor

Fakta utama

Harga terendah per nomor
$0.0018
Autentikasi
Kunci API
Format
JSON lewat HTTPS
Batas permintaan
120 permintaan per menit
Pengembalian dana
Sama seperti di situs

REST dan JSON

Enam permintaan untuk saldo, layanan, harga, beli nomor, status dan pembatalan.

Kunci dari akun Anda

Buat kunci di halaman kunci API di akun Anda, lalu kirim di header Authorization.

Harga sama seperti di situs

Harga nomor dan aturan pengembalian dana 20 menit sama seperti di situs.

Permintaan apa saja yang bisa saya kirim?

Path ditulis setelah base URL. Setiap permintaan memerlukan kunci API Anda.

Permintaan apa saja yang bisa saya kirim?
Metode dan pathFungsinya
GET/balanceSaldo Anda dalam USD
GET/servicesSemua layanan dengan harga terendah dan jumlah negaranya
GET/prices?service=telegramHarga satu nomor di setiap negara untuk satu layanan
POST/numbersBeli nomor untuk layanan dan negara tertentu; harganya dipotong dari saldo Anda
GET/numbers/{id}Status nomor dan semua kode yang sudah diterima
POST/numbers/{id}/cancelBatalkan sebelum kode masuk; harganya kembali ke saldo Anda

Bagaimana urutan memanggil API?

  1. 1

    Beli nomor POST /numbers dengan service dan country. Simpan id dan nomornya.

  2. 2

    Masukkan nomornya Ketik nomor itu di layanan yang mengirim kode.

  3. 3

    Cek kodenya GET /numbers/{id} setiap 5 detik sampai daftar codes tidak kosong.

  4. 4

    Selesai Gunakan kodenya. Jika nomor sudah tidak diperlukan sebelum kode datang, batalkan.

Bagaimana cara mendapatkan kunci API?

Masuk dan buka Kunci API di akun Anda. Buat kunci dan langsung salin; kunci hanya ditampilkan sekali. Membuat kunci baru akan menonaktifkan kunci lama.

Kunci API

Apa base URL-nya?

Kirim setiap permintaan ke alamat ini dengan kunci di header Authorization (Bearer) atau header X-Api-Key:

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

Field permintaan

Field permintaan
FieldDipakai diNilai
servicePOST /numbers, GET /pricesNama layanan dari /services, mis. telegram
countryPOST /numbersKode negara dua huruf, mis. gb

Field respons dan status

Field respons dan status
NilaiArti
waitingNomor aktif dan belum ada kode yang masuk
receivedSetidaknya satu kode sudah masuk; kode lain masih bisa datang sampai expires_at
refundedTidak ada kode dalam 20 menit; harganya sudah kembali ke saldo Anda
canceledAnda membatalkan sebelum kode masuk; harganya sudah kembali ke saldo Anda

Contoh respons

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

Kode error

Kode error
unauthorizedKunci API tidak ada atau salah
rate_limitedLebih dari 120 permintaan dalam satu menit
bad_serviceNama layanan tidak dikenal
bad_countryNegara tidak tersedia untuk layanan itu
low_balanceSaldo lebih rendah dari harga
unavailableBelum ada nomor yang tersedia saat ini. Tidak ada saldo yang terpotong
not_foundTidak ada nomor dengan id itu di akun Anda
cannot_cancelKode sudah masuk atau nomor sudah ditutup

Contoh kode

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

FAQ API verifikasi SMS

Apa itu API verifikasi SMS?

Cara membeli nomor dan membaca kode dari program Anda sendiri, tanpa lewat situs.

Apakah API dikenai biaya tambahan?

Tidak. Harga nomor sama seperti di situs dan dibayar dari saldo yang sama.

Berapa banyak permintaan yang bisa saya kirim?

Hingga 120 permintaan per menit per kunci. Cek setiap 5 detik masih jauh di bawah batas itu.

Apakah nomor dari API juga dikembalikan dananya?

Ya, dengan aturan yang sama: jika tidak ada kode dalam 20 menit, harganya kembali ke saldo Anda.

Di mana saya membuat kuncinya?

Di akun Anda, pada menu Kunci API.

Nomor virtual untuk layanan lain