API دریافت پیامک

با یک API از نوع JSON شماره بخرید و کدهای تأیید را بخوانید. بدون بررسی هویت، پرداخت با ارز دیجیتال.

REST · JSONOpenAPI 3.1 مشخصات OpenAPI →

API چگونه سازمان یافته است؟

1. یک حساب بسازید و عبارت بازگشتی را نگه دارید. تنها دسترسی همین است و بازنشانی‌شدنی نیست.
2. یک شارژ بسازید، ارز دیجیتال را بفرستید و منتظر افزوده شدن آن بمانید.
3. برای سرویس و کشور دلخواه یک شماره بخرید — موجودی بی‌درنگ کسر می‌شود.
4. پیامک حاوی کد را استعلام کنید. اگر تا پایان اعتبار سفارش کدی نرسد، پول خودکار بازپرداخت می‌شود.

یک بار شارژ کنید، بارها بخرید: یک شارژ به اندازه‌ای که موجودی اجازه دهد شماره را پوشش می‌دهد، پس تنها نخستین خرید در انتظار یک تأیید می‌ماند.

احراز هویت

عبارت حساب را به‌عنوان توکن 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\""
  }
}

پیام‌های پرتکرار در 422:

آیا محدودیت نرخ وجود دارد؟

هیچ سهمیه‌ای منتشر نشده و هیچ کلید APIای برای خفه کردن وجود ندارد — ولی فراخوانی حلقه‌وار نقاط پایانی رایگان نیست. دو تای آن‌ها برای استعلام حلقه‌وار ساخته شده‌اند و توجه ویژه می‌خواهند.

ترافیکی که به حمله شبیه باشد در بالادست مسدود می‌شود، بدون یک 429 مؤدبانه. اگر دلیل موجهی برای استعلام پرتکرارتر دارید، نخست از راه صفحهٔ تماس به ما بنویسید.

یک یکپارچه‌سازی کامل چه شکلی است؟

از حساب تا کد، شش فراخوان. هر آنچه در پی می‌آید واقعی است: بچسبانید و اجرا کنید.

# 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، بدون shell:

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

همان عملیات از راه Model Context Protocol روی https://www.otpdrop.com/mcp و در قالب یازده ابزار در دسترس‌اند. برای افزودن آن به Claude Code:

claude mcp add --transport http otpdrop https://www.otpdrop.com/mcp

پیکربندی و فهرست کامل ابزارها در صفحهٔ عامل‌ها آمده است.

فایل‌های کشف

توصیف‌های ماشین‌خوان سرویس، همه بدون احراز هویت ارائه می‌شوند.

پرسش‌های متداول

آیا برای API در OTPDrop کلید لازم است؟

خیر. چیزی برای درخواست کردن نیست و هیچ بررسی‌ای در کار نیست. شناسه همان عبارت حساب است که به‌عنوان توکن bearer فرستاده می‌شود — و نقاط پایانی فهرست حتی به آن هم نیازی ندارند.

API در OTPDrop چقدر هزینه دارد؟

فراتر از خودِ شماره‌ها هیچ. نه اشتراکی، نه صورت‌حسابی به‌ازای هر فراخوان، نه کمینهٔ حجمی — قیمت‌ها همان قیمت‌های سایت‌اند.

این API با چه زبان‌های برنامه‌نویسی کار می‌کند؟

هر زبانی که بتواند یک درخواست HTTPS بفرستد. این JSON معمولی روی HTTP با یک سرآیند bearer است: نه SDKای برای نصب، نه چیزی برای هماهنگ نگه داشتن با نسخه‌های ما.

اگر پیامک نرسد چه می‌شود؟

سفارش در پایان اعتبارش خودبه‌خود به موجودی بازپرداخت می‌شود؛ می‌توانید زودتر هم از سایت لغوش کنید. شما بهای کدهای تحویل‌شده را می‌پردازید، نه بهای تلاش‌ها.

آیا API از نوع REST و سرور MCP یک چیزند؟

بله، عمداً. هر نقطهٔ پایانی REST ترجمهٔ یک فراخوان ابزار MCP است، پس نمی‌توانند واگرا شوند: تغییر یکی یعنی تغییر دیگری. آن را برگزینید که با کلاینت شما بهتر می‌خواند.

آیا می‌توان API را بدون خرج کردن آزمود؟

فهرست، محاسبهٔ قیمت و ساخت حساب رایگان‌اند: پس بخش عمدهٔ یک یکپارچه‌سازی را می‌توان پیش از هر شارژی نوشت و آزمود. تنها خرید است که پول می‌برد.