API توسعهدهندگان
تأیید پیامکی مستقیم از کد شما
یک فراخوانی HTTPS به ربات یا پلتفرم شما یک شمارهٔ واقعی برای واتساپ، تلگرام و بسیاری سرویسهای دیگر میدهد. کد را با وبهوک یا long polling بگیرید و فقط برای شمارههایی که کد دریافت کردهاند بپردازید.
- ۱٬۳۲۱سرویس
- ۱۴۵کشور
- $۰٫۱۰کمترین قیمت هر شماره
- خودکاربازپرداخت اگر کدی نرسد
curl
curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
-H "Authorization: Bearer $SMSGRAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service":"whatsapp","country":"indonesia"}'Python
activation = requests.post(
"https://smsgrab.com/api/dev/v1/activations",
headers={"Authorization": f"Bearer {key}"},
json={"service": "whatsapp", "country": "indonesia"},
).json()Node.js
const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
method: 'POST',
headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());PHP
$activation = json_decode((string) $client->post('activations', [
'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
])->getBody(), true);Go
order := map[string]any{"service": "whatsapp", "country": "indonesia"}
err := call("POST", "/activations", order, idempotencyKey(), &activation){
"id": "5c1d0c2e-9f3a-4b7e-8a61-2f0c9d4e7b10",
"compat_id": 100000123,
"status": "WAITING_SMS",
"service_id": "whatsapp",
"country_id": "indonesia",
"phone_number": "+6281234567890",
"price_minor": 18,
"currency": "USD",
"expires_at": "2026-09-27T10:25:00.000Z",
"sms": []
}ساختهشده برای خودکارسازی
هر آنچه یکپارچهسازی شما لازم دارد، با همان موجودی شماره، حسابداری و بازپرداختهای اپ.
-
REST API ساده
JSON قابل پیشبینی، خریدهای idempotent و دلایل خطای روشن که میتوانید بر اساسشان عمل کنید.
-
وبهوکهای امضاشده
رویدادهای امضاشده با HMAC برای هر کد و تغییر وضعیت، با تلاش دوباره تا ۲۴ ساعت.
-
Long polling
درخواست را تا ۳۰ ثانیه باز نگه دارید و کد را همان لحظهٔ رسیدن بگیرید.
-
سازگار با sms-activate
ابزارهای فعلی خود را به نشانی ما هدایت کنید. اقدامها و پاسخها همان میمانند.
-
کلیدهایی در کنترل شما
کلید فقطخواندنی یا خرید، فهرست IP مجاز، سقف روزانه، انقضا و تعویض بدون توقف.
-
بازپرداخت خودکار
کد پیش از پایان اعتبار شماره نرسید؟ مبلغ فوراً به موجودی شما بازمیگردد.
-
مصرف و گزارش درخواست
درخواستها، هزینه و خطاهای روزانه برای هر کلید، بهعلاوهٔ گزارش قابل فیلتر ۷ روز گذشته.
-
قیمت حجمی
قیمتگذاری بر پایهٔ عمده که با رشد حجم ماهانهٔ شما خودکار کاهش مییابد.
در چهار قدم شروع کنید
فقط چند فراخوانی تا اولین شماره فاصله دارید.
-
حساب بسازید
با ایمیل ثبتنام و آن را تأیید کنید. اپ و وبسایت از یک حساب استفاده میکنند.
-
کلید API بسازید
دسترسی را انتخاب کنید، کلید را به سرورهایتان محدود کنید و رمز را یک بار کپی کنید.
-
شماره بخرید
سرویس و کشور را با POST بفرستید. شماره و قیمت فوراً برمیگردند.
-
کد را بگیرید
با long polling یا وبهوک منتظر آن بمانید، سپس فعالسازی را پایان دهید.
قیمتی که با رشد شما کاهش مییابد
قیمت توسعهدهنده از هزینهٔ عمدهٔ هر شماره بهعلاوهٔ افزایشی شروع میشود که با حجم ۳۰ روزهٔ شما کم میشود.
- هرگز گرانتر از همان شماره در اپ نیست
- دستکم $۰٫۱۰ برای هر شماره
- شمارههایی که کد نگیرند خودکار بازپرداخت میشوند
- سطح شما چند دقیقه پس از رسیدن بهروز میشود
- به دلار از همان موجودی اپ کسر میشود
افزایش بر اساس هزینهٔ ۳۰ روزهٔ توسعهدهنده
| هزینهٔ توسعهدهنده در ۳۰ روز | افزایش روی قیمت عمده | قیمت نمونه |
|---|---|---|
| تا $۱۰۰٫۰۰ | +۸۰٪ | $۰٫۱۸ ۲۸٪ ارزانتر از اپ |
| از $۱۰۰٫۰۰ | +۷۰٪ | $۰٫۱۷ ۳۲٪ ارزانتر از اپ |
| از $۵۰۰٫۰۰ | +۶۰٪ | $۰٫۱۶ ۳۶٪ ارزانتر از اپ |
| از $۲٬۰۰۰٫۰۰ | +۵۰٪ | $۰٫۱۵ ۴۰٪ ارزانتر از اپ |
مثال: پیشنهادی با هزینهٔ عمدهٔ $۰٫۱۰ که در اپ $۰٫۲۵ فروخته میشود.
مهاجرت
با یک خط از sms-activate مهاجرت کنید
نشانی سازگار ما همان پروتکل را دارد، پس رباتها و پنلهای ساختهشده برای sms-activate با تغییر نشانی پایه و کلید کار میکنند.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber، getStatus، setStatus، getPrices و دیگر اقدامهای استاندارد
- شناسههای عددی فعالسازی، کد سرویسها و شناسهٔ کشورهایی که از قبل استفاده میکنید
- همان کلیدها، محدودیتها، قیمتها، بازپرداختها و وبهوکهای REST API
curl
BASE="https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_API_KEY"
curl -s "$BASE&action=getBalance"
curl -s "$BASE&action=getNumber&service=tg&country=6"
curl -s "$BASE&action=getStatus&id=100000123"
curl -s "$BASE&action=setStatus&id=100000123&status=6"Python
import os
import requests
BASE = "https://smsgrab.com/api/stubs/handler_api.php"
KEY = os.environ["SMSGRAB_API_KEY"]
def action(name: str, **params) -> str:
response = requests.get(BASE, params={"api_key": KEY, "action": name, **params}, timeout=30)
response.raise_for_status()
return response.text
print(action("getBalance"))
answer = action("getNumber", service="tg", country=6)
if answer.startswith("ACCESS_NUMBER:"):
_, activation_id, number = answer.split(":")
print(activation_id, number)بیدرنگ
کدها مستقیم به سرور شما میرسند
در رویدادهای مورد نظر مشترک شوید تا آنها را با امضایی قابل بررسی به نشانی HTTPS شما تحویل دهیم.
- شماره خریداری شد
- کد دریافت شد
- فعالسازی کامل شد
- فعالسازی لغو شد
- فعالسازی منقضی شد
- بازپرداخت شد
- موجودی کم است
- هر تحویل با HMAC-SHA256 و مهر زمانی امضا میشود
- فقط نشانیهای HTTPS عمومی، با بررسی پیش از هر تحویل
- تحویل آزمایشی، سابقهٔ ۳۰ روزه و تحویل دوباره با یک کلیک
پرسشهای توسعهدهندگان
API توسعهدهندگان چقدر هزینه دارد؟
اشتراکی در کار نیست. هر شماره قیمت عمده بهعلاوهٔ ۸۰٪ افزایش است که وقتی هزینهٔ ۳۰ روزهٔ شما از ۱۰۰، ۵۰۰ و ۲۰۰۰ دلار بگذرد به ۷۰٪، ۶۰٪ و ۵۰٪ کاهش مییابد. هیچ شمارهای کمتر از ۰٫۱۰ دلار یا بیشتر از قیمت اپ نیست.
اگر کد نرسد چه میشود؟
شماره ۲۰ دقیقه فعال است. اگر در این مدت کدی نرسد، یا شماره را در حالت انتظار لغو کنید، مبلغ خودکار به موجودی شما بازمیگردد.
آیا میتوانم از یکپارچهسازی sms-activate خود استفاده کنم؟
بله. نشانی پایه را به نشانی سازگار ما تغییر دهید و از کلید SmsGrab استفاده کنید. اقدامهای استاندارد، پاسخها و شناسههای عددی همان میمانند.
محدودیتهای نرخ چیست؟
بهطور پیشفرض هر کلید میتواند در دقیقه ۶۰۰ درخواست و ۶۰ خرید انجام دهد، همهٔ کلیدهای یک حساب رویهم ۳۰۰۰ درخواست در دقیقه، و تا ۱۰۰ شماره میتوانند همزمان منتظر کد باشند.
چگونه از کلیدم محافظت کنم؟
کلیدها را فقط روی سرور نگه دارید، به هر اپ کلید جدا بدهید، آن را به نشانی سرورها محدود کنید و سقف هزینهٔ روزانه بگذارید. اگر کلیدی ممکن است لو رفته باشد، از حساب خود تعویض یا باطلش کنید.
آیا اپ و API موجودی مشترک دارند؟
بله. API از موجودی حساب SmsGrab شما استفاده میکند و هر خرید و بازپرداخت مانند بقیه در کیف پول شما نمایش داده میشود.
پاسخهای بیشتر در مرکز راهنما