মূল অংশে যান
tomnumber

SMS ভেরিফিকেশন API

নিজের সফটওয়্যার থেকে নম্বর কিনুন ও কোড পড়ুন। API আপনার ব্যালান্স ব্যবহার করে, আর দাম ও 20 মিনিটের রিফান্ডের নিয়ম ওয়েবসাইটের মতোই।

API কী আপনি নিজের অ্যাকাউন্টের ভেতরে তৈরি করেন। API দিয়ে কেনা নম্বর ওয়েবসাইটের মতোই একই ব্যালান্স থেকে, একই দামে কাটা হয়।

অ্যাকাউন্ট খুলুনAPI কী

প্রতি নম্বর $0.0018 থেকে

মূল তথ্য

প্রতি নম্বরের সর্বনিম্ন দাম
$0.0018
অথেনটিকেশন
API কী
ফরম্যাট
HTTPS এর মাধ্যমে JSON
রিকোয়েস্ট সীমা
প্রতি মিনিটে 120টি রিকোয়েস্ট
রিফান্ড
ওয়েবসাইটের মতোই

REST ও JSON

ছয়টি রিকোয়েস্টে ব্যালান্স, সার্ভিস, দাম, নম্বর নেওয়া, স্ট্যাটাস ও বাতিল।

অ্যাকাউন্ট থেকে নেওয়া কী

অ্যাকাউন্টের API কী পেজে একটি কী তৈরি করুন এবং Authorization হেডারে পাঠান।

ওয়েবসাইটের মতোই দাম

নম্বরের দাম এবং 20 মিনিটের রিফান্ডের নিয়ম ওয়েবসাইটের মতোই।

কোন কোন রিকোয়েস্ট পাঠানো যায়?

পাথগুলো বেস URL এর পরে বসে। প্রতিটি রিকোয়েস্টে আপনার API কী লাগবে।

কোন কোন রিকোয়েস্ট পাঠানো যায়?
মেথড ও পাথকী করে
GET/balanceUSD তে আপনার ব্যালান্স
GET/servicesসব সার্ভিস, সর্বনিম্ন দাম ও দেশের সংখ্যা সহ
GET/prices?service=telegramএকটি সার্ভিসের সব দেশে একটি নম্বরের দাম
POST/numbersএকটি সার্ভিস ও দেশের নম্বর নিন; দাম আপনার ব্যালান্স থেকে কাটা হয়
GET/numbers/{id}নম্বরের স্ট্যাটাস এবং এ পর্যন্ত আসা সব কোড
POST/numbers/{id}/cancelকোড আসার আগে বাতিল করুন; দাম আপনার ব্যালান্সে ফিরে যায়

API কোন ক্রমে কল করব?

  1. 1

    নম্বর নিন service ও country দিয়ে POST /numbers করুন। id ও নম্বরটি সেভ করে রাখুন।

  2. 2

    নম্বরটি লিখুন যে সার্ভিস কোড পাঠাবে, সেখানে নম্বরটি লিখুন।

  3. 3

    কোড চেক করুন codes খালি না হওয়া পর্যন্ত প্রতি 5 সেকেন্ডে GET /numbers/{id} করুন।

  4. 4

    শেষ করুন কোডটি ব্যবহার করুন। কোড আসার আগেই নম্বরের দরকার না থাকলে বাতিল করুন।

API কী কীভাবে পাব?

লগ ইন করে অ্যাকাউন্টে API কী পেজ খুলুন। একটি কী তৈরি করে সাথে সাথে কপি করুন; এটি শুধু একবার দেখানো হয়। নতুন কী বানালে পুরনোটি বন্ধ হয়ে যায়।

API কী

বেস URL কী?

প্রতিটি রিকোয়েস্ট এই ঠিকানায় পাঠান, কী দিন Authorization হেডারে (Bearer) অথবা X-Api-Key হেডারে:

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

রিকোয়েস্ট ফিল্ড

রিকোয়েস্ট ফিল্ড
ফিল্ডকোথায় ব্যবহার হয়মান
servicePOST /numbers, GET /prices/services থেকে সার্ভিসের নাম, যেমন telegram
countryPOST /numbersদুই অক্ষরের দেশ কোড, যেমন gb

রেসপন্স ফিল্ড ও স্ট্যাটাস

রেসপন্স ফিল্ড ও স্ট্যাটাস
মানঅর্থ
waitingনম্বর খোলা, এখনো কোনো কোড আসেনি
receivedঅন্তত একটি কোড এসেছে; expires_at পর্যন্ত আরও আসতে পারে
refunded20 মিনিটে কোনো কোড আসেনি; দাম আপনার ব্যালান্সে ফিরে গেছে
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" }  ]}

এরর কোড

এরর কোড
unauthorizedAPI কী নেই বা ভুল
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"

SMS ভেরিফিকেশন API নিয়ে প্রশ্নোত্তর

SMS ভেরিফিকেশন API কী?

ওয়েবসাইটের বদলে নিজের প্রোগ্রাম থেকে নম্বর কেনা ও কোড পড়ার একটি উপায়।

API এর জন্য কি বাড়তি খরচ আছে?

না। নম্বরের দাম ওয়েবসাইটের মতোই, আর একই ব্যালান্স থেকে কাটা হয়।

কতগুলো রিকোয়েস্ট পাঠানো যায়?

প্রতি কী তে মিনিটে সর্বোচ্চ 120টি রিকোয়েস্ট। প্রতি 5 সেকেন্ডে চেক করলে সীমার অনেক নিচে থাকে।

API এর নম্বরেও কি রিফান্ড হয়?

হ্যাঁ, একই নিয়মে: 20 মিনিটে কোড না এলে দাম আপনার ব্যালান্সে ফিরে যায়।

কী কোথায় তৈরি করব?

আপনার অ্যাকাউন্টের API কী পেজে।

অন্যান্য সার্ভিসের ভার্চুয়াল নম্বর