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, идемпотентные покупки и ясные причины ошибок, на которые можно реагировать.
-
Подписанные вебхуки
События с подписью HMAC для каждого кода и смены статуса, с повторами в течение 24 часов.
-
Long polling
Держите запрос до 25 секунд и получайте код в момент его прихода.
-
Совместимость с sms-activate
Направьте свои инструменты на новый адрес. Действия и ответы останутся прежними.
-
Ключи под вашим контролем
Ключи только для чтения или для покупок, списки разрешённых IP, дневные лимиты, срок действия и замена без простоя.
-
Автоматические возвраты
Код не пришёл до истечения номера? Деньги сразу вернутся на баланс.
-
Использование и журнал запросов
Ежедневные запросы, расходы и ошибки по каждому ключу, а также журнал за последние 7 дней с фильтрами.
-
Цены за объём
Те же цены, что в приложении, со скидками, которые автоматически растут вместе с месячным объёмом.
Запуск за четыре шага
До первого номера — всего несколько вызовов.
-
Создайте аккаунт
Зарегистрируйтесь по адресу электронной почты и подтвердите его. Приложение и сайт используют один аккаунт.
-
Создайте API-ключ
Выберите доступ, ограничьте ключ своими серверами и один раз скопируйте секрет.
-
Купите номер
Отправьте сервис и страну методом POST. Номер и цена придут сразу.
-
Получите код
Дождитесь его через long polling или вебхук, а затем завершите активацию.
Цены, которые снижаются по мере роста
API берёт те же цены, что и приложение. Ваша оптовая скидка растёт вместе с расходами за последние 30 дней во всех каналах.
- Никогда не дороже того же номера в приложении
- За номера без кода деньги возвращаются автоматически
- Уровень обновляется через несколько минут после достижения
- Списание в USD с того же баланса, что и в приложении
Переход
Переходите с sms-activate одной строкой
Наш совместимый адрес работает по тому же протоколу, поэтому боты и панели для sms-activate заработают, как только вы смените базовый адрес и ключ.
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?
Да. Замените базовый адрес на наш совместимый и используйте ключ SmsGrab. Стандартные действия, ответы и числовые ID останутся прежними.
Какие лимиты частоты?
По умолчанию каждый ключ может делать 600 запросов и 60 покупок в минуту, все ключи аккаунта вместе — 3000 запросов в минуту, и одновременно код могут ждать до 100 номеров.
Как защитить ключ?
Храните ключи только на серверах, давайте каждому приложению свой ключ, ограничьте его адресами серверов и задайте дневной лимит расходов. Если ключ мог утечь, замените или отзовите его в аккаунте.
Больше ответов — в справочном центре