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
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:
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
export SMSGRAB_KEY="sgk_your_key_here"
curl -s https://smsgrab.com/api/dev/v1/balance \
-H "Authorization: Bearer $SMSGRAB_KEY"
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.
{ "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
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}'
servicevecountrybizim kimliklerimizi alır, örneğinwhatsappveindonesia. ÜlkelerdeIDgibi ISO kodları da geçer.max_price_minorseni korur: fiyat yükseldiyse hiçbir ücret alınmaz ve409 PRICE_CHANGEDyanıtı döner.Idempotency-Keyyeniden 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:
{ "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:
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:
{ "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
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_atzamanı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 zamanexpires_atdeğ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:
{ "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ı?
Teşekkürler! İşine yaradığına sevindik.