Chọn ngôn ngữ

API cho nhà phát triển

Xác minh SMS ngay từ mã nguồn của bạn

Một lệnh gọi HTTPS cho bot hoặc nền tảng của bạn một số thật cho WhatsApp, Telegram và nhiều dịch vụ khác. Nhận mã qua webhook hoặc long polling và chỉ trả tiền cho số đã nhận mã.

  • 2.281dịch vụ
  • 200quốc gia
  • Tự độnghoàn tiền nếu không có mã

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": []
}

Xây dựng cho tự động hóa

Mọi thứ tích hợp của bạn cần, với cùng kho số, kế toán và hoàn tiền như ứng dụng.

  • REST API đơn giản

    JSON dễ đoán, mua hàng idempotent và lý do lỗi rõ ràng để bạn xử lý.

  • Webhook có chữ ký

    Sự kiện ký HMAC cho mỗi mã và thay đổi trạng thái, thử lại trong 24 giờ.

  • Long polling

    Giữ yêu cầu tới 25 giây và nhận mã ngay khi nó đến.

  • Tương thích sms-activate

    Trỏ công cụ hiện có vào endpoint của chúng tôi. Hành động và phản hồi giữ nguyên.

  • Khóa trong tầm kiểm soát

    Khóa chỉ đọc hoặc mua, danh sách IP cho phép, hạn mức ngày, hạn dùng và xoay vòng không gián đoạn.

  • Hoàn tiền tự động

    Không có mã trước khi số hết hạn? Tiền trở lại số dư ngay lập tức.

  • Mức sử dụng và nhật ký

    Yêu cầu, chi tiêu và lỗi hằng ngày theo khóa, cùng nhật ký 7 ngày qua có bộ lọc.

  • Giá theo sản lượng

    Cùng mức giá với ứng dụng, kèm mức giảm tự động tăng theo khối lượng hằng tháng của bạn.

Bắt đầu trong bốn bước

Chỉ vài lệnh gọi đến số đầu tiên.

  1. Tạo tài khoản

    Đăng ký bằng email và xác minh. Ứng dụng và website dùng chung tài khoản.

  2. Tạo khóa API

    Chọn quyền, giới hạn khóa theo máy chủ và sao chép secret một lần.

  3. Mua số

    POST dịch vụ và quốc gia. Số và giá trả về ngay.

  4. Nhận mã

    Chờ qua long polling hoặc webhook, rồi hoàn tất kích hoạt.

Giá giảm khi bạn phát triển

API tính cùng mức giá với ứng dụng. Mức giảm sỉ của bạn tăng theo chi tiêu 30 ngày qua trên mọi kênh.

  • Không bao giờ đắt hơn cùng số trong ứng dụng
  • Số không nhận mã được hoàn tiền tự động
  • Bậc cập nhật trong vài phút sau khi đạt
  • Trừ bằng USD từ cùng số dư với ứng dụng

Mức giảm theo chi tiêu 30 ngày

Các bậc khối lượng hiện chưa áp dụng. Bạn trả cùng mức giá như trong ứng dụng, còn đại lý được duyệt vẫn có mức giảm cố định.

Chuyển đổi

Chuyển từ sms-activate chỉ với một dòng

Endpoint tương thích của chúng tôi dùng cùng giao thức, nên bot và bảng điều khiển viết cho sms-activate hoạt động ngay khi bạn đổi URL gốc và khóa.

SMS-Activate đã đóng cửa vào tháng 12/2025. Trỏ công cụ của bạn sang SmsGrab để chúng tiếp tục chạy.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices và các hành động chuẩn khác
  • Mã kích hoạt dạng số, mã dịch vụ và mã quốc gia bạn đang dùng
  • Cùng khóa, giới hạn, giá, hoàn tiền và webhook như REST API
Tham chiếu tương thích

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)
	}
}

Thời gian thực

Mã đến thẳng máy chủ của bạn

Đăng ký các sự kiện bạn cần và chúng tôi gửi chúng đến endpoint HTTPS của bạn kèm chữ ký có thể xác minh.

  • Đã mua số
  • Đã nhận mã
  • Kích hoạt hoàn tất
  • Đã hủy kích hoạt
  • Kích hoạt hết hạn
  • Đã hoàn tiền
  • Số dư thấp
  • Đã tạo lần nạp
  • Lần nạp đang xác nhận
  • Lần nạp đã được cộng
  • Lần nạp đã hết hạn
  • Lần nạp đang được xem xét
Hướng dẫn webhook
600yêu cầu mỗi phút mỗi khóa
60lượt mua mỗi phút mỗi khóa
100số chờ cùng lúc
25giây long polling
  • Mỗi lượt gửi được ký HMAC-SHA256 kèm dấu thời gian
  • Chỉ endpoint HTTPS công khai, kiểm tra trước mỗi lượt gửi
  • Gửi thử, lịch sử 30 ngày và gửi lại chỉ với một cú nhấp

Câu hỏi của nhà phát triển

API cho nhà phát triển có giá bao nhiêu?

Không có gói thuê bao. Mỗi số có giá như trong ứng dụng và được trả từ cùng số dư. Các bậc khối lượng giảm giá này khi chi tiêu 30 ngày của bạn tăng, và đại lý được duyệt có mức giảm cố định. Số không nhận được mã sẽ được hoàn tiền tự động.

Nếu không có mã thì sao?

Số hoạt động đến thời điểm hết hạn được hiển thị kèm theo, thường từ 10 đến 20 phút. Nếu không có mã trong thời gian đó, hoặc bạn hủy số khi đang chờ, tiền sẽ tự động trở lại số dư.

Tôi có dùng được tích hợp sms-activate hiện có không?

Có. Đổi URL gốc sang endpoint tương thích của chúng tôi và dùng khóa SmsGrab. Hành động chuẩn, phản hồi và mã số giữ nguyên.

Giới hạn tốc độ là bao nhiêu?

Mặc định mỗi khóa có thể gửi 600 yêu cầu và 60 lượt mua mỗi phút, tất cả khóa của tài khoản cộng lại 3000 yêu cầu mỗi phút, và tối đa 100 số có thể chờ mã cùng lúc.

Làm sao bảo vệ khóa?

Chỉ giữ khóa trên máy chủ, cấp cho mỗi ứng dụng một khóa riêng, giới hạn theo địa chỉ máy chủ và đặt hạn mức chi hằng ngày. Nếu khóa có thể bị lộ, hãy xoay vòng hoặc thu hồi trong tài khoản.

Ứng dụng và API có dùng chung số dư không?

Có. API dùng số dư tài khoản SmsGrab của bạn, và mọi giao dịch mua và hoàn tiền đều hiện trong ví như các giao dịch khác.

Thêm câu trả lời tại trung tâm trợ giúp

Sẵn sàng tự động hóa xác minh?

Tạo khóa trong tài khoản và thực hiện lệnh gọi đầu tiên sau vài phút.