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ã.
- 1.321dịch vụ
- 145quốc gia
- 0,10 US$giá thấp nhất mỗi số
- 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 "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}"},
json={"service": "whatsapp", "country": "indonesia"},
).json()Node.js
const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
method: 'POST',
headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());PHP
$activation = json_decode((string) $client->post('activations', [
'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
])->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": 18,
"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 30 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
Giá dựa trên giá sỉ tự giảm khi sản lượng hằng tháng của bạn tăng.
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
Giá cho nhà phát triển bắt đầu từ giá sỉ của mỗi số cộng mức chênh giảm dần theo sản lượng 30 ngày của bạn.
- Không bao giờ đắt hơn cùng số trong ứng dụng
- Tối thiểu 0,10 US$ mỗi số
- 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 chênh theo chi tiêu nhà phát triển 30 ngày
| Chi tiêu nhà phát triển 30 ngày | Chênh trên giá sỉ | Giá ví dụ |
|---|---|---|
| Đến 100,00 US$ | +80% | 0,18 US$ rẻ hơn ứng dụng 28% |
| Từ 100,00 US$ | +70% | 0,17 US$ rẻ hơn ứng dụng 32% |
| Từ 500,00 US$ | +60% | 0,16 US$ rẻ hơn ứng dụng 36% |
| Từ 2.000,00 US$ | +50% | 0,15 US$ rẻ hơn ứng dụng 40% |
Ví dụ: một ưu đãi có giá sỉ 0,10 US$ được bán trong ứng dụng với giá 0,25 US$.
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.
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 "$BASE&action=getBalance"
curl -s "$BASE&action=getNumber&service=tg&country=6"
curl -s "$BASE&action=getStatus&id=100000123"
curl -s "$BASE&action=setStatus&id=100000123&status=6"Python
import os
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)
if answer.startswith("ACCESS_NUMBER:"):
_, activation_id, number = answer.split(":")
print(activation_id, number)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
- 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ó phí thuê bao. Mỗi số có giá sỉ cộng 80% chênh lệch, giảm còn 70%, 60% và 50% khi chi tiêu nhà phát triển 30 ngày vượt 100, 500 và 2000 USD. Không số nào dưới 0,10 USD hoặc đắt hơn trong ứng dụng.
Nếu không có mã thì sao?
Số hoạt động trong 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