Langkau ke kandungan
tomnumber

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.

Buat akaunKunci API

Dari $0.0018 setiap nombor

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.

Permintaan apa yang boleh saya hantar?
Kaedah dan laluanFungsi
GET/balanceBaki anda dalam USD
GET/servicesSemua perkhidmatan dengan harga terendah dan jumlah negara
GET/prices?service=telegramHarga satu nombor di setiap negara bagi satu perkhidmatan
POST/numbersDapatkan nombor untuk perkhidmatan dan negara; harga ditolak daripada baki anda
GET/numbers/{id}Status nombor dan semua kod yang diterima setakat ini
POST/numbers/{id}/cancelBatal sebelum kod tiba; harga dikembalikan ke baki anda

Apakah urutan untuk memanggil API?

  1. 1

    Dapatkan nombor POST /numbers dengan service dan country. Simpan id dan nombor.

  2. 2

    Masukkan nombor Taip nombor ke dalam perkhidmatan yang menghantar kod.

  3. 3

    Semak kod GET /numbers/{id} setiap 5 saat sehingga senarai codes tidak kosong.

  4. 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 API

Apakah URL asas?

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

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

Medan permintaan

Medan permintaan
MedanDigunakan dalamNilai
servicePOST /numbers, GET /pricesNama perkhidmatan daripada /services, cth. telegram
countryPOST /numbersKod negara dua huruf, cth. gb

Medan respons dan status

Medan respons dan status
NilaiMaksud
waitingNombor dibuka dan belum ada kod diterima
receivedSekurang-kurangnya satu kod telah tiba; kod lain masih boleh tiba sehingga expires_at
refundedTiada kod dalam 20 minit; harga telah dikembalikan ke baki anda
canceledAnda 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

Kod ralat
unauthorizedKunci API tiada atau salah
rate_limitedLebih daripada 120 permintaan dalam seminit
bad_serviceNama perkhidmatan tidak dikenali
bad_countryNegara tidak tersedia untuk perkhidmatan itu
low_balanceBaki lebih rendah daripada harga
unavailableTiada nombor tersedia sekarang. Tiada caj dikenakan
not_foundTiada nombor dengan id itu dalam akaun anda
cannot_cancelKod 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"

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.

Nombor maya untuk perkhidmatan lain