ডেভেলপার API
SMS যাচাই সরাসরি আপনার কোড থেকে
একটি HTTPS কল আপনার বট বা প্ল্যাটফর্মকে WhatsApp, Telegram ও আরও অনেক সেবার জন্য আসল নম্বর দেয়। ওয়েবহুক বা 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)
{
"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 ও অন্যান্য মানক অ্যাকশন
- সংখ্যাসূচক অ্যাক্টিভেশন ID, সেবা কোড ও দেশ ID যা আপনি আগে থেকেই ব্যবহার করেন
- 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 কী ব্যবহার করুন। মানক অ্যাকশন, উত্তর ও সংখ্যাসূচক ID একই থাকে।
হার সীমা কী কী?
ডিফল্টভাবে প্রতিটি কী প্রতি মিনিটে 600 অনুরোধ ও 60 কেনাকাটা করতে পারে, অ্যাকাউন্টের সব কী মিলে প্রতি মিনিটে 3000 অনুরোধ, এবং একসঙ্গে 100টি পর্যন্ত নম্বর কোডের অপেক্ষায় থাকতে পারে।
আমার কী কীভাবে সুরক্ষিত রাখব?
কী শুধু সার্ভারে রাখুন, প্রতিটি অ্যাপকে আলাদা কী দিন, সার্ভারের ঠিকানায় সীমিত করুন এবং দৈনিক খরচের সীমা দিন। কী ফাঁস হয়ে থাকতে পারলে অ্যাকাউন্ট থেকে বদলান বা বাতিল করুন।
আরও উত্তর সহায়তা কেন্দ্রে