SMS تصدیق API — SMSBurner

بڑے پیمانے پر OTP ویریفیکیشن کو خودکار بنائیں۔ 190+ ممالک میں ورچوئل فون نمبر خریدیں، سیکنڈوں میں SMS کوڈز وصول کریں، وقف شدہ طویل مدتی نمبر کرائے پر لیں، اور ہر آرڈر کو ایک ہی REST اینڈ پوائنٹ کے ذریعے منظم کریں — کوئی API key نہیں، کوئی KYC نہیں، کرپٹو کرنسی میں بلنگ۔

پڑھنے کا وقت: 5 منٹ REST · JSON · OpenAPI 3.0 آخری بار اپ ڈیٹ کیا گیا: 2026-07-19 OpenAPI اسپیک →

ڈویلپرز SMSBurner API کیوں منتخب کرتے ہیں

SMSBurner ان ڈویلپرز کے لیے سب سے لچکدار SMS ویریفیکیشن API ہے جنہیں گمنامی، عالمی رسائی اور قابلِ پیش گوئی قیمتوں کی ضرورت ہے۔ روایتی SMS-OTP فراہم کنندگان کے برعکس جو انٹرپرائز معاہدوں، ماہانہ کم از کم حد اور KYC سوالناموں کے پیچھے رسائی روکتے ہیں، SMSBurner کسی بھی HTTPS کلائنٹ کے ساتھ کام کرتا ہے، سختی سے فی نمبر چارج کرتا ہے، اور 8 کرپٹو کرنسیاں قبول کرتا ہے جن میں Bitcoin، Monero، Ethereum، USDT، Solana، Litecoin اور TRON شامل ہیں۔

عام استعمال کے مواقع میں بڑے پیمانے پر QA کے لیے اکاؤنٹ سائن اپس کو خودکار بنانا، ہیڈ لیس ایجنٹس اور CI بوٹس کے لیے ون ٹائم پاس ورڈز حاصل کرنا، مسلسل انٹیگریشن میں فون-درکار فلوز کی توثیق کرنا، Telegram یا WhatsApp اکاؤنٹس کے لیے وقف شدہ طویل مدتی نمبر کرائے پر لینا جنہیں بلا تعطل SMS وصولی کی ضرورت ہو، اور واضح آپریٹر-ٹیئر کنٹرول کے ساتھ 190+ ممالک میں جغرافیائی طور پر تقسیم شدہ ویریفیکیشن کو طاقت دینا — ورچوئل، فزیکل یا پریمیم — شامل ہیں۔

تصدیقِ ہویت

API کوکی پر مبنی سیشن تصدیق استعمال کرتا ہے۔ پروگرام کے ذریعے تصدیق کرنے کے لیے:

اپنی سیڈ فریز کے ساتھ /auth-api.php پر POST درخواست بھیجیں
جواب سے سیشن کوکی محفوظ کریں
کوکی کو تمام بعد کی API درخواستوں میں شامل کریں

POST /auth-api.php

اپنے سیڈ فریز کے ساتھ تصدیق کریں اور سیشن قائم کریں۔

پیرامیٹر	قسم	درکار	تفصیل
action	string	لازمی	یہ لازمی طور پر `"login"` ہونا چاہیے
seed	string	لازمی	آپ کا 16 حروف کا ایکسیس سیڈ (مثلاً `AbC3-dEf4-gHj5-kLm6`)

cURL
Python
JavaScript
# Login and save session cookie
curl -X POST https://smsburner.com/auth-api.php \
  -d "action=login&seed=AbC3-dEf4-gHj5-kLm6" \
  -c cookies.txt
import requests

session = requests.Session()
resp = session.post("https://smsburner.com/auth-api.php", data={
    "action": "login",
    "seed": "AbC3-dEf4-gHj5-kLm6"
})
data = resp.json()
print(data)  # {"success": true, "user": {...}}

# session object now holds the cookie for all future requests
const resp = await fetch("https://smsburner.com/auth-api.php", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: "action=login&seed=AbC3-dEf4-gHj5-kLm6"
});
const data = await resp.json();
console.log(data); // {success: true, user: {...}}

کامیاب جواب

{ "success": true, "user": { "id": 42, "prefix": "AbC3", "balance": "74.50" } }

ایرر رسپانس

{ "success": false, "error": "Invalid seed." }

بیس URL

تمام API اینڈ پوائنٹس اس کے نسبت ہیں:

https://smsburner.com/api.php?action={action}

تمام جوابات JSON میں ہوتے ہیں۔ POST اینڈ پوائنٹس application/json اور application/x-www-form-urlencoded دونوں طرح کے ریکویسٹ باڈیز قبول کرتے ہیں۔

ریٹ کی حدیں

API درج ذیل ریٹ لمٹس کا اطلاق کرتا ہے:

اینڈ پوائنٹ	حد	ونڈو
تصدیقِ ہویت	5 کوششیں	15 منٹ
دیگر تمام اینڈ پوائنٹس	کوئی سخت حد نہیں	—

ریٹ لِمِٹنگ: تصدیق (authentication) ہر 15 منٹ میں 5 کوششوں تک محدود ہے۔ دیگر اینڈ پوائنٹس پر فی الحال کوئی ریٹ لِمِٹ نہیں، مگر حد سے زیادہ استعمال کو محدود کیا جا سکتا ہے۔ مناسب وقفوں سے درخواستیں بھیجیں۔

ایرر ہینڈلنگ

تمام خرابیاں ایک JSON آبجیکٹ کے ساتھ <code>error</code> فیلڈ واپس کرتی ہیں:

{ "error": "Description of what went wrong" }

HTTP کوڈ	مطلب
200	کامیابی (ایپلیکیشن سطح کی خرابیوں کے لیے جوابی باڈی چیک کریں)
403	غلط CSRF ٹوکن
405	غلط HTTP میتھڈ (مثلاً صرف POST والے اینڈ پوائنٹ پر GET)
429	ریٹ کی حد سے تجاوز

عام ایپلیکیشن سطح کی خرابیاں:

خرابی	وجہ
`"Login required"`	سیشن ختم ہو گیا یا تصدیق نہیں ہوئی
`"Insufficient balance"`	ناکافی فنڈز — اس میں `need` اور `have` فیلڈز شامل ہیں
`"Service not available for this country"`	منتخب کردہ ملک کے لیے اسٹاک موجود نہیں یا سروس غیر فعال ہے
`"Missing country or service"`	مطلوبہ پیرامیٹرز فراہم نہیں کیے گئے

ممالک کی فہرست

GET /api.php?action=countries

دستیاب ورچوئل نمبروں والے تمام فعال ممالک واپس کرتا ہے۔ کوئی تصدیق درکار نہیں۔

cURL
Python
JavaScript
curl https://smsburner.com/api.php?action=countries
resp = session.get("https://smsburner.com/api.php", params={"action": "countries"})
countries = resp.json()
for c in countries:
    print(c["code"], c["name"])
const resp = await fetch("https://smsburner.com/api.php?action=countries");
const countries = await resp.json();

جواب

[ { "id": 1, "code": "us", "name": "USA" }, { "id": 2, "code": "gb", "name": "UK" }, { "id": 3, "code": "de", "name": "Germany" } ]

سروسز کی فہرست

GET /api.php?action=services&country={code}

کسی مخصوص ملک کے لیے دستیاب خدمات واپس کرتا ہے، بشمول قیمتیں اور اسٹاک۔ ملک کوڈ کے بغیر، تمام خدمات بغیر قیمت کے واپس کرتا ہے۔

پیرامیٹر	قسم	درکار	تفصیل
country	string	اختیاری	ISO 3166-1 alpha-2 ملکی کوڈ (مثلاً `us`، `gb`، `de`)

جواب (ملک کے ساتھ)

[ { "id": 12, "name": "WhatsApp", "slug": "whatsapp", "icon_code": "WA", "icon_color": "#25d366", "category": "social", "price": "0.35", "stock": 847 } ]

آپریٹرز کی فہرست

GET /api.php?action=operators&country={code}

کسی مخصوص ملک کے لیے دستیاب آپریٹرز (کیریئرز) واپس کرتا ہے۔ ہر آپریٹر کی ایک قسم اور ایک قیمت ضربی عنصر ہوتا ہے جو بنیادی سروس قیمت پر لاگو ہوتا ہے۔

پیرامیٹر	قسم	درکار	تفصیل
country	string	لازمی	ISO 3166-1 alpha-2 ملکی کوڈ

جواب

[ { "id": 5, "name": "T-Mobile", "type": "physical", "price_multiplier": "1.50", "icon_slug": "tmobile", "icon_domain": "t-mobile.com" } ]

آپریٹر کی اقسام: virtual — VoIP نمبرز، سب سے سستے، کچھ سروسز کی طرف سے بلاک ہو سکتے ہیں۔ physical — اصلی سِم کارڈز، کامیابی کی شرح زیادہ۔ premium — سب سے تیز ڈیلیوری (~10s)، کامیابی کی شرح سب سے زیادہ۔

نمبر خریدیں (SMS ایکٹیویشن)

POST /api.php?action=buy

ایک بار کی SMS تصدیق کے لیے ورچوئل نمبر خریدیں۔ نمبر 20 منٹ تک فعال رہتا ہے۔ اگر کوئی SMS موصول نہ ہو، تو آپ کا بیلنس خودکار طور پر واپس کر دیا جاتا ہے۔

پیرامیٹر	قسم	درکار	تفصیل
country	string	لازمی	ملکی کوڈ (مثلاً `us`)
service_id	integer	لازمی	List Services سے سروس ID
operator_id	integer	اختیاری	List Operators سے آپریٹر ID۔ ڈیفالٹ آپریٹر کے لیے چھوڑ دیں۔

cURL
Python
JavaScript
curl -X POST https://smsburner.com/api.php?action=buy \
  -b cookies.txt \
  -H "Content-Type: application/json" \
  -d '{"country":"us","service_id":12,"operator_id":5}'
resp = session.post("https://smsburner.com/api.php?action=buy", json={
    "country": "us",
    "service_id": 12,
    "operator_id": 5
})
order = resp.json()
print(f"Order #{order['order_id']} — ${order['price']}")
const resp = await fetch("https://smsburner.com/api.php?action=buy", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ country: "us", service_id: 12, operator_id: 5 })
});
const order = await resp.json();

کامیاب جواب

{ "success": true, "order_id": 1847, "price": 0.53, "balance": "73.97" }

خرابی: ناکافی بیلنس

{ "error": "Insufficient balance", "need": 0.53, "have": "0.10" }

آرڈرز کی فہرست

GET /api.php?action=orders

آپ کے 50 سب سے حالیہ آرڈرز واپس کرتا ہے، بشمول فون نمبر اور SMS کوڈز۔ فعال آرڈرز پر آنے والے SMS کوڈز چیک کرنے کے لیے اس اینڈ پوائنٹ کو پول کریں۔

جواب

[ { "id": 1847, "price": "0.53", "status": "completed", "phone_number": "+12025551234", "sms_code": "847293", "created_at": "2026-04-09 14:32:00", "country_code": "us", "country_name": "USA", "service_name": "WhatsApp", "operator_name": "T-Mobile" } ]

آرڈر کی حالتیں: active — ایس ایم ایس کا انتظار۔ completed — ایس ایم ایس موصول ہو گیا۔ cancelled — صارف کی طرف سے منسوخ۔ refunded — خودبخود رقم واپس (ٹائم آؤٹ سے پہلے کوئی ایس ایم ایس موصول نہیں ہوا)۔ expired — وقت ختم ہو گیا۔

کرایہ کی قیمت حاصل کریں

GET /api.php?action=rental_price&country={code}&operator_id={id}&duration={days}

کسی مخصوص آپریٹر سے مقررہ مدت کے لیے وقف نمبر کرائے پر لینے کی قیمت حاصل کریں۔

پیرامیٹر	قسم	درکار	تفصیل
country	string	لازمی	ملکی کوڈ
operator_id	integer	لازمی	آپریٹر آئی ڈی
duration	integer	لازمی	دنوں میں کرایہ مدت: `7`، `14`، `30` یا `90`

جواب

{ "price": "12.50", "duration": 30, "operator": "T-Mobile", "type": "physical", "country": "USA" }

نمبر کرائے پر لیں

POST /api.php?action=rental_buy

ایک یا زیادہ وقف شدہ فون نمبر کرائے پر لیں۔ نمبر پورے کرایہ مدت کے دوران خصوصی طور پر آپ کا ہوتا ہے اور لامحدود آنے والے SMS وصول کرتا ہے۔

پیرامیٹر	قسم	درکار	تفصیل
country	string	لازمی	ملکی کوڈ
operator_id	integer	لازمی	آپریٹر آئی ڈی
duration	integer	لازمی	`7`، `14`، `30`، یا `90` دن
qty	integer	اختیاری	کرائے پر لینے کے لیے نمبروں کی تعداد (1–10، ڈیفالٹ: 1)

کامیاب جواب

{ "success": true, "order_ids": [1848, 1849], "total": 25.00, "qty": 2, "unit_price": 12.50, "duration": 30, "balance": "49.50" }

صارف کی معلومات حاصل کریں

GET /api.php?action=user

موجودہ صارف کی اکاؤنٹ معلومات اور بیلنس واپس کرتا ہے۔ تصدیق کی حالت اور دستیاب رقم چیک کرنے کے لیے اسے استعمال کریں۔

تصدیق شدہ

{ "logged_in": true, "id": 42, "prefix": "AbC3", "balance": "74.50" }

غیر تصدیق شدہ

{ "logged_in": false }

مکمل ورک فلو مثال

یہ ایک مکمل Python مثال ہے جو تصدیق کرتی ہے، کوئی سروس تلاش کرتی ہے، نمبر خریدتی ہے، اور SMS کوڈ کے لیے پول کرتی ہے:

Python
import requests, time

BASE = "https://smsburner.com"
SEED = "AbC3-dEf4-gHj5-kLm6"

s = requests.Session()

# 1. Authenticate
s.post(f"{BASE}/auth-api.php", data={"action": "login", "seed": SEED})

# 2. Check balance
user = s.get(f"{BASE}/api.php?action=user").json()
print(f"Balance: ${user['balance']}")

# 3. Get services for USA
services = s.get(f"{BASE}/api.php?action=services&country=us").json()
whatsapp = next(svc for svc in services if svc["name"] == "WhatsApp")
print(f"WhatsApp: ${whatsapp['price']} ({whatsapp['stock']} in stock)")

# 4. Buy a number
order = s.post(f"{BASE}/api.php?action=buy", json={
    "country": "us",
    "service_id": whatsapp["id"]
}).json()
print(f"Order #{order['order_id']} created")

# 5. Poll for SMS code
for _ in range(60):
    orders = s.get(f"{BASE}/api.php?action=orders").json()
    my_order = next(o for o in orders if o["id"] == order["order_id"])

    if my_order["sms_code"]:
        print(f"SMS code: {my_order['sms_code']}")
        print(f"Phone:    {my_order['phone_number']}")
        break

    print("Waiting for SMS...")
    time.sleep(5)
else:
    print("Timeout — balance will be refunded automatically")

اکثر پوچھے گئے سوالات

میں SMSBurner SMS تصدیق API سے کیا کر سکتا ہوں؟

SMSBurner API ڈویلپرز کو ون ٹائم SMS ویریفیکیشن (OTP کوڈز) اور طویل مدتی نمبر کرائے (7، 14، 30 یا 90 دن) کے لیے 190+ ممالک میں ورچوئل فون نمبروں تک پروگرامی رسائی دیتا ہے۔ آپ سروسز کی فہرست بنا سکتے ہیں، لائیو قیمتوں کا استفسار کر سکتے ہیں، نمبر مختص کر سکتے ہیں، آنے والے SMS کوڈز حاصل کر سکتے ہیں، اور ناکام ایکٹیویشنز کی رقم واپس لے سکتے ہیں — یہ سب ایک JSON REST انٹرفیس پر، بغیر کسی KYC اور صرف کرپٹو بلنگ کے ساتھ۔

کیا API استعمال کرنے کے لیے مجھے API key یا OAuth token چاہیے؟

نہیں۔ SMSBurner API کوکی پر مبنی سیشن توثیق استعمال کرتا ہے: اپنے 16 حروف کے ایکسیس سیڈ کے ساتھ /auth-api.php پر ایک واحد POST درخواست بھیجیں، پھر ہر بعد کی کال پر واپس آنے والی سیشن کوکی دوبارہ استعمال کریں۔ کوئی API key فراہم کرنے، بدلنے یا منسوخ کرنے کی ضرورت نہیں — آپ فی سیشن ایک بار توثیق کرتے ہیں اور کوکی کی عمر تک توثیق شدہ رہتے ہیں۔

SMSBurner API استعمال کرنے کی قیمت کتنی ہے؟

API خود مفت ہے — کوئی ماہانہ فیس نہیں، کوئی سبسکرپشن نہیں، اور کوئی کم از کم درخواست حجم نہیں۔ آپ صرف فی نمبر ادائیگی کرتے ہیں: ون ٹائم SMS ایکٹیویشنز $0.05 سے شروع ہوتی ہیں اور وقف شدہ طویل مدتی کرائے 7 دنوں کے لیے $4.79 سے شروع ہوتے ہیں۔ ہر عمل آپ کے پیشگی ادا شدہ بیلنس سے بل کیا جاتا ہے، اور کوئی بھی ایکٹیویشن جو SMS وصول کرنے میں ناکام رہے، خودکار طور پر واپس کر دی جاتی ہے۔

کون سی پروگرامنگ زبانیں اور فریم ورکس سپورٹڈ ہیں؟

کوئی بھی زبان یا پلیٹ فارم جو HTTPS درخواستیں جاری کر سکے، API کو کال کر سکتا ہے — Python (requests، httpx)، Node.js (fetch، axios)، Go، PHP، Ruby، Java، C#، cURL کے ساتھ Bash، اور مزید۔ دستاویزات cURL، Python اور JavaScript میں چلانے کے لیے تیار مثالیں فراہم کرتی ہیں، اور /openapi.json پر ایک مکمل OpenAPI 3.0 تفصیل شائع کی گئی ہے تاکہ آپ اپنی پسند کی زبان میں ایک ٹائپڈ کلائنٹ خودکار طور پر تیار کر سکیں۔

اگر میرا SMS تصدیقی کوڈ کبھی نہ پہنچے تو کیا ہوگا؟

ہر ایکٹیویشن کے پاس 20 منٹ کی ڈیلیوری ونڈو ہوتی ہے۔ اگر اس ونڈو کے ختم ہونے سے پہلے کوئی SMS نہ پہنچے، تو آرڈر خودکار طور پر منسوخ کر دیا جاتا ہے اور مکمل قیمت آپ کے اکاؤنٹ بیلنس میں واپس کر دی جاتی ہے — کوئی سپورٹ ٹکٹ نہیں، کوئی دستی دوبارہ کوشش نہیں۔ آپ فوراً واپس کیا گیا بیلنس ایک اور نمبر مختص کرنے کے لیے استعمال کر سکتے ہیں، اختیاری طور پر ایک مختلف آپریٹر ٹیئر (ورچوئل، فزیکل یا پریمیم) پر تاکہ ڈیلیوری کی زیادہ کامیابی ملے۔

کیا SMSBurner API پر ریٹ لمٹس ہیں؟

توثیق کی شرح فی IP ہر 15 منٹ میں 5 کوششوں تک محدود ہے، جو بروٹ-فورس سیڈ گنتی سے حفاظت کرتی ہے۔ باقی تمام اینڈ پوائنٹس — کیٹلاگ، خریداری، آرڈرز، کرائے — کی فی الحال کوئی سخت شرح حد نہیں ہے، لیکن ہم درخواست کرتے ہیں کہ آپ درخواستوں کے وقفے معقول رکھیں: SMS حاصل کرنے کے لیے ہر 3–5 سیکنڈ میں /api.php?action=orders کو پول کرنا کافی ہے، اور ~10 req/s سے اوپر مسلسل بھرمار WAF لیئر پر تھروٹل کی جا سکتی ہے۔