SMS وصولی کا API

ایک JSON API کے ذریعے نمبر خریدیے اور تصدیقی کوڈ پڑھیے۔ شناخت کی جانچ کے بغیر، ادائیگی کرپٹو کرنسی میں۔

REST · JSONOpenAPI 3.1 OpenAPI تفصیل →

یہاں کی ہر کارروائی ایک MCP ٹول بھی ہے۔ REST اینڈ پوائنٹس انہی ٹولز کا ترجمہ ہیں جو MCP سرور پیش کرتا ہے: یعنی کوئی خودمختار ایجنٹ اور کوئی عام انضمام بالکل ایک جیسا برتاؤ کرتے ہیں۔ اگر آپ کسی AI ایجنٹ کو OTPDrop کی طرف بھیج رہے ہیں تو ایجنٹس کے حصے سے شروع کیجیے۔

API کس طرح ترتیب دیا گیا ہے؟

  1. اکاؤنٹ بنائیے اور واپس ملنے والا جملہ محفوظ رکھیے۔ یہی واحد رسائی ہے، اور اسے دوبارہ مقرر نہیں کیا جا سکتا۔
  2. رقم ڈالنے کا عمل بنائیے، کرپٹو کرنسی بھیجیے اور جمع ہونے کا انتظار کیجیے۔
  3. مطلوبہ سروس اور ملک کے لیے نمبر خریدیے — بیلنس فوراً کٹ جاتا ہے۔
  4. کوڈ والا 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بن گیا — اکاؤنٹ، جمع یا آرڈر اب موجود ہے
401Authorization ہیڈر میں جملہ غائب یا غلط ہے
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.

پیرامیٹر

نامقسمتفصیل
limitintegerاختیاری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.

پیرامیٹر

نامقسمتفصیل
servicestringلازمیService code, e.g. telegram
countrystringلازمی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_usdnumberلازمیHow much to add to the balance, in USD. Minimum 25, maximum 1000.
coinstringلازمی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.

پیرامیٹر

نامقسمتفصیل
idstringلازمی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.

پیرامیٹر

نامقسمتفصیل
servicestringلازمیService code, e.g. telegram
countrystringلازمی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.

پیرامیٹر

نامقسمتفصیل
idstringلازمی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.

پیرامیٹر

نامقسمتفصیل
idstringلازمی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 بغیر کچھ خرچ کیے آزمایا جا سکتا ہے؟

کیٹلاگ، قیمت کا حساب اور اکاؤنٹ بنانا مفت ہیں: یعنی انضمام کا بیشتر حصہ رقم ڈالنے سے پہلے ہی لکھا اور جانچا جا سکتا ہے۔ پیسے صرف خریداری پر لگتے ہیں۔