- Beranda
- API
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.
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.
| Metode dan path | Fungsinya |
|---|---|
GET/ | Saldo Anda dalam USD |
GET/ | Semua layanan dengan harga terendah dan jumlah negaranya |
GET/ | Harga satu nomor di setiap negara untuk satu layanan |
POST/ | Beli nomor untuk layanan dan negara tertentu; harganya dipotong dari saldo Anda |
GET/ | Status nomor dan semua kode yang sudah diterima |
POST/ | Batalkan sebelum kode masuk; harganya kembali ke saldo Anda |
Bagaimana urutan memanggil API?
- 1
Beli nomor POST /numbers dengan service dan country. Simpan id dan nomornya.
- 2
Masukkan nomornya Ketik nomor itu di layanan yang mengirim kode.
- 3
Cek kodenya GET /numbers/{id} setiap 5 detik sampai daftar codes tidak kosong.
- 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 APIApa base URL-nya?
Kirim setiap permintaan ke alamat ini dengan kunci di header Authorization (Bearer) atau header X-Api-Key:
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>Field permintaan
| Field | Dipakai di | Nilai |
|---|---|---|
service | POST /numbers, GET /prices | Nama layanan dari /services, mis. telegram |
country | POST /numbers | Kode negara dua huruf, mis. gb |
Field respons dan status
| Nilai | Arti |
|---|---|
waiting | Nomor aktif dan belum ada kode yang masuk |
received | Setidaknya satu kode sudah masuk; kode lain masih bisa datang sampai expires_at |
refunded | Tidak ada kode dalam 20 menit; harganya sudah kembali ke saldo Anda |
canceled | Anda 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
unauthorized | Kunci API tidak ada atau salah |
rate_limited | Lebih dari 120 permintaan dalam satu menit |
bad_service | Nama layanan tidak dikenal |
bad_country | Negara tidak tersedia untuk layanan itu |
low_balance | Saldo lebih rendah dari harga |
unavailable | Belum ada nomor yang tersedia saat ini. Tidak ada saldo yang terpotong |
not_found | Tidak ada nomor dengan id itu di akun Anda |
cannot_cancel | Kode 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"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])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.