- Home
- API
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.
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.
| Method at path | Ginagawa nito |
|---|---|
GET/ | Ang iyong balance sa USD |
GET/ | Lahat ng serbisyo kasama ang pinakamababang presyo at dami ng bansa |
GET/ | Ang presyo ng isang number sa bawat bansa para sa isang serbisyo |
POST/ | Kumuha ng number para sa serbisyo at bansa; kinakaltas ang presyo sa iyong balance |
GET/ | Status ng number at lahat ng code na natanggap hanggang ngayon |
POST/ | Kanselahin bago dumating ang code; babalik ang bayad sa iyong balance |
Sa anong pagkakasunod-sunod tatawagin ang API?
- 1
Kumuha ng number POST /numbers kasama ang service at country. I-save ang id at number.
- 2
Ilagay ang number I-type ang number sa serbisyong magpapadala ng code.
- 3
Tingnan kung may code GET /numbers/{id} kada 5 segundo hanggang hindi na empty ang listahan ng codes.
- 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 keyAno 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/v1Authorization: Bearer <API_KEY>Mga field ng request
| Field | Ginagamit sa | Value |
|---|---|---|
service | POST /numbers, GET /prices | Pangalan ng serbisyo mula sa /services, hal. telegram |
country | POST /numbers | Dalawang-letrang country code, hal. gb |
Mga field ng response at status
| Value | Kahulugan |
|---|---|
waiting | Bukas ang number at wala pang dumating na code |
received | May dumating nang kahit isang code; puwede pang dumating ang iba hanggang expires_at |
refunded | Walang code sa loob ng 20 minuto; bumalik ang bayad sa iyong balance |
canceled | Kinansela 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
unauthorized | Walang API key o mali ito |
rate_limited | Higit sa 120 request sa isang minuto |
bad_service | Hindi kilalang pangalan ng serbisyo |
bad_country | Hindi available ang bansa para sa serbisyong iyon |
low_balance | Mas mababa ang balance kaysa sa presyo |
unavailable | Walang available na number ngayon. Walang nakaltas |
not_found | Walang number na may ganitong id sa iyong account |
cannot_cancel | May 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"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 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.