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)
{
"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.
-
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.
-
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.
-
Mua số
POST dịch vụ và quốc gia. Số và giá trả về ngay.
-
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
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
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
- 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.
Thêm câu trả lời tại trung tâm trợ giúp