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 номерів.
Як захистити ключ?
Зберігайте ключі лише на серверах, давайте кожному застосунку власний ключ, обмежте його адресами серверів і встановіть денний ліміт витрат. Якщо ключ міг витекти, замініть або відкличте його в обліковому записі.
Більше відповідей — у довідковому центрі