SmsGrab

Tema

Giriş yap Türkçe

Dil seç

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.

API anahtarı al Dokümantasyonu oku
  • 1.321servis
  • 145ülke
  • $0,10numara başına en düşük fiyat
  • Otomatikkod gelmezse iade

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)
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": 18,
  "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 30 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ı

    Toptan maliyete dayalı, aylık hacmin büyüdükçe kendiliğinden düşen fiyatlar.

Dört adımda yayında

İlk numaran yalnızca birkaç çağrı uzağında.

  1. Hesap oluştur

    E-posta adresinle kaydol ve doğrula. Uygulama ve web sitesi aynı hesabı kullanır.

  2. API anahtarı oluştur

    Erişimini seç, sunucularınla sınırla ve gizli değeri bir kez kopyala.

  3. Numara al

    Servisi ve ülkeyi POST et. Numarayı ve fiyatını hemen alırsın.

  4. Kodu al

    Uzun sorgulama ya da webhook ile bekle, ardından aktivasyonu tamamla.

Hızlı başlangıcı aç

Büyüdükçe düşen fiyatlar

Geliştirici fiyatları her numaranın toptan maliyetinden başlar; üzerine 30 günlük hacminle azalan bir ek oran eklenir.

  • Asla uygulamadaki aynı numaranın fiyatından fazla değil
  • Numara başına en az $0,10
  • 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

30 günlük geliştirici harcamasına göre ek oran

30 günlük geliştirici harcaması Toptan fiyat üzerine ek oran Örnek fiyat
$100,00 altı +%80 $0,18 Uygulamadan %28 daha ucuz
$100,00 ve üzeri +%70 $0,17 Uygulamadan %32 daha ucuz
$500,00 ve üzeri +%60 $0,16 Uygulamadan %36 daha ucuz
$2.000,00 ve üzeri +%50 $0,15 Uygulamadan %40 daha ucuz

Örnek: toptan maliyeti $0,10 olan ve uygulamada $0,25 tutan bir teklif.

API anahtarı al

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.

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
Uyumluluk rehberi

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)

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
Webhook rehberi
600anahtar başına dakikada istek
60anahtar başına dakikada satın alma
100aynı anda bekleyen numara
30saniye uzun sorgulama
  • 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, toptan fiyatına %80 ek oran eklenerek fiyatlanır; 30 günlük geliştirici harcaman 100, 500 ve 2.000 USD’yi geçtikçe bu oran %70, %60 ve %50’ye düşer. Bir numara asla 0,10 USD’nin altında ve uygulamadaki fiyatının üstünde olmaz.

Kod gelmezse ne olur?

Bir numara 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.

Uygulama ve API aynı bakiyeyi mi kullanır?

Evet. API, SmsGrab hesabının bakiyesini kullanır; her satın alma ve iade diğerleri gibi cüzdanında görünür.

Daha fazla yanıt için: yardım merkezi

Doğrulamayı otomatikleştirmeye hazır mısın?

Hesabında bir anahtar oluştur ve birkaç dakika içinde ilk çağrını yap.

API anahtarı al Dokümantasyonu oku