ڈویلپر API کا فوری آغاز

SmsGrab کا ڈویلپر API آپ کے سافٹ ویئر کو وہی نمبر دیتا ہے جو ایپ میں ہیں، JSON استعمال کرنے والے REST API کے ذریعے۔ یہ ایک ادائیگی والا پروڈکٹ ہے جس کی اپنی ڈویلپر قیمتیں ہیں، جو آپ کے عام SmsGrab بیلنس سے ادا ہوتی ہیں اور اسی خودکار رقم واپسی میں شامل ہیں۔

کون استعمال کر سکتا ہے

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

1. API کلید بنائیں

ویب سائٹ پر اکاؤنٹ > ڈویلپرز یا ایپ میں ترتیبات > ڈویلپر API کھولیں اور کلید بنائیں۔ حفاظت کے لیے آپ اپنے پاس ورڈ سے، اور اگر دو مرحلہ تصدیق آن ہو تو اس کے کوڈ سے بھی تصدیق کرتے ہیں۔ صرف پڑھنے والے ٹولز کے لیے read اسکوپ، یا نمبر خریدنے کے لیے read اور purchase چنیں۔

کلید sgk_ سے شروع ہوتی ہے اور صرف ایک بار دکھائی جاتی ہے۔ اسے اپنے سرور کے خفیہ اسٹوریج میں رکھیں۔ دیکھیں API کلیدیں اور سیکیورٹی۔

2. تصدیق

بنیادی URL https://smsgrab.com/api/dev/v1 ہے۔ کلید bearer ٹوکن کے طور پر یا X-Api-Key ہیڈر میں بھیجیں:

GET /api/dev/v1/balance HTTP/1.1
Host: smsgrab.com
Authorization: Bearer sgk_your_key_here

کلیدیں سرورز پر رہنی چاہئیں۔ انہیں کبھی ویب سائٹ، براؤزر ایکسٹینشن یا دوسروں کو دی جانے والی ایپ میں نہ رکھیں۔

3. اپنا بیلنس اور قیمتیں دیکھیں

export SMSGRAB_KEY="sgk_your_key_here"

curl -s https://smsgrab.com/api/dev/v1/balance \
  -H "Authorization: Bearer $SMSGRAB_KEY"

curl -s "https://smsgrab.com/api/dev/v1/prices?service=whatsapp&country=indonesia" \
  -H "Authorization: Bearer $SMSGRAB_KEY"

رقم ہمیشہ USD کی چھوٹی اکائیوں میں دی جاتی ہے، یعنی 18 کا مطلب 0.18 USD ہے۔ price_minor آپ کی ڈویلپر قیمت ہے اور retail_price_minor ایپ کی قیمت۔

{ "currency": "USD", "markup_percent": 80,
  "items": [ { "service_id": "whatsapp", "country_id": "indonesia", "price_minor": 18,
               "retail_price_minor": 25, "available_numbers": 30412 } ] }

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

curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
  -H "Authorization: Bearer $SMSGRAB_KEY" \
  -H "Idempotency-Key: order-7f3c2a" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"indonesia","max_price_minor":20}'

• service اور country ہمارے آئی ڈیز لیتے ہیں، جیسے whatsapp اور indonesia۔ ممالک کے لیے ID جیسے ISO کوڈز بھی قبول ہیں۔
• max_price_minor آپ کی حفاظت کرتا ہے: اگر قیمت بڑھ گئی ہو تو کچھ نہیں کٹتا اور آپ کو 409 PRICE_CHANGED ملتا ہے۔
• Idempotency-Key دوبارہ کوشش کو محفوظ بناتی ہے۔ اسی کلید کے ساتھ درخواست دہرانے پر دوبارہ خریداری کے بجائے پہلا نتیجہ واپس آتا ہے۔

جواب ایکٹیویشن کے ساتھ 201 Created ہوتا ہے:

{ "id": "5c1d0c2e-8a41-4f7e-9d7a-2f1d9f1b8c11", "compat_id": 100000123, "status": "WAITING_SMS",
  "service_id": "whatsapp", "country_id": "indonesia", "phone_number": "+6281234567890",
  "price_minor": 18, "currency": "USD",
  "created_at": "2026-09-27T10:05:00.000Z", "expires_at": "2026-09-27T10:25:00.000Z",
  "refunded": false, "refund_minor": 0, "sms": [] }

5. SMS کا انتظار کریں

تنگ لوپ میں بار بار پوچھنے کے بجائے API کو کچھ بدلنے تک درخواست 30 سیکنڈ تک روکے رکھنے دیں:

curl -s "https://smsgrab.com/api/dev/v1/activations/100000123?wait=25" \
  -H "Authorization: Bearer $SMSGRAB_KEY"

جب پیغام آتا ہے تو status بدل کر CODE_RECEIVED ہو جاتا ہے اور sms میں اب تک کے تمام پیغامات ہوتے ہیں:

{ "status": "CODE_RECEIVED",
  "sms": [ { "code": "482913", "text": "Your WhatsApp code is 482-913", "sender": "WhatsApp",
             "received_at": "2026-09-27T10:06:12.004Z" } ] }

پوچھ گچھ کے بجائے پش پسند ہے؟ ویب ہُکس ترتیب دیں۔

6. مکمل یا منسوخ کریں

curl -s -X POST https://smsgrab.com/api/dev/v1/activations/100000123/finish \
  -H "Authorization: Bearer $SMSGRAB_KEY"

curl -s -X POST https://smsgrab.com/api/dev/v1/activations/100000123/cancel \
  -H "Authorization: Bearer $SMSGRAB_KEY"

• کوڈ استعمال کرنے کے بعد finish۔ یہ صرف کوڈ آنے کے بعد قبول ہوتا ہے۔
• جب تک آپ پہلے کوڈ کا انتظار کر رہے ہیں cancel۔ پوری قیمت واپس ہو جاتی ہے۔
• اگر آپ کچھ نہ کریں تو بغیر کوڈ کا نمبر 20 منٹ بعد ختم ہو جاتا ہے اور رقم خود بخود واپس ہو جاتی ہے۔

حیثیت کی قدریں

خرابیاں

ہر خرابی کی شکل ایک جیسی ہے۔ code اور reason کے مطابق عمل کریں اور جو وجوہات آپ ابھی نہیں جانتے انہیں نظرانداز کریں:

{ "code": "NO_NUMBERS_AVAILABLE", "message": "No numbers available for this service and country", "reason": "OUT_OF_STOCK" }

عام صورتیں 402 INSUFFICIENT_BALANCE، 409 NO_NUMBERS_AVAILABLE، 409 PRICE_CHANGED، ACTIVATION_LIMIT_REACHED کے ساتھ 422 (فی اکاؤنٹ ایک وقت میں زیادہ سے زیادہ 100 نمبر انتظار کر سکتے ہیں) اور Retry-After ہیڈر کے ساتھ 429 RATE_LIMITED ہیں۔

مکمل حوالہ ڈویلپر دستاویزات میں ہے۔