डेवलपर 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 और बाकी मानक एक्शन
- संख्यात्मक एक्टिवेशन 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 तक नंबर कोड की प्रतीक्षा कर सकते हैं।
अपनी कुंजी कैसे सुरक्षित रखूँ?
कुंजियाँ केवल सर्वर पर रखें, हर ऐप को अलग कुंजी दें, उसे सर्वर पतों तक सीमित करें और दैनिक खर्च सीमा रखें। कुंजी लीक होने का शक हो तो खाते से बदलें या रद्द करें।
और जवाब यहाँ: सहायता केंद्र