زبان منتخب کریں

ڈویلپر API

SMS تصدیق براہ راست آپ کے کوڈ سے

ایک HTTPS کال آپ کے بوٹ یا پلیٹ فارم کو WhatsApp، Telegram اور بہت سی دوسری سروسز کے لیے حقیقی نمبر دیتی ہے۔ کوڈ ویب ہُک یا long polling سے لیں اور صرف ان نمبروں کی ادائیگی کریں جن پر کوڈ آیا۔

  • 1,321سروسز
  • 145ممالک
  • ⁨$0.10⁩فی نمبر کم از کم قیمت
  • خودکارکوڈ نہ آنے پر ریفنڈ

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)
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": 18,
  "currency": "USD",
  "expires_at": "2026-09-27T10:25:00.000Z",
  "sms": []
}

آٹومیشن کے لیے بنایا گیا

آپ کے انٹیگریشن کی ہر ضرورت، ایپ جیسی نمبر انوینٹری، حساب کتاب اور ریفنڈز کے ساتھ۔

  • سادہ REST API

    قابل پیش گوئی JSON، idempotent خریداریاں اور واضح غلطی کی وجوہات جن پر آپ عمل کر سکیں۔

  • دستخط شدہ ویب ہُکس

    ہر کوڈ اور حیثیت کی تبدیلی کے لیے HMAC دستخط شدہ ایونٹس، 24 گھنٹے تک دوبارہ کوششوں کے ساتھ۔

  • Long polling

    درخواست 30 سیکنڈ تک کھلی رکھیں اور کوڈ آتے ہی وصول کریں۔

  • sms-activate کے موافق

    اپنے موجودہ ٹولز ہمارے اینڈ پوائنٹ پر لگائیں۔ ایکشنز اور جوابات وہی رہتے ہیں۔

  • آپ کے کنٹرول میں کیز

    صرف پڑھنے یا خریدنے والی کیز، IP اجازت فہرست، یومیہ حد، میعاد اور بغیر تعطل تبدیلی۔

  • خودکار ریفنڈز

    نمبر کی میعاد ختم ہونے تک کوڈ نہیں آیا؟ رقم فوراً آپ کے بیلنس میں واپس آ جاتی ہے۔

  • استعمال اور درخواست لاگ

    ہر کی کی یومیہ درخواستیں، خرچ اور غلطیاں، ساتھ پچھلے 7 دن کا فلٹر ہونے والا لاگ۔

  • والیوم قیمتیں

    ہول سیل پر مبنی قیمتیں جو آپ کے ماہانہ والیوم کے بڑھنے کے ساتھ خود کم ہوتی ہیں۔

چار قدموں میں شروع کریں

پہلے نمبر تک صرف چند کالز۔

  1. اکاؤنٹ بنائیں

    ای میل سے سائن اپ کریں اور تصدیق کریں۔ ایپ اور ویب سائٹ ایک ہی اکاؤنٹ استعمال کرتے ہیں۔

  2. API کی بنائیں

    رسائی منتخب کریں، کی کو اپنے سرورز تک محدود کریں اور سیکرٹ ایک بار کاپی کریں۔

  3. نمبر خریدیں

    سروس اور ملک POST کریں۔ نمبر اور قیمت فوراً واپس آتے ہیں۔

  4. کوڈ وصول کریں

    long polling یا ویب ہُک سے انتظار کریں، پھر ایکٹیویشن مکمل کریں۔

قیمتیں جو آپ کی ترقی کے ساتھ کم ہوں

ڈویلپر قیمتیں ہر نمبر کی ہول سیل لاگت سے شروع ہوتی ہیں، ساتھ ایک مارک اپ جو آپ کے 30 دن کے والیوم کے ساتھ کم ہوتا ہے۔

  • ایپ میں اسی نمبر سے کبھی مہنگا نہیں
  • فی نمبر کم از کم ⁨$0.10⁩
  • جن نمبروں پر کوڈ نہ آئے وہ خود ریفنڈ ہوتے ہیں
  • درجہ حاصل ہونے کے چند منٹ میں اپڈیٹ ہوتا ہے
  • ایپ والے بیلنس سے USD میں وصول

30 دن کے ڈویلپر خرچ کے مطابق مارک اپ

30 دن کے خرچ کے مطابق ڈویلپر مارک اپ
30 دن کا ڈویلپر خرچ ہول سیل پر مارک اپ مثالی قیمت
⁨$100.00⁩ تک +80% ⁨$0.18⁩ ایپ سے 28% کم
⁨$100.00⁩ سے +70% ⁨$0.17⁩ ایپ سے 32% کم
⁨$500.00⁩ سے +60% ⁨$0.16⁩ ایپ سے 36% کم
⁨$2,000.00⁩ سے +50% ⁨$0.15⁩ ایپ سے 40% کم

مثال: ⁨$0.10⁩ ہول سیل لاگت والی آفر جو ایپ میں ⁨$0.25⁩ کی ہے۔

API کی حاصل کریں

منتقلی

ایک سطر بدل کر sms-activate سے منتقل ہوں

ہمارا موافق اینڈ پوائنٹ وہی پروٹوکول استعمال کرتا ہے، اس لیے sms-activate کے لیے بنے بوٹس اور پینلز بیس URL اور کی بدلتے ہی کام کرتے ہیں۔

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 "$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 اینڈ پوائنٹ پر پہنچائیں گے۔

  • نمبر خریدا گیا
  • کوڈ موصول ہوا
  • ایکٹیویشن مکمل
  • ایکٹیویشن منسوخ
  • ایکٹیویشن کی میعاد ختم
  • ریفنڈ ہو گیا
  • بیلنس کم ہے
ویب ہُک گائیڈ
600فی کی فی منٹ درخواستیں
60فی کی فی منٹ خریداریاں
100بیک وقت زیر انتظار نمبر
30سیکنڈ long polling
  • ہر ڈیلیوری ٹائم اسٹیمپ کے ساتھ HMAC-SHA256 سے دستخط شدہ
  • صرف عوامی HTTPS اینڈ پوائنٹس، ہر ڈیلیوری سے پہلے جانچ کے ساتھ
  • ٹیسٹ ڈیلیوریاں، 30 دن کی تاریخ اور ایک کلک میں دوبارہ ڈیلیوری

ڈویلپرز کے سوالات

ڈویلپر API کی قیمت کیا ہے؟

کوئی سبسکرپشن نہیں۔ ہر نمبر کی قیمت ہول سیل جمع 80% مارک اپ ہے، جو 30 دن کا ڈویلپر خرچ 100، 500 اور 2000 USD سے بڑھنے پر 70%، 60% اور 50% ہو جاتا ہے۔ کوئی نمبر 0.10 USD سے کم یا ایپ کی قیمت سے زیادہ نہیں ہوتا۔

اگر کوڈ نہ آئے تو کیا ہوتا ہے؟

نمبر 20 منٹ فعال رہتا ہے۔ اگر اس دوران کوڈ نہ آئے، یا آپ انتظار کے دوران نمبر منسوخ کریں، تو رقم خود بخود آپ کے بیلنس میں واپس آ جاتی ہے۔

کیا میں اپنا sms-activate انٹیگریشن استعمال کر سکتا ہوں؟

جی ہاں۔ بیس URL ہمارے موافق اینڈ پوائنٹ پر بدلیں اور SmsGrab کی استعمال کریں۔ معیاری ایکشنز، جوابات اور عددی IDs وہی رہتے ہیں۔

شرح کی حدود کیا ہیں؟

بطور ڈیفالٹ ہر کی فی منٹ 600 درخواستیں اور 60 خریداریاں کر سکتی ہے، اکاؤنٹ کی تمام کیز مل کر فی منٹ 3000 درخواستیں، اور بیک وقت 100 تک نمبر کوڈ کے منتظر رہ سکتے ہیں۔

میں اپنی کی کو کیسے محفوظ رکھوں؟

کیز صرف سرورز پر رکھیں، ہر ایپ کو الگ کی دیں، اسے سرور ایڈریسز تک محدود کریں اور یومیہ خرچ کی حد لگائیں۔ اگر کی لیک ہوئی ہو تو اکاؤنٹ سے تبدیل یا منسوخ کریں۔

کیا ایپ اور API کا بیلنس ایک ہے؟

جی ہاں۔ API آپ کے SmsGrab اکاؤنٹ کا بیلنس استعمال کرتی ہے، اور ہر خریداری اور ریفنڈ دوسروں کی طرح آپ کے والیٹ میں نظر آتا ہے۔

مزید جوابات ہیلپ سینٹر

تصدیق کو خودکار بنانے کے لیے تیار ہیں؟

اپنے اکاؤنٹ میں کی بنائیں اور چند منٹ میں پہلی کال کریں۔