- হোম
- API
SMS ভেরিফিকেশন API
নিজের সফটওয়্যার থেকে নম্বর কিনুন ও কোড পড়ুন। API আপনার ব্যালান্স ব্যবহার করে, আর দাম ও 20 মিনিটের রিফান্ডের নিয়ম ওয়েবসাইটের মতোই।
API কী আপনি নিজের অ্যাকাউন্টের ভেতরে তৈরি করেন। API দিয়ে কেনা নম্বর ওয়েবসাইটের মতোই একই ব্যালান্স থেকে, একই দামে কাটা হয়।
মূল তথ্য
- প্রতি নম্বরের সর্বনিম্ন দাম
- $0.0018
- অথেনটিকেশন
- API কী
- ফরম্যাট
- HTTPS এর মাধ্যমে JSON
- রিকোয়েস্ট সীমা
- প্রতি মিনিটে 120টি রিকোয়েস্ট
- রিফান্ড
- ওয়েবসাইটের মতোই
REST ও JSON
ছয়টি রিকোয়েস্টে ব্যালান্স, সার্ভিস, দাম, নম্বর নেওয়া, স্ট্যাটাস ও বাতিল।
অ্যাকাউন্ট থেকে নেওয়া কী
অ্যাকাউন্টের API কী পেজে একটি কী তৈরি করুন এবং Authorization হেডারে পাঠান।
ওয়েবসাইটের মতোই দাম
নম্বরের দাম এবং 20 মিনিটের রিফান্ডের নিয়ম ওয়েবসাইটের মতোই।
কোন কোন রিকোয়েস্ট পাঠানো যায়?
পাথগুলো বেস URL এর পরে বসে। প্রতিটি রিকোয়েস্টে আপনার API কী লাগবে।
| মেথড ও পাথ | কী করে |
|---|---|
GET/ | USD তে আপনার ব্যালান্স |
GET/ | সব সার্ভিস, সর্বনিম্ন দাম ও দেশের সংখ্যা সহ |
GET/ | একটি সার্ভিসের সব দেশে একটি নম্বরের দাম |
POST/ | একটি সার্ভিস ও দেশের নম্বর নিন; দাম আপনার ব্যালান্স থেকে কাটা হয় |
GET/ | নম্বরের স্ট্যাটাস এবং এ পর্যন্ত আসা সব কোড |
POST/ | কোড আসার আগে বাতিল করুন; দাম আপনার ব্যালান্সে ফিরে যায় |
API কোন ক্রমে কল করব?
- 1
নম্বর নিন service ও country দিয়ে POST /numbers করুন। id ও নম্বরটি সেভ করে রাখুন।
- 2
নম্বরটি লিখুন যে সার্ভিস কোড পাঠাবে, সেখানে নম্বরটি লিখুন।
- 3
কোড চেক করুন codes খালি না হওয়া পর্যন্ত প্রতি 5 সেকেন্ডে GET /numbers/{id} করুন।
- 4
শেষ করুন কোডটি ব্যবহার করুন। কোড আসার আগেই নম্বরের দরকার না থাকলে বাতিল করুন।
API কী কীভাবে পাব?
লগ ইন করে অ্যাকাউন্টে API কী পেজ খুলুন। একটি কী তৈরি করে সাথে সাথে কপি করুন; এটি শুধু একবার দেখানো হয়। নতুন কী বানালে পুরনোটি বন্ধ হয়ে যায়।
API কীবেস URL কী?
প্রতিটি রিকোয়েস্ট এই ঠিকানায় পাঠান, কী দিন Authorization হেডারে (Bearer) অথবা X-Api-Key হেডারে:
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>রিকোয়েস্ট ফিল্ড
| ফিল্ড | কোথায় ব্যবহার হয় | মান |
|---|---|---|
service | POST /numbers, GET /prices | /services থেকে সার্ভিসের নাম, যেমন telegram |
country | POST /numbers | দুই অক্ষরের দেশ কোড, যেমন gb |
রেসপন্স ফিল্ড ও স্ট্যাটাস
| মান | অর্থ |
|---|---|
waiting | নম্বর খোলা, এখনো কোনো কোড আসেনি |
received | অন্তত একটি কোড এসেছে; expires_at পর্যন্ত আরও আসতে পারে |
refunded | 20 মিনিটে কোনো কোড আসেনি; দাম আপনার ব্যালান্সে ফিরে গেছে |
canceled | কোড আসার আগে আপনি বাতিল করেছেন; দাম আপনার ব্যালান্সে ফিরে গেছে |
রেসপন্সের উদাহরণ
{ "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" } ]}এরর কোড
unauthorized | API কী নেই বা ভুল |
rate_limited | এক মিনিটে 120টির বেশি রিকোয়েস্ট |
bad_service | অজানা সার্ভিসের নাম |
bad_country | ওই সার্ভিসের জন্য দেশটি পাওয়া যায় না |
low_balance | ব্যালান্স দামের চেয়ে কম |
unavailable | এই মুহূর্তে কোনো নম্বর নেই। কোনো টাকা কাটা হয়নি |
not_found | আপনার অ্যাকাউন্টে ওই id এর কোনো নম্বর নেই |
cannot_cancel | কোড আগেই এসেছে বা নম্বরটি বন্ধ |
কোডের উদাহরণ
# 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"]])SMS ভেরিফিকেশন API নিয়ে প্রশ্নোত্তর
SMS ভেরিফিকেশন API কী?
ওয়েবসাইটের বদলে নিজের প্রোগ্রাম থেকে নম্বর কেনা ও কোড পড়ার একটি উপায়।
API এর জন্য কি বাড়তি খরচ আছে?
না। নম্বরের দাম ওয়েবসাইটের মতোই, আর একই ব্যালান্স থেকে কাটা হয়।
কতগুলো রিকোয়েস্ট পাঠানো যায়?
প্রতি কী তে মিনিটে সর্বোচ্চ 120টি রিকোয়েস্ট। প্রতি 5 সেকেন্ডে চেক করলে সীমার অনেক নিচে থাকে।
API এর নম্বরেও কি রিফান্ড হয়?
হ্যাঁ, একই নিয়মে: 20 মিনিটে কোড না এলে দাম আপনার ব্যালান্সে ফিরে যায়।
কী কোথায় তৈরি করব?
আপনার অ্যাকাউন্টের API কী পেজে।