Dil seç

Geliştirici API'sine hızlı başlangıç

Kendi yazılımınla numara satın al ve kodları oku. Anahtar oluştur, fiyatları kontrol et, numara al, SMS'i bekle ve bitir, adım adım.

Bu sayfada
  1. Kimler kullanabilir?
  2. 1. API anahtarı oluştur
  3. 2. Kimlik doğrulama
  4. 3. Bakiyeni ve fiyatları kontrol et
  5. 4. Numara satın al
  6. 5. SMS'i bekle
  7. 6. Bitir ya da iptal et
  8. Durum değerleri
  9. Hatalar

SmsGrab geliştirici API'si, yazılımına uygulamadaki numaraların aynısını JSON konuşan bir REST API üzerinden sunar. Uygulamadaki fiyatların aynısını, toptan indirimin düşülerek normal SmsGrab bakiyenden ödersin ve aynı otomatik iadeler geçerlidir.

Kimler kullanabilir?

  • Doğrulanmış bir adrese sahip e-posta hesabı. Misafir hesaplar anahtar oluşturamaz.
  • Herhangi bir kısıtlaması olmayan bir hesap.

1. API anahtarı oluştur

Web sitesinde Hesap > Geliştiriciler ya da uygulamada Ayarlar > Geliştirici API'si sayfasını aç ve bir anahtar oluştur. Güvenlik için şifrenle, iki adımlı doğrulama açıksa kodunla da onaylarsın. Yalnızca okuma yapan araçlar için read kapsamını, numara satın almak için read ve purchase kapsamını seç.

Anahtar sgk_ ile başlar ve yalnızca bir kez gösterilir. Sunucunun gizli bilgi deposunda sakla. Bkz. API anahtarları ve güvenlik.

2. Kimlik doğrulama

Temel adres https://smsgrab.com/api/dev/v1. Anahtarı bearer token olarak ya da X-Api-Key başlığında gönder:

HTTP
GET /api/dev/v1/balance HTTP/1.1
Host: smsgrab.com
Authorization: Bearer sgk_your_key_here

Anahtarlar sunucularda durmalı. Onları asla bir web sitesine, tarayıcı eklentisine ya da başkalarına verdiğin bir uygulamaya koyma.

3. Bakiyeni ve fiyatları kontrol et

Bash
export SMSGRAB_KEY="sgk_your_key_here"

curl -s https://smsgrab.com/api/dev/v1/balance \
  -H "Authorization: Bearer $SMSGRAB_KEY"
Bash
curl -s "https://smsgrab.com/api/dev/v1/prices?service=whatsapp&country=indonesia" \
  -H "Authorization: Bearer $SMSGRAB_KEY"

Tutarlar her zaman USD'nin küçük birimleriyle verilir; yani 24, 0,24 USD demektir. price_minor toptan indirimin dahil senin fiyatın, retail_price_minor uygulamadaki liste fiyatıdır.

JSON
{ "currency": "USD", "discount_percent": 5,
  "items": [ { "service_id": "whatsapp", "country_id": "indonesia", "price_minor": 24,
               "retail_price_minor": 25, "available_numbers": 30412 } ] }

4. Numara satın al

Bash
curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
  -H "Authorization: Bearer $SMSGRAB_KEY" \
  -H "Idempotency-Key: order-7f3c2a" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"indonesia","max_price_minor":24}'
  • service ve country bizim kimliklerimizi alır, örneğin whatsapp ve indonesia. Ülkelerde ID gibi ISO kodları da geçer.
  • max_price_minor seni korur: fiyat yükseldiyse hiçbir ücret alınmaz ve 409 PRICE_CHANGED yanıtı döner.
  • Idempotency-Key yeniden denemeleri güvenli yapar. Aynı anahtarla tekrarlanan istek iki kez satın almak yerine ilk sonucu döndürür.

Yanıt, aktivasyonla birlikte 201 Created olur:

JSON
{ "id": "5c1d0c2e-8a41-4f7e-9d7a-2f1d9f1b8c11", "compat_id": 100000123, "status": "WAITING_SMS",
  "service_id": "whatsapp", "country_id": "indonesia", "phone_number": "+6281234567890",
  "price_minor": 24, "currency": "USD",
  "created_at": "2026-09-27T10:05:00.000Z", "expires_at": "2026-09-27T10:25:00.000Z",
  "refunded": false, "refund_minor": 0, "sms": [] }

5. SMS'i bekle

Sık aralıklarla sorgulamak yerine API'nin isteği bir değişiklik olana kadar, en fazla 30 saniye bekletmesini sağla:

Bash
curl -s "https://smsgrab.com/api/dev/v1/activations/100000123?wait=25" \
  -H "Authorization: Bearer $SMSGRAB_KEY"

Bir mesaj geldiğinde status değeri CODE_RECEIVED olur ve sms o ana kadarki tüm mesajları içerir:

JSON
{ "status": "CODE_RECEIVED",
  "sms": [ { "code": "482913", "text": "Your WhatsApp code is 482-913", "sender": "WhatsApp",
             "received_at": "2026-09-27T10:06:12.004Z" } ] }

Sorgulamak yerine bildirim mi tercih edersin? Webhook kur.

6. Bitir ya da iptal et

Bash
curl -s -X POST https://smsgrab.com/api/dev/v1/activations/100000123/finish \
  -H "Authorization: Bearer $SMSGRAB_KEY"

curl -s -X POST https://smsgrab.com/api/dev/v1/activations/100000123/cancel \
  -H "Authorization: Bearer $SMSGRAB_KEY"
  • Kodu kullandıktan sonra finish. Yalnızca bir kod geldikten sonra kabul edilir.
  • Hâlâ ilk kodu beklerken cancel. Ücretin tamamı iade edilir.
  • Hiçbir şey yapmazsan kod almayan numaranın süresi expires_at zamanında dolar ve otomatik olarak iade edilir. Bu süre servise ve ülkeye göre değişir; sabit bir süre varsaymak yerine her zaman expires_at değerini oku.

Durum değerleri

Durum Anlamı
WAITING_SMS Satın alındı, ilk mesaj bekleniyor
CODE_RECEIVED En az bir mesaj geldi
COMPLETED Sen bitirdin ya da koddan sonra süre doldu
CANCELLED Koddan önce iptal edildi, iade edildi
EXPIRED expires_at zamanına kadar kod gelmedi, iade edildi

Hatalar

Her hata aynı biçimdedir. code ve reason değerine göre hareket et, henüz bilmediğin nedenleri yok say:

JSON
{ "code": "NO_NUMBERS_AVAILABLE", "message": "No numbers available for this service and country", "reason": "OUT_OF_STOCK" }

Sık görülen durumlar: 402 INSUFFICIENT_BALANCE, 409 NO_NUMBERS_AVAILABLE, 409 PRICE_CHANGED, ACTIVATION_LIMIT_REACHED ile 422 (hesap başına aynı anda en fazla 100 numara kod bekleyebilir) ve Retry-After başlığıyla 429 RATE_LIMITED.

Tam başvuru kaynağı geliştirici belgelerinde.

Bu makale işine yaradı mı?

Hâlâ yardıma mı ihtiyacın var?

Bize yaz. Her mesajı yanıtlıyoruz, genellikle birkaç saat içinde.

Ya da e-posta gönder: support@smsgrab.com