Виберіть мову

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)
201 Created
{
  "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 днів із фільтрами.

  • Ціни за обсяг

    Ті самі ціни, що в застосунку, зі знижками, які автоматично зростають разом із місячним обсягом.

Запуск за чотири кроки

До першого номера — лише кілька викликів.

  1. Створіть обліковий запис

    Зареєструйтеся за адресою пошти й підтвердьте її. Застосунок і сайт використовують один обліковий запис.

  2. Створіть API-ключ

    Виберіть доступ, обмежте ключ своїми серверами й один раз скопіюйте секрет.

  3. Купіть номер

    Надішліть сервіс і країну методом POST. Номер і ціна прийдуть одразу.

  4. Отримайте код

    Дочекайтеся його через long polling або вебхук, а потім завершіть активацію.

Ціни, що знижуються з вашим зростанням

API бере ті самі ціни, що й застосунок. Ваша гуртова знижка зростає разом із витратами за останні 30 днів у всіх каналах.

  • Ніколи не дорожче за той самий номер у застосунку
  • За номери без коду гроші повертаються автоматично
  • Рівень оновлюється за кілька хвилин після досягнення
  • Списання в USD з того самого балансу, що й у застосунку

Знижка за витратами за 30 днів

Рівні обсягу зараз не діють. Ви платите ті самі ціни, що в застосунку, а схвалені реселери отримують свою фіксовану знижку.

Перехід

Переходьте з 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-адресу з підписом, який можна перевірити.

  • Номер куплено
  • Код отримано
  • Активацію завершено
  • Активацію скасовано
  • Активація сплила
  • Оплату повернуто
  • Баланс закінчується
  • Поповнення створено
  • Поповнення підтверджується
  • Поповнення зараховано
  • Термін поповнення сплив
  • Поповнення на перевірці
Посібник із вебхуків
600запитів за хвилину на ключ
60покупок за хвилину на ключ
100номерів в очікуванні одночасно
25секунд long polling
  • Кожну доставку підписано HMAC-SHA256 з міткою часу
  • Лише публічні HTTPS-адреси з перевіркою перед кожною доставкою
  • Тестові доставки, історія за 30 днів і повторна доставка в один клік

Запитання розробників

Скільки коштує API для розробників?

Підписки немає. Кожен номер коштує стільки ж, скільки в застосунку, і оплачується з того самого балансу. Рівні обсягу знижують цю ціну, коли ваші витрати за 30 днів зростають, а схвалені реселери отримують фіксовану знижку. Номери без коду повертаються автоматично.

Що буде, якщо код не прийде?

Номер діє до вказаного разом із ним часу завершення — зазвичай від 10 до 20 хвилин. Якщо за цей час код не прийшов або ви скасували номер, поки він ще чекає, гроші автоматично повернуться на баланс.

Чи можна використати мою інтеграцію з sms-activate?

Так. Замініть базову адресу на нашу сумісну й використовуйте ключ SmsGrab. Стандартні дії, відповіді та числові ID залишаться такими самими.

Які ліміти частоти?

Типово кожен ключ може робити 600 запитів і 60 покупок за хвилину, усі ключі облікового запису разом — 3000 запитів за хвилину, і одночасно код можуть чекати до 100 номерів.

Як захистити ключ?

Зберігайте ключі лише на серверах, давайте кожному застосунку власний ключ, обмежте його адресами серверів і встановіть денний ліміт витрат. Якщо ключ міг витекти, замініть або відкличте його в обліковому записі.

Чи мають застосунок і API спільний баланс?

Так. API використовує баланс вашого облікового запису SmsGrab, а кожна покупка й повернення відображаються в гаманці, як і будь-які інші.

Більше відповідей — у довідковому центрі

Готові автоматизувати верифікацію?

Створіть ключ в обліковому записі й зробіть перший виклик за кілька хвилин.