একটি ভাষা বেছে নিন

ডেভেলপার API দ্রুত শুরু

নিজের সফটওয়্যার থেকে নম্বর কিনুন ও কোড পড়ুন। কী তৈরি করুন, দাম দেখুন, নম্বর কিনুন, SMS-এর অপেক্ষা করুন এবং শেষ করুন, ধাপে ধাপে।

এই পেজে
  1. কারা ব্যবহার করতে পারেন
  2. ১. API কী তৈরি করুন
  3. ২. প্রমাণীকরণ
  4. ৩. ব্যালান্স ও দাম দেখুন
  5. ৪. নম্বর কিনুন
  6. ৫. SMS-এর অপেক্ষা করুন
  7. ৬. শেষ করুন বা বাতিল করুন
  8. অবস্থার মান
  9. ত্রুটি

SmsGrab ডেভেলপার API আপনার সফটওয়্যারকে অ্যাপের মতোই নম্বর দেয়, JSON ব্যবহার করা একটি REST API-এর মাধ্যমে। আপনি অ্যাপের মতোই দাম দেন, আপনার হোলসেল ছাড় বাদ দিয়ে, সাধারণ SmsGrab ব্যালেন্স থেকে এবং একই স্বয়ংক্রিয় ফেরতসহ।

কারা ব্যবহার করতে পারেন

  • নিশ্চিত ঠিকানাসহ ইমেল অ্যাকাউন্ট। অতিথি অ্যাকাউন্ট কী তৈরি করতে পারে না।
  • বিধিনিষেধ ছাড়া অ্যাকাউন্ট।

১. API কী তৈরি করুন

ওয়েবসাইটে অ্যাকাউন্ট > ডেভেলপার বা অ্যাপে সেটিংস > ডেভেলপার API খুলে একটি কী তৈরি করুন। নিরাপত্তার জন্য পাসওয়ার্ড দিয়ে, আর দুই-ধাপের যাচাই চালু থাকলে তার কোড দিয়েও নিশ্চিত করেন। শুধু পড়ার টুলের জন্য read স্কোপ, বা নম্বর কেনার জন্য read ও purchase বাছুন।

কী sgk_ দিয়ে শুরু হয় এবং শুধু একবার দেখানো হয়। এটি আপনার সার্ভারের গোপন স্টোরেজে রাখুন। দেখুন API কী ও নিরাপত্তা।

২. প্রমাণীকরণ

বেস URL হলো https://smsgrab.com/api/dev/v1। কী bearer টোকেন হিসেবে বা X-Api-Key হেডারে পাঠান:

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

কী সার্ভারেই থাকা উচিত। কখনো ওয়েবসাইট, ব্রাউজার এক্সটেনশন বা অন্যকে দেওয়া অ্যাপে কী রাখবেন না।

৩. ব্যালান্স ও দাম দেখুন

Bash
export SMSGRAB_KEY="sgk_your_key_here"

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

টাকা সবসময় USD-এর ক্ষুদ্রতম এককে দেওয়া হয়, তাই 24 মানে 0.24 USD। price_minor হোলসেল ছাড়সহ আপনার দাম এবং retail_price_minor অ্যাপের তালিকা মূল্য।

JSON
{ "currency": "USD", "discount_percent": 5,
  "items": [ { "service_id": "whatsapp", "country_id": "indonesia", "price_minor": 24,
               "retail_price_minor": 25, "available_numbers": 30412 } ] }

৪. নম্বর কিনুন

Bash
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":24}'
  • service ও country আমাদের আইডি নেয়, যেমন whatsapp ও indonesia। দেশের জন্য ID-এর মতো ISO কোডও চলে।
  • max_price_minor আপনাকে রক্ষা করে: দাম বেড়ে গেলে কিছু কাটা হয় না এবং আপনি 409 PRICE_CHANGED পান।
  • Idempotency-Key পুনরায় চেষ্টা নিরাপদ করে। একই কী দিয়ে অনুরোধ আবার পাঠালে দুবার কেনার বদলে প্রথম ফলাফল ফেরত আসে।

উত্তর হলো অ্যাক্টিভেশনসহ 201 Created:

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

৫. SMS-এর অপেক্ষা করুন

ঘন লুপে বারবার জিজ্ঞেস না করে, কিছু বদলানো পর্যন্ত API-কে অনুরোধটি ৩০ সেকেন্ড পর্যন্ত ধরে রাখতে দিন:

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

বার্তা এলে status হয়ে যায় CODE_RECEIVED এবং sms-এ এ পর্যন্ত আসা সব বার্তা থাকে:

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

বারবার জিজ্ঞেসের বদলে পুশ চান? ওয়েবহুক সেট করুন।

৬. শেষ করুন বা বাতিল করুন

Bash
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। পুরো দাম ফেরত আসে।
  • কিছু না করলে কোড ছাড়া নম্বর expires_at-এর সময়ে মেয়াদোত্তীর্ণ হয় এবং স্বয়ংক্রিয়ভাবে টাকা ফেরত আসে। মেয়াদ পরিষেবা ও দেশের ওপর নির্ভর করে, তাই নির্দিষ্ট সময় ধরে না নিয়ে সবসময় expires_at পড়ুন।

অবস্থার মান

অবস্থা মানে
WAITING_SMS কেনা হয়েছে, প্রথম বার্তার অপেক্ষা
CODE_RECEIVED অন্তত একটি বার্তা এসেছে
COMPLETED আপনি শেষ করেছেন, বা কোডের পর সময় শেষ হয়েছে
CANCELLED কোডের আগে বাতিল, টাকা ফেরত
EXPIRED expires_at-এর আগে কোনো কোড নেই, টাকা ফেরত

ত্রুটি

প্রতিটি ত্রুটির আকার একই। code ও reason অনুযায়ী কাজ করুন, আর যেসব কারণ এখনও জানেন না সেগুলো উপেক্ষা করুন:

JSON
{ "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 (প্রতি অ্যাকাউন্টে একসাথে সর্বোচ্চ ১০০টি নম্বর অপেক্ষা করতে পারে) এবং Retry-After হেডারসহ 429 RATE_LIMITED।

পূর্ণ রেফারেন্স ডেভেলপার ডকুমেন্টেশনে আছে।

এই নিবন্ধটি কি কাজে এসেছে?

এখনও সাহায্য দরকার?

আমাদের লিখুন। আমরা প্রতিটি বার্তার উত্তর দিই, সাধারণত কয়েক ঘণ্টার মধ্যে।

অথবা ইমেইল করুন support@smsgrab.com