Lumaktaw sa nilalaman
tomnumber

SMS verification API

Bumili ng number at basahin ang code mula sa sarili mong software. Ginagamit ng API ang iyong balance, ang parehong presyo at ang parehong 20-minutong patakaran sa refund gaya ng website.

Sa loob ng iyong account ka gagawa ng API key. Ang mga number na binili sa API ay galing sa parehong balance at may parehong presyo gaya ng website.

Gumawa ng accountAPI key

Mula $0.0018 kada number

Mahahalagang detalye

Pinakamababang presyo kada number
$0.0018
Authentication
API key
Format
JSON sa HTTPS
Rate limit
120 request kada minuto
Refund
Pareho sa website

REST at JSON

Anim na request para sa balance, serbisyo, presyo, pagkuha ng number, status at cancel.

Key mula sa iyong account

Gumawa ng key sa API key page ng iyong account at ipadala ito sa Authorization header.

Parehong presyo gaya ng website

Pareho sa website ang presyo ng number at ang 20-minutong patakaran sa refund.

Anong mga request ang puwede kong ipadala?

Idinudugtong ang path pagkatapos ng base URL. Kailangan ng bawat request ang iyong API key.

Anong mga request ang puwede kong ipadala?
Method at pathGinagawa nito
GET/balanceAng iyong balance sa USD
GET/servicesLahat ng serbisyo kasama ang pinakamababang presyo at dami ng bansa
GET/prices?service=telegramAng presyo ng isang number sa bawat bansa para sa isang serbisyo
POST/numbersKumuha ng number para sa serbisyo at bansa; kinakaltas ang presyo sa iyong balance
GET/numbers/{id}Status ng number at lahat ng code na natanggap hanggang ngayon
POST/numbers/{id}/cancelKanselahin bago dumating ang code; babalik ang bayad sa iyong balance

Sa anong pagkakasunod-sunod tatawagin ang API?

  1. 1

    Kumuha ng number POST /numbers kasama ang service at country. I-save ang id at number.

  2. 2

    Ilagay ang number I-type ang number sa serbisyong magpapadala ng code.

  3. 3

    Tingnan kung may code GET /numbers/{id} kada 5 segundo hanggang hindi na empty ang listahan ng codes.

  4. 4

    Tapusin Gamitin ang code. Kung hindi mo na kailangan ang number bago dumating ang code, kanselahin ito.

Paano makakuha ng API key?

Mag-log in at buksan ang API key sa iyong account. Gumawa ng key at kopyahin agad; isang beses lang ito ipapakita. Kapag gumawa ng bagong key, hindi na gagana ang luma.

API key

Ano ang base URL?

Ipadala ang bawat request sa address na ito, kasama ang key sa Authorization header (Bearer) o sa X-Api-Key header:

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

Mga field ng request

Mga field ng request
FieldGinagamit saValue
servicePOST /numbers, GET /pricesPangalan ng serbisyo mula sa /services, hal. telegram
countryPOST /numbersDalawang-letrang country code, hal. gb

Mga field ng response at status

Mga field ng response at status
ValueKahulugan
waitingBukas ang number at wala pang dumating na code
receivedMay dumating nang kahit isang code; puwede pang dumating ang iba hanggang expires_at
refundedWalang code sa loob ng 20 minuto; bumalik ang bayad sa iyong balance
canceledKinansela mo bago dumating ang code; bumalik ang bayad sa iyong balance

Halimbawang response

{  "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" }  ]}

Mga error code

Mga error code
unauthorizedWalang API key o mali ito
rate_limitedHigit sa 120 request sa isang minuto
bad_serviceHindi kilalang pangalan ng serbisyo
bad_countryHindi available ang bansa para sa serbisyong iyon
low_balanceMas mababa ang balance kaysa sa presyo
unavailableWalang available na number ngayon. Walang nakaltas
not_foundWalang number na may ganitong id sa iyong account
cannot_cancelMay dumating nang code o sarado na ang number

Mga halimbawa ng code

# 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 tungkol sa SMS verification API

Ano ang SMS verification API?

Paraan para bumili ng number at basahin ang code mula sa sarili mong program sa halip na sa website.

May dagdag bang bayad ang API?

Wala. Pareho ang presyo ng number sa website at binabayaran ito mula sa parehong balance.

Ilang request ang puwede kong ipadala?

Hanggang 120 request kada minuto kada key. Malayo pa sa limit ang pag-check kada 5 segundo.

Nire-refund din ba ang mga number sa API?

Oo, sa parehong patakaran: kapag walang code sa loob ng 20 minuto, babalik ang bayad sa iyong balance.

Saan ako gagawa ng key?

Sa iyong account, sa API key.

Virtual number para sa ibang serbisyo