- Laman utama
- API
API pengesahan SMS
Beli nombor dan baca kod daripada perisian anda sendiri. API menggunakan baki anda, harga yang sama dan peraturan bayaran balik 20 minit yang sama seperti laman web.
Anda membuat kunci API di dalam akaun anda. Nombor yang dibeli melalui API ditolak daripada baki yang sama pada harga yang sama seperti laman web.
Fakta utama
- Harga terendah setiap nombor
- $0.0018
- Pengesahihan
- Kunci API
- Format
- JSON melalui HTTPS
- Had kadar
- 120 permintaan seminit
- Bayaran balik
- Sama seperti laman web
REST dan JSON
Enam permintaan meliputi baki, perkhidmatan, harga, mendapatkan nombor, status dan batal.
Kunci daripada akaun anda
Buat kunci pada halaman Kunci API dalam akaun anda dan hantarnya dalam header Authorization.
Harga sama seperti laman web
Harga nombor dan peraturan bayaran balik 20 minit sama seperti di laman web.
Permintaan apa yang boleh saya hantar?
Laluan diletakkan selepas URL asas. Setiap permintaan memerlukan kunci API anda.
| Kaedah dan laluan | Fungsi |
|---|---|
GET/ | Baki anda dalam USD |
GET/ | Semua perkhidmatan dengan harga terendah dan jumlah negara |
GET/ | Harga satu nombor di setiap negara bagi satu perkhidmatan |
POST/ | Dapatkan nombor untuk perkhidmatan dan negara; harga ditolak daripada baki anda |
GET/ | Status nombor dan semua kod yang diterima setakat ini |
POST/ | Batal sebelum kod tiba; harga dikembalikan ke baki anda |
Apakah urutan untuk memanggil API?
- 1
Dapatkan nombor POST /numbers dengan service dan country. Simpan id dan nombor.
- 2
Masukkan nombor Taip nombor ke dalam perkhidmatan yang menghantar kod.
- 3
Semak kod GET /numbers/{id} setiap 5 saat sehingga senarai codes tidak kosong.
- 4
Selesai Gunakan kod. Jika anda tidak lagi memerlukan nombor sebelum kod tiba, batalkannya.
Bagaimana mendapatkan kunci API?
Log masuk dan buka Kunci API dalam akaun anda. Buat kunci dan salin segera; ia hanya dipaparkan sekali. Membuat kunci baharu akan mematikan kunci lama.
Kunci APIApakah URL asas?
Hantar setiap permintaan ke alamat ini dengan kunci dalam header Authorization (Bearer) atau header X-Api-Key:
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>Medan permintaan
| Medan | Digunakan dalam | Nilai |
|---|---|---|
service | POST /numbers, GET /prices | Nama perkhidmatan daripada /services, cth. telegram |
country | POST /numbers | Kod negara dua huruf, cth. gb |
Medan respons dan status
| Nilai | Maksud |
|---|---|
waiting | Nombor dibuka dan belum ada kod diterima |
received | Sekurang-kurangnya satu kod telah tiba; kod lain masih boleh tiba sehingga expires_at |
refunded | Tiada kod dalam 20 minit; harga telah dikembalikan ke baki anda |
canceled | Anda membatalkan sebelum kod tiba; harga telah dikembalikan ke baki 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" } ]}Kod ralat
unauthorized | Kunci API tiada atau salah |
rate_limited | Lebih daripada 120 permintaan dalam seminit |
bad_service | Nama perkhidmatan tidak dikenali |
bad_country | Negara tidak tersedia untuk perkhidmatan itu |
low_balance | Baki lebih rendah daripada harga |
unavailable | Tiada nombor tersedia sekarang. Tiada caj dikenakan |
not_found | Tiada nombor dengan id itu dalam akaun anda |
cannot_cancel | Kod sudah tiba atau nombor sudah ditutup |
Contoh kod
# 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"]])Soalan lazim API pengesahan SMS
Apakah API pengesahan SMS?
Cara untuk membeli nombor dan membaca kod daripada program anda sendiri dan bukannya melalui laman web.
Adakah API dikenakan caj tambahan?
Tidak. Harga nombor sama seperti di laman web dan dibayar daripada baki yang sama.
Berapa banyak permintaan yang boleh saya hantar?
Sehingga 120 permintaan seminit bagi setiap kunci. Menyemak setiap 5 saat masih jauh di bawah had itu.
Adakah nombor API juga dibayar balik?
Ya, dengan peraturan yang sama: tiada kod dalam 20 minit bermakna harga dikembalikan ke baki anda.
Di mana saya membuat kunci?
Dalam akaun anda, di bahagian Kunci API.