ڈویلپر API
SMS تصدیق براہ راست آپ کے کوڈ سے
ایک HTTPS کال آپ کے بوٹ یا پلیٹ فارم کو WhatsApp، Telegram اور بہت سی دوسری سروسز کے لیے حقیقی نمبر دیتی ہے۔ کوڈ ویب ہُک یا long polling سے لیں اور صرف ان نمبروں کی ادائیگی کریں جن پر کوڈ آیا۔
- 2,281سروسز
- 200ممالک
- خودکارکوڈ نہ آنے پر ریفنڈ
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 دستخط شدہ ایونٹس، 24 گھنٹے تک دوبارہ کوششوں کے ساتھ۔
-
Long polling
درخواست 25 سیکنڈ تک کھلی رکھیں اور کوڈ آتے ہی وصول کریں۔
-
sms-activate کے موافق
اپنے موجودہ ٹولز ہمارے اینڈ پوائنٹ پر لگائیں۔ ایکشنز اور جوابات وہی رہتے ہیں۔
-
آپ کے کنٹرول میں کیز
صرف پڑھنے یا خریدنے والی کیز، IP اجازت فہرست، یومیہ حد، میعاد اور بغیر تعطل تبدیلی۔
-
خودکار ریفنڈز
نمبر کی میعاد ختم ہونے تک کوڈ نہیں آیا؟ رقم فوراً آپ کے بیلنس میں واپس آ جاتی ہے۔
-
استعمال اور درخواست لاگ
ہر کی کی یومیہ درخواستیں، خرچ اور غلطیاں، ساتھ پچھلے 7 دن کا فلٹر ہونے والا لاگ۔
-
والیوم قیمتیں
ایپ والی قیمتیں، ایسی رعایتوں کے ساتھ جو آپ کے ماہانہ حجم کے ساتھ خودبخود بڑھتی ہیں۔
چار قدموں میں شروع کریں
پہلے نمبر تک صرف چند کالز۔
-
اکاؤنٹ بنائیں
ای میل سے سائن اپ کریں اور تصدیق کریں۔ ایپ اور ویب سائٹ ایک ہی اکاؤنٹ استعمال کرتے ہیں۔
-
API کی بنائیں
رسائی منتخب کریں، کی کو اپنے سرورز تک محدود کریں اور سیکرٹ ایک بار کاپی کریں۔
-
نمبر خریدیں
سروس اور ملک POST کریں۔ نمبر اور قیمت فوراً واپس آتے ہیں۔
-
کوڈ وصول کریں
long polling یا ویب ہُک سے انتظار کریں، پھر ایکٹیویشن مکمل کریں۔
قیمتیں جو آپ کی ترقی کے ساتھ کم ہوں
API وہی قیمتیں لیتا ہے جو ایپ میں ہیں۔ آپ کی ہول سیل رعایت تمام چینلز پر پچھلے 30 دن کے خرچ کے ساتھ بڑھتی ہے۔
- ایپ میں اسی نمبر سے کبھی مہنگا نہیں
- جن نمبروں پر کوڈ نہ آئے وہ خود ریفنڈ ہوتے ہیں
- درجہ حاصل ہونے کے چند منٹ میں اپڈیٹ ہوتا ہے
- ایپ والے بیلنس سے USD میں وصول
منتقلی
ایک سطر بدل کر sms-activate سے منتقل ہوں
ہمارا موافق اینڈ پوائنٹ وہی پروٹوکول استعمال کرتا ہے، اس لیے sms-activate کے لیے بنے بوٹس اور پینلز بیس URL اور کی بدلتے ہی کام کرتے ہیں۔
SMS-Activate دسمبر 2025 میں بند ہو گیا۔ اپنے ٹولز کو SmsGrab کی طرف موڑیں اور وہ چلتے رہیں گے۔
https://smsgrab.com/api/stubs/handler_api.php
- getNumber، getStatus، setStatus، getPrices اور باقی معیاری ایکشنز
- عددی ایکٹیویشن IDs، سروس کوڈز اور ملک IDs جو آپ پہلے سے استعمال کرتے ہیں
- 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 اینڈ پوائنٹس، ہر ڈیلیوری سے پہلے جانچ کے ساتھ
- ٹیسٹ ڈیلیوریاں، 30 دن کی تاریخ اور ایک کلک میں دوبارہ ڈیلیوری
ڈویلپرز کے سوالات
ڈویلپر API کی قیمت کیا ہے؟
کوئی سبسکرپشن نہیں۔ ہر نمبر کی قیمت ایپ جتنی ہے اور اسی بیلنس سے ادا ہوتی ہے۔ 30 دن کا خرچ بڑھنے پر حجم کے درجے یہ قیمت کم کرتے ہیں، اور منظور شدہ ری سیلرز کو مقررہ رعایت ملتی ہے۔ بغیر کوڈ والے نمبروں کی رقم خودبخود واپس ہو جاتی ہے۔
اگر کوڈ نہ آئے تو کیا ہوتا ہے؟
نمبر اپنے ساتھ دکھائے گئے اختتامی وقت تک فعال رہتا ہے، عام طور پر 10 سے 20 منٹ۔ اگر اس دوران کوڈ نہ آئے، یا آپ انتظار کے دوران نمبر منسوخ کریں، تو رقم خود بخود آپ کے بیلنس میں واپس آ جاتی ہے۔
کیا میں اپنا sms-activate انٹیگریشن استعمال کر سکتا ہوں؟
جی ہاں۔ بیس URL ہمارے موافق اینڈ پوائنٹ پر بدلیں اور SmsGrab کی استعمال کریں۔ معیاری ایکشنز، جوابات اور عددی IDs وہی رہتے ہیں۔
شرح کی حدود کیا ہیں؟
بطور ڈیفالٹ ہر کی فی منٹ 600 درخواستیں اور 60 خریداریاں کر سکتی ہے، اکاؤنٹ کی تمام کیز مل کر فی منٹ 3000 درخواستیں، اور بیک وقت 100 تک نمبر کوڈ کے منتظر رہ سکتے ہیں۔
میں اپنی کی کو کیسے محفوظ رکھوں؟
کیز صرف سرورز پر رکھیں، ہر ایپ کو الگ کی دیں، اسے سرور ایڈریسز تک محدود کریں اور یومیہ خرچ کی حد لگائیں۔ اگر کی لیک ہوئی ہو تو اکاؤنٹ سے تبدیل یا منسوخ کریں۔
مزید جوابات ہیلپ سینٹر