SMS وصولی کا API
ایک JSON API کے ذریعے نمبر خریدیے اور تصدیقی کوڈ پڑھیے۔ شناخت کی جانچ کے بغیر، ادائیگی کرپٹو کرنسی میں۔
API کس طرح ترتیب دیا گیا ہے؟
- اکاؤنٹ بنائیے اور واپس ملنے والا جملہ محفوظ رکھیے۔ یہی واحد رسائی ہے، اور اسے دوبارہ مقرر نہیں کیا جا سکتا۔
- رقم ڈالنے کا عمل بنائیے، کرپٹو کرنسی بھیجیے اور جمع ہونے کا انتظار کیجیے۔
- مطلوبہ سروس اور ملک کے لیے نمبر خریدیے — بیلنس فوراً کٹ جاتا ہے۔
- کوڈ والا SMS طلب کیجیے۔ اگر آرڈر کی میعاد ختم ہونے تک کوئی کوڈ نہ آئے تو رقم خود بخود واپس کر دی جاتی ہے۔
ایک بار رقم ڈالیے، بار بار خریدیے: ایک بار ڈالی گئی رقم اتنے نمبروں کے لیے کافی ہے جتنے بیلنس اجازت دے، اس لیے صرف پہلی خریداری کسی تصدیق کا انتظار کرتی ہے۔
توثیق
اکاؤنٹ کا جملہ bearer ٹوکن کے طور پر بھیجیے۔ نہ کوئی الگ API کلید ہے، نہ لاگ اِن کی کوئی کال — جملہ ہی شناخت ہے۔
Authorization: Bearer YOUR-SEED-PHRASE
کیٹلاگ کے اینڈ پوائنٹس کوئی توثیق نہیں مانگتے: سروسز، ممالک اور قیمتیں اکاؤنٹ بنائے بغیر بھی دیکھی جا سکتی ہیں۔ پیسوں اور آرڈروں سے متعلق ہر چیز کے لیے یہ ہیڈر لازمی ہے۔
بنیادی پتہ
تمام اینڈ پوائنٹس اس کے نسبت سے ہیں:
https://www.otpdrop.com/api/v1
جواب JSON میں آتے ہیں۔ POST کے متن application/json یا
application/x-www-form-urlencoded میں قبول کیے جاتے ہیں۔
خامیاں
ناکامی کی صورت میں 2xx سے باہر کا کوئی اسٹیٹس اور ایک ہی خامی کا آبجیکٹ واپس آتا ہے۔
{
"error": {
"code": "invalid_request",
"message": "unknown service: \"whatsap\""
}
}
| اسٹیٹس | مطلب |
|---|---|
200 | کامیابی |
201 | بن گیا — اکاؤنٹ، جمع یا آرڈر اب موجود ہے |
401 | Authorization ہیڈر میں جملہ غائب یا غلط ہے |
422 | درخواست سمجھ آ گئی، مگر اس پر عمل ممکن نہیں |
500 | ہماری طرف کی خرابی |
422 کے عام پیغامات:
| پیغام | وجہ |
|---|---|
insufficient_funds | بیلنس قیمت سے کم ہے — پہلے رقم ڈالیے |
unknown service | یہ سروس کوڈ موجود نہیں؛ سروسز کی فہرست دیکھیے |
unknown country | یہ ملکی کوڈ موجود نہیں؛ ممالک کی فہرست دیکھیے |
unknown coin | یہ کرنسی قبول نہیں؛ رقم ڈالنے کا اینڈ پوائنٹ دیکھیے |
amount_usd must be between… | رقم ڈالنے کی حد $25–$1000 ہے |
کیا درخواستوں کی کوئی حد ہے؟
کوئی کوٹا شائع نہیں کیا گیا، اور روکنے کے لیے کوئی API کلید بھی نہیں — مگر اینڈ پوائنٹس کو لگاتار پکارنا مفت نہیں۔ ان میں سے دو ہی بار بار پوچھنے کے لیے بنے ہیں اور خاص توجہ مانگتے ہیں۔
| اینڈ پوائنٹ | معقول رفتار | کیوں |
|---|---|---|
| کیٹلاگ اور قیمت کا حساب | انہیں اپنے ہاں محفوظ رکھیے | قیمتیں کم ہی بدلتی ہیں؛ ہر درخواست پر کیٹلاگ دوبارہ لینے کا کوئی فائدہ نہیں۔ |
/topups/{id} | ہر 10 سے 15 سیکنڈ بعد | نیٹ ورک کی تصدیق میں منٹ لگتے ہیں، ملی سیکنڈ نہیں۔ زیادہ بار پوچھنے سے کچھ پہلے معلوم نہیں ہوتا۔ |
/orders/{id}/sms | ہر 3 سے 5 سیکنڈ بعد | کوڈ عموماً چند سیکنڈ میں آ جاتے ہیں؛ اس سے تنگ چکر صرف بوجھ بڑھاتا ہے۔ |
| خریداری | ضرورت کے مطابق | ہر خریداری اصل رقم کاٹتی ہے، اس لیے بے لگام چکر ہمارے مقابلے میں آپ کو زیادہ مہنگا پڑے گا۔ |
جو ٹریفک کسی حملے جیسا لگے وہ اوپر ہی روک دیا جائے گا، بغیر کسی مہذب 429 کے۔ اگر
آپ کے پاس زیادہ بار پوچھنے کی کوئی جائز وجہ ہو تو پہلے رابطے کے صفحے سے
ہمیں لکھیے۔
سروسز کی فہرست
GET/api/v1/services
تمام سروسز، ان کے کوڈ، زمرے اور کم سے کم قیمت کے ساتھ۔ کوئی توثیق درکار نہیں۔
درخواست
curl -s https://www.otpdrop.com/api/v1/services
جواب
{
"services": [
{
"code": "binance",
"name": "Binance",
"category": "Finance",
"from_price_cents": 85,
"color": "#F0B90B",
"icon": "binance"
}
],
"count": 133
}
ممالک کی فہرست
GET/api/v1/countries
Every country with its dial code and how many services are available there. No authentication required.
درخواست
curl -s https://www.otpdrop.com/api/v1/countries
جواب
{
"countries": [
{
"code": "us",
"name": "United States",
"dial_code": "+1",
"service_count": 133
}
],
"count": 197
}
قیمتوں کی جدول
GET/api/v1/catalog
The most useful service and country combinations with their prices, cheapest first. No authentication required.
پیرامیٹر
| نام | قسم | تفصیل | |
|---|---|---|---|
limit | integer | اختیاری | How many rows to return, 1 to 500. Defaults to 12. |
درخواست
curl -s 'https://www.otpdrop.com/api/v1/catalog?limit=2'
جواب
{
"items": [
{
"service": "badoo",
"country": "us",
"price_cents": 35
}
],
"count": 2
}
قیمت کا حساب
GET/api/v1/quote
The exact price for one service and country before you commit to buying. No authentication required.
پیرامیٹر
| نام | قسم | تفصیل | |
|---|---|---|---|
service | string | لازمی | Service code, e.g. telegram |
country | string | لازمی | Country code, e.g. us |
درخواست
curl -s 'https://www.otpdrop.com/api/v1/quote?service=telegram&country=us'
جواب
{
"service": "telegram",
"country": "us",
"price_cents": 111,
"price_usd": "1.11",
"currency": "USD",
"purchasable": true
}
اکاؤنٹ بنائیے
POST/api/v1/accounts
Generates an account and returns its seed. This is the only time the seed is ever shown. No authentication required.
درخواست
curl -s -X POST https://www.otpdrop.com/api/v1/accounts
جواب
{
"public_id": "acc_7f3c1a92",
"seed": "PABh-ZbRt-9xKm-Lq4V",
"seed_prefix": "PABh",
"balance_cents": 0,
"warning": "This seed is shown exactly once, right now..."
}
رقم ڈالنے کا عمل بنائیے
POST/api/v1/topups
Claims a deposit address and returns the exact amount to send, as coin_amount, at the rate in rate_usd. Each top-up gets its own address, and it expires at expires_at. Send only the named coin, on the named network, before then.
پیرامیٹر
| نام | قسم | تفصیل | |
|---|---|---|---|
amount_usd | number | لازمی | How much to add to the balance, in USD. Minimum 25, maximum 1000. |
coin | string | لازمی | BTC, LTC, ETH, XMR, SOL, TRX, BNB, USDT, USDC and more |
درخواست
curl -s -X POST https://www.otpdrop.com/api/v1/topups \
-H 'Authorization: Bearer YOUR-SEED' \
-H 'content-type: application/json' \
-d '{"amount_usd": 25, "coin": "XMR"}'
جواب
{
"topup_id": "top_019195919c80fc8f",
"status": "awaiting_payment",
"coin": "XMR",
"address": "89Rm4XN39m9PCr8Sr3yAFnXvLRRWQVEE...",
"amount_cents": 2500,
"amount_usd": "25.00",
"coin_amount": "0.1337",
"rate_usd": 187.02,
"bonus_cents": 0,
"credited_total_cents": 2500,
"expires_at": 1788532810
}
رقم ڈالنے کی حالت
GET/api/v1/topups/{id}
Whether a deposit has been credited. Confirmation is not instant — poll this rather than assuming the funds arrived.
پیرامیٹر
| نام | قسم | تفصیل | |
|---|---|---|---|
id | string | لازمی | The top-up id, in the path |
درخواست
curl -s https://www.otpdrop.com/api/v1/topups/top_019195919c80fc8f \ -H 'Authorization: Bearer YOUR-SEED'
جواب
{
"topup_id": "top_019195919c80fc8f",
"status": "credited",
"coin": "XMR",
"amount_usd": "25.00",
"coin_amount": "0.1337",
"credited_total_cents": 2500,
"expires_at": 1788532810
}
نمبر خریدیے
POST/api/v1/orders
Debits the balance and issues a number immediately. There is no per-purchase address and no second wait. Fails with insufficient_funds if the balance is short.
پیرامیٹر
| نام | قسم | تفصیل | |
|---|---|---|---|
service | string | لازمی | Service code, e.g. telegram |
country | string | لازمی | Country code, e.g. us |
درخواست
curl -s -X POST https://www.otpdrop.com/api/v1/orders \
-H 'Authorization: Bearer YOUR-SEED' \
-H 'content-type: application/json' \
-d '{"service": "telegram", "country": "us"}'
جواب
{
"order_id": "ord_1ad450bf7a42519c",
"service": "telegram",
"country": "us",
"phone": "+15558329008",
"status": "paid",
"price_usd": "1.11"
}
اپنے آرڈروں کی فہرست
GET/api/v1/orders
Every order on the account, newest first, with status, number and price. Useful for reconciling state after a restart rather than for polling.
درخواست
curl -s https://www.otpdrop.com/api/v1/orders \ -H 'Authorization: Bearer YOUR-SEED'
جواب
{
"orders": [
{
"order_id": "ord_1ad450bf7a42519c",
"service": "telegram",
"country": "us",
"phone": "+15558329008",
"status": "paid",
"price_usd": "1.11"
}
],
"count": 1
}
کوئی آرڈر دیکھیے
GET/api/v1/orders/{id}
The current state of one order: its number, status and price.
پیرامیٹر
| نام | قسم | تفصیل | |
|---|---|---|---|
id | string | لازمی | The order id, in the path |
درخواست
curl -s https://www.otpdrop.com/api/v1/orders/ord_1ad450bf7a42519c \ -H 'Authorization: Bearer YOUR-SEED'
جواب
{
"order_id": "ord_1ad450bf7a42519c",
"service": "telegram",
"country": "us",
"phone": "+15558329008",
"status": "paid",
"price_usd": "1.11"
}
کوڈ والا SMS حاصل کیجیے
GET/api/v1/orders/{id}/sms
Poll this until arrived turns true. If the order expires with nothing delivered, the price returns to your balance automatically.
پیرامیٹر
| نام | قسم | تفصیل | |
|---|---|---|---|
id | string | لازمی | The order id, in the path |
درخواست
curl -s https://www.otpdrop.com/api/v1/orders/ord_1ad450bf7a42519c/sms \ -H 'Authorization: Bearer YOUR-SEED'
جواب
{
"order_id": "ord_1ad450bf7a42519c",
"status": "paid",
"arrived": false,
"code": null
}
مکمل انضمام کیسا دکھتا ہے؟
اکاؤنٹ سے کوڈ تک، چھ کالیں۔ آگے جو کچھ ہے وہ اصل ہے: نقل کر کے چلا لیجیے۔
# 1. اکاؤنٹ بنائیے اور جملہ محفوظ رکھیے
SEED=$(curl -s -X POST https://www.otpdrop.com/api/v1/accounts | jq -r .seed)
# 2. رقم ڈالیے — coin_amount واپس ملنے والے پتے پر بھیجیے
curl -s -X POST https://www.otpdrop.com/api/v1/topups \
-H "Authorization: Bearer \$SEED" \
-H 'content-type: application/json' \
-d '{"amount_usd": 25, "coin": "USDT"}'
# 3. رقم جمع ہونے تک پوچھتے رہیے
curl -s https://www.otpdrop.com/api/v1/topups/TOPUP_ID \
-H "Authorization: Bearer \$SEED" | jq .status
# 4. خریدنے سے پہلے قیمت جانچ لیجیے
curl -s 'https://www.otpdrop.com/api/v1/quote?service=telegram&country=us'
# 5. خریدیے — بیلنس کٹتا ہے، نمبر فوراً مل جاتا ہے
ORDER=$(curl -s -X POST https://www.otpdrop.com/api/v1/orders \
-H "Authorization: Bearer \$SEED" \
-H 'content-type: application/json' \
-d '{"service": "telegram", "country": "us"}' | jq -r .order_id)
# 6. کوڈ کے لیے پوچھتے رہیے
until curl -s https://www.otpdrop.com/api/v1/orders/\$ORDER/sms \
-H "Authorization: Bearer \$SEED" | jq -e .code; do sleep 4; done
یہی ترتیب Python میں، شیل کے بغیر:
import time, requests
API = "https://www.otpdrop.com/api/v1"
seed = requests.post(f"{API}/accounts").json()["seed"]
auth = {"Authorization": f"Bearer {seed}"}
topup = requests.post(f"{API}/topups", headers=auth,
json={"amount_usd": 25, "coin": "USDT"}).json()
print("send", topup["coin_amount"], topup["coin"], "to", topup["address"])
while requests.get(f"{API}/topups/{topup['topup_id']}",
headers=auth).json()["status"] != "credited":
time.sleep(15)
order = requests.post(f"{API}/orders", headers=auth,
json={"service": "telegram", "country": "us"}).json()
print("number:", order["phone"])
while True:
sms = requests.get(f"{API}/orders/{order['order_id']}/sms",
headers=auth).json()
if sms["arrived"]:
print("code:", sms["code"])
break
time.sleep(4)
MCP سرور
یہی کارروائیاں https://www.otpdrop.com/mcp پر Model Context Protocol کے ذریعے بھی دستیاب ہیں، گیارہ
ٹولز کی صورت میں۔ اسے Claude Code میں شامل کرنے کے لیے:
claude mcp add --transport http otpdrop https://www.otpdrop.com/mcp
ترتیب اور ٹولز کی مکمل فہرست ایجنٹس کے صفحے پر موجود ہے۔
دریافتی فائلیں
سروس کی مشین کے پڑھنے کے قابل تفصیلات، سب توثیق کے بغیر فراہم ہوتی ہیں۔
| فائل | مواد |
|---|---|
/openapi.json | مکمل OpenAPI 3.1 خاکہ |
/.well-known/agent.json | صلاحیتیں، توثیق کا نمونہ اور کام کے قواعد |
/llms.txt | زبان کے ماڈلز کے لیے ایک مختصر رہنما |
/llms-full.txt | وہی، مکمل کیٹلاگ سمیت |
اکثر پوچھے گئے سوالات
کیا OTPDrop کے API کے لیے کوئی کلید درکار ہے؟
نہیں۔ نہ کچھ مانگنا ہے، نہ کوئی منظوری۔ شناخت اکاؤنٹ کا جملہ ہے، جو bearer ٹوکن کے طور پر بھیجا جاتا ہے — اور کیٹلاگ کے اینڈ پوائنٹس کو تو اس کی بھی ضرورت نہیں۔
OTPDrop کا API کتنے کا ہے؟
خود نمبروں کے سوا کچھ نہیں۔ نہ سبسکرپشن، نہ فی درخواست بل، نہ کوئی کم سے کم حجم — قیمتیں وہی ہیں جو سائٹ پر ہیں۔
یہ API کن پروگرامنگ زبانوں کے ساتھ چلتا ہے؟
ہر اُس زبان کے ساتھ جو HTTPS درخواست بھیج سکے۔ یہ HTTP پر عام JSON ہے اور ایک bearer ہیڈر: نہ کوئی SDK نصب کرنا ہے، نہ ہمارے نسخوں کے ساتھ کچھ ہم آہنگ رکھنا ہے۔
اگر SMS نہ آئے تو کیا ہوتا ہے؟
آرڈر کی میعاد ختم ہونے پر اس کی رقم خود بخود بیلنس میں واپس آ جاتی ہے؛ آپ اسے سائٹ سے پہلے بھی منسوخ کر سکتے ہیں۔ آپ موصول شدہ کوڈوں کے پیسے دیتے ہیں، کوششوں کے نہیں۔
کیا REST API اور MCP سرور ایک ہی چیز ہیں؟
جی ہاں، جان بوجھ کر۔ ہر REST اینڈ پوائنٹ کسی MCP ٹول کال کا ترجمہ ہے، اس لیے دونوں الگ سمت نہیں جا سکتے: ایک کو بدلنا دوسرے کو بدلنا ہے۔ جو آپ کے کلائنٹ کے لیے زیادہ موزوں ہو وہی منتخب کیجیے۔
کیا API بغیر کچھ خرچ کیے آزمایا جا سکتا ہے؟
کیٹلاگ، قیمت کا حساب اور اکاؤنٹ بنانا مفت ہیں: یعنی انضمام کا بیشتر حصہ رقم ڈالنے سے پہلے ہی لکھا اور جانچا جا سکتا ہے۔ پیسے صرف خریداری پر لگتے ہیں۔