API Pembangun
Pengesahan SMS terus dari kod anda
Satu panggilan HTTPS memberi bot atau platform anda nombor sebenar untuk WhatsApp, Telegram dan banyak perkhidmatan lain. Terima kod melalui webhook atau long polling dan bayar hanya untuk nombor yang menerima kod.
- 2,281perkhidmatan
- 200negara
- Automatikbayaran balik jika tiada kod
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": []
}
Dibina untuk automasi
Semua yang diperlukan integrasi anda, dengan stok nombor, perakaunan dan bayaran balik yang sama seperti aplikasi.
-
REST API ringkas
JSON yang boleh dijangka, pembelian idempoten dan sebab ralat jelas yang boleh anda tangani.
-
Webhook bertandatangan
Acara bertandatangan HMAC untuk setiap kod dan perubahan status, dengan cubaan semula selama 24 jam.
-
Long polling
Tahan permintaan sehingga 25 saat dan terima kod sebaik ia tiba.
-
Serasi sms-activate
Halakan alat sedia ada ke endpoint kami. Tindakan dan respons kekal sama.
-
Kunci dalam kawalan anda
Kunci baca atau beli, senarai IP dibenarkan, had harian, tempoh dan putaran tanpa gangguan.
-
Bayaran balik automatik
Tiada kod sebelum nombor tamat? Wang kembali ke baki anda serta-merta.
-
Penggunaan dan log
Permintaan, perbelanjaan dan ralat harian setiap kunci, serta log 7 hari lepas yang boleh ditapis.
-
Harga volum
Harga yang sama seperti dalam apl, dengan diskaun yang meningkat secara automatik mengikut volum bulanan anda.
Mula dalam empat langkah
Hanya beberapa panggilan ke nombor pertama anda.
-
Cipta akaun
Daftar dengan e-mel dan sahkannya. Aplikasi dan laman web menggunakan akaun yang sama.
-
Cipta kunci API
Pilih akses, hadkan kunci kepada pelayan anda dan salin rahsia sekali.
-
Beli nombor
POST perkhidmatan dan negara. Nombor dan harga dikembalikan serta-merta.
-
Terima kod
Tunggu melalui long polling atau webhook, kemudian tamatkan pengaktifan.
Harga yang turun apabila anda berkembang
API mengenakan harga yang sama seperti apl. Diskaun borong anda meningkat mengikut perbelanjaan 30 hari lepas di semua saluran.
- Tidak pernah lebih mahal daripada nombor yang sama dalam aplikasi
- Nombor tanpa kod dibayar balik secara automatik
- Peringkat dikemas kini dalam beberapa minit selepas dicapai
- Dicaj dalam USD daripada baki yang sama dengan aplikasi
Migrasi
Beralih dari sms-activate dengan satu baris
Endpoint serasi kami menggunakan protokol yang sama, jadi bot dan panel untuk sms-activate berfungsi sebaik anda menukar URL asas dan kunci.
SMS-Activate ditutup pada Disember 2025. Halakan alatan anda ke SmsGrab dan ia terus berfungsi.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices dan tindakan standard lain
- ID pengaktifan berangka, kod perkhidmatan dan ID negara yang anda gunakan sekarang
- Kunci, had, harga, bayaran balik dan webhook yang sama seperti 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)
}
}
Masa nyata
Kod terus ke pelayan anda
Langgan acara yang anda perlukan dan kami menghantarnya ke endpoint HTTPS anda dengan tandatangan yang boleh disahkan.
- Nombor dibeli
- Kod diterima
- Pengaktifan selesai
- Pengaktifan dibatalkan
- Pengaktifan tamat tempoh
- Bayaran dikembalikan
- Baki rendah
- Tambahan baki dicipta
- Tambahan baki sedang disahkan
- Tambahan baki dikreditkan
- Tambahan baki tamat tempoh
- Tambahan baki dalam semakan
- Setiap penghantaran ditandatangani HMAC-SHA256 dengan cap masa
- Hanya endpoint HTTPS awam, disemak sebelum setiap penghantaran
- Penghantaran ujian, sejarah 30 hari dan hantar semula dengan satu klik
Soalan pembangun
Berapakah kos API pembangun?
Tiada langganan. Setiap nombor berharga sama seperti dalam apl dan dibayar daripada baki yang sama. Peringkat volum menurunkan harga itu apabila perbelanjaan 30 hari anda meningkat, dan penjual semula yang diluluskan mendapat diskaun tetap. Nombor tanpa kod dibayar balik secara automatik.
Bagaimana jika kod tidak tiba?
Nombor aktif sehingga masa tamat yang dipaparkan bersamanya, biasanya 10 hingga 20 minit. Jika tiada kod dalam tempoh itu, atau anda membatalkan nombor semasa menunggu, wang kembali ke baki anda secara automatik.
Bolehkah saya menggunakan integrasi sms-activate saya?
Boleh. Tukar URL asas kepada endpoint serasi kami dan gunakan kunci SmsGrab. Tindakan standard, respons dan ID berangka kekal sama.
Apakah had kadarnya?
Secara lalai setiap kunci boleh membuat 600 permintaan dan 60 pembelian seminit, semua kunci akaun bersama 3000 permintaan seminit, dan sehingga 100 nombor boleh menunggu kod serentak.
Bagaimana saya melindungi kunci saya?
Simpan kunci di pelayan sahaja, beri setiap aplikasi kuncinya sendiri, hadkan kepada alamat pelayan dan tetapkan had belanja harian. Jika kunci mungkin terdedah, putar atau batalkannya dari akaun anda.
Lebih banyak jawapan di pusat bantuan