Geliştirici API’si
SMS doğrulama doğrudan kendi kodundan
Tek bir HTTPS çağrısı, botuna ya da platformuna WhatsApp, Telegram ve daha birçok servis için gerçek bir numara verir. Kodu webhook ya da uzun sorgulamayla oku; yalnızca kod gelen numaralar için öde.
- 2.279servis
- 200ülke
- Otomatikkod gelmezse iade
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": []
}
Otomasyon için tasarlandı
Entegrasyonunun ihtiyaç duyduğu her şey; uygulamayla aynı stok, aynı muhasebe ve aynı iadelerle.
-
Temiz bir REST API
Öngörülebilir JSON, tekrarlanabilir güvenli satın almalar ve üzerine işlem yapabileceğin net hata nedenleri.
-
İmzalı webhook’lar
Her kod ve durum değişikliği için HMAC imzalı olaylar, 24 saat boyunca yeniden denemeyle.
-
Uzun sorgulama
Bir isteği 25 saniyeye kadar beklet ve kod geldiği anda al.
-
sms-activate uyumlu
Mevcut araçlarını yeni bir adrese yönlendir. Eylemler ve yanıtlar aynı kalır.
-
Kontrol sende olan anahtarlar
Salt okunur ya da satın alan anahtarlar, IP izin listeleri, günlük harcama sınırları, bitiş tarihi ve kesintisiz yenileme.
-
Otomatik iadeler
Numaranın süresi dolmadan kod gelmedi mi? Ücret doğrudan bakiyene geri döner.
-
Kullanım ve istek kaydı
Anahtar başına günlük istekler, harcama ve hatalar; ayrıca son 7 günün filtrelenebilir kaydı.
-
Hacim fiyatları
Uygulamadaki fiyatların aynısı, aylık hacmin büyüdükçe kendiliğinden artan indirimlerle.
Dört adımda yayında
İlk numaran yalnızca birkaç çağrı uzağında.
-
Hesap oluştur
E-posta adresinle kaydol ve doğrula. Uygulama ve web sitesi aynı hesabı kullanır.
-
API anahtarı oluştur
Erişimini seç, sunucularınla sınırla ve gizli değeri bir kez kopyala.
-
Numara al
Servisi ve ülkeyi POST et. Numarayı ve fiyatını hemen alırsın.
-
Kodu al
Uzun sorgulama ya da webhook ile bekle, ardından aktivasyonu tamamla.
Büyüdükçe düşen fiyatlar
API, uygulamadaki fiyatların aynısını uygular. Toptan indirimin, tüm kanallardaki 30 günlük harcamanla birlikte büyür.
- Asla uygulamadaki aynı numaranın fiyatından fazla değil
- Kod gelmeyen numaralar otomatik olarak iade edilir
- Kademen, eşiğe ulaştıktan birkaç dakika içinde güncellenir
- Uygulamayla aynı bakiyeden USD olarak tahsil edilir
Geçiş
sms-activate’ten tek satırla geç
Uyumlu uç noktamız aynı protokolü konuşur; sms-activate için yapılmış botlar ve paneller, temel adresi ve anahtarı değiştirdiğinde çalışır.
SMS-Activate Aralık 2025’te kapandı. Araçlarını SmsGrab’e yönlendir, çalışmaya devam etsinler.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices ve diğer tüm standart eylemler
- Zaten kullandığın sayısal aktivasyon kimlikleri, servis kodları ve ülke kimlikleri
- REST API ile aynı anahtarlar, limitler, fiyatlar, iadeler ve webhook’lar
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)
}
}
Gerçek zamanlı
Kodlar sunucuna gönderilir
İlgilendiğin olaylara abone ol; onları doğrulayabileceğin bir imzayla HTTPS uç noktana iletelim.
- Numara alındı
- Kod geldi
- Aktivasyon tamamlandı
- Aktivasyon iptal edildi
- Aktivasyonun süresi doldu
- Ücret iade edildi
- Bakiye azalıyor
- Yükleme oluşturuldu
- Yükleme onaylanıyor
- Yükleme bakiyeye eklendi
- Yüklemenin süresi doldu
- Yükleme incelemede
- Her teslimat HMAC-SHA256 ve bir zaman damgasıyla imzalanır
- Yalnızca herkese açık HTTPS uç noktaları, her teslimattan önce kontrol edilir
- Test teslimatları, 30 günlük geçmiş ve tek tıkla yeniden gönderim
Geliştirici soruları
Geliştirici API’si ne kadar tutar?
Abonelik yok. Her numara uygulamadakiyle aynı tutar ve aynı bakiyeden ödenir. 30 günlük harcaman arttıkça hacim kademeleri bu fiyatı düşürür, onaylı bayiler de sabit bir indirim alır. Kod gelmeyen numaralar otomatik olarak iade edilir.
Kod gelmezse ne olur?
Bir numara, yanında gösterilen bitiş zamanına kadar, genellikle 10 ila 20 dakika geçerlidir. Bu sürede kod gelmezse ya da numara hâlâ beklerken iptal edersen ücret otomatik olarak bakiyene iade edilir.
Mevcut sms-activate entegrasyonumu kullanabilir miyim?
Evet. Temel adresi uyumlu uç noktamızla değiştir ve SmsGrab anahtarını kullan. Standart eylemler, yanıtlar ve sayısal kimlikler aynı kalır.
Hız sınırları nelerdir?
Varsayılan olarak her anahtar dakikada 600 istek ve 60 satın alma yapabilir, bir hesabın tüm anahtarları birlikte dakikada 3.000 istek yapabilir ve aynı anda en fazla 100 numara kod bekleyebilir.
Anahtarımı nasıl güvende tutarım?
Anahtarları yalnızca sunucularında tut, her uygulamaya kendi anahtarını ver, anahtarı sunucu adreslerinle sınırla ve günlük harcama sınırı koy. Bir anahtar sızmış olabilirse hesabından yenile ya da iptal et.
Daha fazla yanıt için: yardım merkezi