API توسعهدهندگان
تأیید پیامکی مستقیم از کد شما
یک فراخوانی HTTPS به ربات یا پلتفرم شما یک شمارهٔ واقعی برای واتساپ، تلگرام و بسیاری سرویسهای دیگر میدهد. کد را با وبهوک یا long polling بگیرید و فقط برای شمارههایی که کد دریافت کردهاند بپردازید.
- ۲٬۲۸۱سرویس
- ۲۰۰کشور
- خودکاربازپرداخت اگر کدی نرسد
curl
curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
-H "Authorization: Bearer $SMSGRAB_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-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}", "Idempotency-Key": str(uuid.uuid4())},
json={"service": "whatsapp", "country": "indonesia"},
timeout=30,
).json()
Node.js
const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
method: 'POST',
headers: {
Authorization: `Bearer ${key}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());
PHP
$activation = json_decode((string) $client->post('activations', [
'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
'headers' => ['Idempotency-Key' => bin2hex(random_bytes(16))],
])->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": 17,
"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 یا وبهوک منتظر آن بمانید، سپس فعالسازی را پایان دهید.
قیمتی که با رشد شما کاهش مییابد
API همان قیمتهای اپ را حساب میکند. تخفیف عمدهٔ شما با هزینهٔ ۳۰ روز گذشته در همهٔ کانالها بیشتر میشود.
- هرگز گرانتر از همان شماره در اپ نیست
- شمارههایی که کد نگیرند خودکار بازپرداخت میشوند
- سطح شما چند دقیقه پس از رسیدن بهروز میشود
- به دلار از همان موجودی اپ کسر میشود
مهاجرت
با یک خط از sms-activate مهاجرت کنید
نشانی سازگار ما همان پروتکل را دارد، پس رباتها و پنلهای ساختهشده برای sms-activate با تغییر نشانی پایه و کلید کار میکنند.
SMS-Activate در دسامبر ۲۰۲۵ تعطیل شد. ابزارهای خود را به SmsGrab وصل کنید تا به کارشان ادامه دهند.
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 -w '\n' "$BASE&action=getBalance"
curl -s -w '\n' "$BASE&action=getNumber&service=tg&country=6&maxPrice=0.30"
curl -s -w '\n' "$BASE&action=getStatus&id=100000123"
curl -s -w '\n' "$BASE&action=setStatus&id=100000123&status=6"
Python
import os
import time
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, maxPrice="0.30")
if not answer.startswith("ACCESS_NUMBER:"):
raise SystemExit(answer)
_, activation_id, number = answer.split(":")
print("Number:", number)
while True:
status = action("getStatus", id=activation_id)
if status.startswith("STATUS_OK:"):
print("Code:", status.split(":", 1)[1])
action("setStatus", id=activation_id, status=6)
break
if status == "STATUS_CANCEL":
print("Cancelled or expired, the charge was refunded")
break
time.sleep(5)
Node.js
const BASE = 'https://smsgrab.com/api/stubs/handler_api.php';
async function action(name, params = {}) {
const url = new URL(BASE);
url.search = new URLSearchParams({ api_key: process.env.SMSGRAB_API_KEY, action: name, ...params }).toString();
const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
return response.text();
}
console.log(await action('getBalance'));
const answer = await action('getNumber', { service: 'tg', country: '6', maxPrice: '0.30' });
if (!answer.startsWith('ACCESS_NUMBER:')) {
throw new Error(answer);
}
const [, id, number] = answer.split(':');
console.log('Number:', number);
for (;;) {
const status = await action('getStatus', { id });
if (status.startsWith('STATUS_OK:')) {
console.log('Code:', status.slice('STATUS_OK:'.length));
await action('setStatus', { id, status: '6' });
break;
}
if (status === 'STATUS_CANCEL') {
console.log('Cancelled or expired, the charge was refunded');
break;
}
await new Promise((resolve) => setTimeout(resolve, 5000));
}
PHP
<?php
function smsgrab(string $action, array $params = []): string
{
$query = http_build_query(['api_key' => getenv('SMSGRAB_API_KEY'), 'action' => $action] + $params);
$answer = file_get_contents('https://smsgrab.com/api/stubs/handler_api.php?'.$query, false, stream_context_create(['http' => ['timeout' => 30]]));
if ($answer === false) {
throw new RuntimeException('The request failed');
}
return $answer;
}
echo smsgrab('getBalance').PHP_EOL;
$answer = smsgrab('getNumber', ['service' => 'tg', 'country' => 6, 'maxPrice' => '0.30']);
if (! str_starts_with($answer, 'ACCESS_NUMBER:')) {
exit($answer.PHP_EOL);
}
[, $id, $number] = explode(':', $answer);
echo 'Number: '.$number.PHP_EOL;
while (true) {
$status = smsgrab('getStatus', ['id' => $id]);
if (str_starts_with($status, 'STATUS_OK:')) {
echo 'Code: '.substr($status, strlen('STATUS_OK:')).PHP_EOL;
smsgrab('setStatus', ['id' => $id, 'status' => 6]);
break;
}
if ($status === 'STATUS_CANCEL') {
echo 'Cancelled or expired, the charge was refunded'.PHP_EOL;
break;
}
sleep(5);
}
Go
package main
import (
"fmt"
"io"
"net/http"
"net/url"
"os"
"strings"
"time"
)
const base = "https://smsgrab.com/api/stubs/handler_api.php"
var client = &http.Client{Timeout: 30 * time.Second}
func action(name string, params url.Values) (string, error) {
query := url.Values{"api_key": {os.Getenv("SMSGRAB_API_KEY")}, "action": {name}}
for key, values := range params {
query[key] = values
}
response, err := client.Get(base + "?" + query.Encode())
if err != nil {
return "", err
}
defer response.Body.Close()
body, err := io.ReadAll(io.LimitReader(response.Body, 1<<20))
if err != nil {
return "", err
}
if response.StatusCode != http.StatusOK {
return "", fmt.Errorf("http %d: %s", response.StatusCode, body)
}
return string(body), nil
}
func main() {
answer, err := action("getNumber", url.Values{"service": {"tg"}, "country": {"6"}, "maxPrice": {"0.30"}})
if err != nil {
panic(err)
}
if !strings.HasPrefix(answer, "ACCESS_NUMBER:") {
fmt.Println(answer)
return
}
parts := strings.Split(answer, ":")
id := parts[1]
fmt.Println("Number:", parts[2])
for {
status, err := action("getStatus", url.Values{"id": {id}})
if err != nil {
panic(err)
}
if code, ok := strings.CutPrefix(status, "STATUS_OK:"); ok {
fmt.Println("Code:", code)
if _, err := action("setStatus", url.Values{"id": {id}, "status": {"6"}}); err != nil {
panic(err)
}
return
}
if status == "STATUS_CANCEL" {
fmt.Println("Cancelled or expired, the charge was refunded")
return
}
time.Sleep(5 * time.Second)
}
}
بیدرنگ
کدها مستقیم به سرور شما میرسند
در رویدادهای مورد نظر مشترک شوید تا آنها را با امضایی قابل بررسی به نشانی HTTPS شما تحویل دهیم.
- شماره خریداری شد
- کد دریافت شد
- فعالسازی کامل شد
- فعالسازی لغو شد
- فعالسازی منقضی شد
- بازپرداخت شد
- موجودی کم است
- افزایش موجودی ایجاد شد
- افزایش موجودی در حال تأیید
- افزایش موجودی واریز شد
- افزایش موجودی منقضی شد
- افزایش موجودی در حال بررسی
- هر تحویل با HMAC-SHA256 و مهر زمانی امضا میشود
- فقط نشانیهای HTTPS عمومی، با بررسی پیش از هر تحویل
- تحویل آزمایشی، سابقهٔ ۳۰ روزه و تحویل دوباره با یک کلیک
پرسشهای توسعهدهندگان
API توسعهدهندگان چقدر هزینه دارد؟
اشتراکی در کار نیست. هر شماره همان قیمت اپ را دارد و از همان موجودی پرداخت میشود. با افزایش هزینهٔ ۳۰ روزهٔ شما، سطحهای حجمی این قیمت را پایین میآورند و نمایندگان تأییدشده تخفیف ثابت دارند. شمارههای بدون کد خودکار بازپرداخت میشوند.
اگر کد نرسد چه میشود؟
شماره تا زمان پایانی که کنارش نمایش داده میشود فعال است، معمولاً ۱۰ تا ۲۰ دقیقه. اگر در این مدت کدی نرسد، یا شماره را در حالت انتظار لغو کنید، مبلغ خودکار به موجودی شما بازمیگردد.
آیا میتوانم از یکپارچهسازی sms-activate خود استفاده کنم؟
بله. نشانی پایه را به نشانی سازگار ما تغییر دهید و از کلید SmsGrab استفاده کنید. اقدامهای استاندارد، پاسخها و شناسههای عددی همان میمانند.
محدودیتهای نرخ چیست؟
بهطور پیشفرض هر کلید میتواند در دقیقه ۶۰۰ درخواست و ۶۰ خرید انجام دهد، همهٔ کلیدهای یک حساب رویهم ۳۰۰۰ درخواست در دقیقه، و تا ۱۰۰ شماره میتوانند همزمان منتظر کد باشند.
چگونه از کلیدم محافظت کنم؟
کلیدها را فقط روی سرور نگه دارید، به هر اپ کلید جدا بدهید، آن را به نشانی سرورها محدود کنید و سقف هزینهٔ روزانه بگذارید. اگر کلیدی ممکن است لو رفته باشد، از حساب خود تعویض یا باطلش کنید.
پاسخهای بیشتر در مرکز راهنما