یک زبان انتخاب کنید

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)
201 Created
{
  "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 مجاز، سقف روزانه، انقضا و تعویض بدون توقف.

  • بازپرداخت خودکار

    کد پیش از پایان اعتبار شماره نرسید؟ مبلغ فوراً به موجودی شما بازمی‌گردد.

  • مصرف و گزارش درخواست

    درخواست‌ها، هزینه و خطاهای روزانه برای هر کلید، به‌علاوهٔ گزارش قابل فیلتر ۷ روز گذشته.

  • قیمت حجمی

    همان قیمت‌های اپ، با تخفیف‌هایی که با حجم ماهانهٔ شما خودکار بیشتر می‌شوند.

در چهار قدم شروع کنید

فقط چند فراخوانی تا اولین شماره فاصله دارید.

  1. حساب بسازید

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

  2. کلید API بسازید

    دسترسی را انتخاب کنید، کلید را به سرورهایتان محدود کنید و رمز را یک بار کپی کنید.

  3. شماره بخرید

    سرویس و کشور را با POST بفرستید. شماره و قیمت فوراً برمی‌گردند.

  4. کد را بگیرید

    با 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 شما تحویل دهیم.

  • شماره خریداری شد
  • کد دریافت شد
  • فعال‌سازی کامل شد
  • فعال‌سازی لغو شد
  • فعال‌سازی منقضی شد
  • بازپرداخت شد
  • موجودی کم است
  • افزایش موجودی ایجاد شد
  • افزایش موجودی در حال تأیید
  • افزایش موجودی واریز شد
  • افزایش موجودی منقضی شد
  • افزایش موجودی در حال بررسی
راهنمای وب‌هوک
۶۰۰درخواست در دقیقه برای هر کلید
۶۰خرید در دقیقه برای هر کلید
۱۰۰شمارهٔ در انتظار هم‌زمان
۲۵ثانیه long polling
  • هر تحویل با HMAC-SHA256 و مهر زمانی امضا می‌شود
  • فقط نشانی‌های HTTPS عمومی، با بررسی پیش از هر تحویل
  • تحویل آزمایشی، سابقهٔ ۳۰ روزه و تحویل دوباره با یک کلیک

پرسش‌های توسعه‌دهندگان

API توسعه‌دهندگان چقدر هزینه دارد؟

اشتراکی در کار نیست. هر شماره همان قیمت اپ را دارد و از همان موجودی پرداخت می‌شود. با افزایش هزینهٔ ۳۰ روزهٔ شما، سطح‌های حجمی این قیمت را پایین می‌آورند و نمایندگان تأییدشده تخفیف ثابت دارند. شماره‌های بدون کد خودکار بازپرداخت می‌شوند.

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

شماره تا زمان پایانی که کنارش نمایش داده می‌شود فعال است، معمولاً ۱۰ تا ۲۰ دقیقه. اگر در این مدت کدی نرسد، یا شماره را در حالت انتظار لغو کنید، مبلغ خودکار به موجودی شما بازمی‌گردد.

آیا می‌توانم از یکپارچه‌سازی sms-activate خود استفاده کنم؟

بله. نشانی پایه را به نشانی سازگار ما تغییر دهید و از کلید SmsGrab استفاده کنید. اقدام‌های استاندارد، پاسخ‌ها و شناسه‌های عددی همان می‌مانند.

محدودیت‌های نرخ چیست؟

به‌طور پیش‌فرض هر کلید می‌تواند در دقیقه ۶۰۰ درخواست و ۶۰ خرید انجام دهد، همهٔ کلیدهای یک حساب روی‌هم ۳۰۰۰ درخواست در دقیقه، و تا ۱۰۰ شماره می‌توانند هم‌زمان منتظر کد باشند.

چگونه از کلیدم محافظت کنم؟

کلیدها را فقط روی سرور نگه دارید، به هر اپ کلید جدا بدهید، آن را به نشانی سرورها محدود کنید و سقف هزینهٔ روزانه بگذارید. اگر کلیدی ممکن است لو رفته باشد، از حساب خود تعویض یا باطلش کنید.

آیا اپ و API موجودی مشترک دارند؟

بله. API از موجودی حساب SmsGrab شما استفاده می‌کند و هر خرید و بازپرداخت مانند بقیه در کیف پول شما نمایش داده می‌شود.

پاسخ‌های بیشتر در مرکز راهنما

آمادهٔ خودکارسازی تأیید هستید؟

در حساب خود کلید بسازید و ظرف چند دقیقه اولین فراخوانی را انجام دهید.