SMSBulk
API Referansı

SMSBulk ile geliştirin

Modern REST API ve SMS-Activate uyumlu endpoint'ler. Birkaç dakikada başlayın.

API Referansını AçAPI Anahtarı Al

İki API stili

Projenize uyan formatı seçin — ikisi de aynı altyapıyla çalışır.

Modern REST API

OpenAPI ile JSON tabanlı temiz API. Yeni entegrasyonlar için ideal.

  • JSON istek ve cevap gövdeleri
  • /api/docs adresinde OpenAPI 3.0 şeması
  • Bearer token veya x-api-key kimlik doğrulaması
  • Standart HTTP durum kodları
curl https://smsbulk.net/api/v1/wallet/balance \
  -H "x-api-key: YOUR_KEY"

Eski API Uyumlu

Sektör standardı query tabanlı protokolle uyumlu. Mevcut bot script'leri ve kütüphaneler kod değişikliği olmadan çalışır — sadece base URL'i bizimkine yönlendir.

  • Aynı aksiyon tabanlı protokol
  • Plain text cevap formatı
  • Mevcut bot kütüphaneleriyle uyumlu
  • Kanonik country ID eşlemesi korunur
curl "https://smsbulk.net/stubs/handler_api.php\
?api_key=YOUR_KEY&action=getBalance"
Geçiş rehberi

Hızlı Başlangıç

Sıfırdan ilk SMS'e 5 dakikadan kısa sürede.

1

API anahtarınızı alın

Panelden bir API anahtarı oluşturun. Her kullanıcı en fazla 10 anahtar oluşturabilir.

Paneli aç
2

Kimlik doğrulamayı test edin

Cüzdan bakiyenizi kontrol ederek anahtarınızın çalıştığını doğrulayın.

curl https://smsbulk.net/api/v1/wallet/balance \
  -H "x-api-key: YOUR_KEY"

# Response:
# { "balance": "10.00", "currency": "USD" }
3

Numara satın alın

SMS doğrulama için sanal numara ayırtın. Ücret cüzdanınızdan düşer.

curl -X POST https://smsbulk.net/api/v1/activations \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceCode": "wa",
    "countryIso": "TR"
  }'

# Response:
# {
#   "id": "cuid_xxx",
#   "phoneNumber": "905551234567",
#   "status": "WAITING",
#   "userCost": "0.50"
# }
4

SMS'i bekleyin

Activation endpoint'ini RECEIVED durumuna gelene kadar yoklayın. SMS kodu cevap içinde olur.

curl https://smsbulk.net/api/v1/activations/cuid_xxx \
  -H "x-api-key: YOUR_KEY"

# Response (when SMS arrives):
# {
#   "id": "cuid_xxx",
#   "smsCode": "123456",
#   "status": "RECEIVED",
#   ...
# }

Kimlik Doğrulama

API anahtarınızı göndermenin üç yolu.

Ortamınıza uygun yöntemi seçin

1. Header (önerilen)

x-api-key: YOUR_API_KEY

Standart header tabanlı kimlik doğrulama. Hem REST hem SMS-Activate endpoint'lerinde çalışır.

2. Bearer token

Authorization: Bearer YOUR_API_KEY

Authorization header'ı kullanan HTTP istemci kütüphaneleriyle uyumlu.

3. Query string

?api_key=YOUR_API_KEY

SMS-Activate uyumluluk endpoint'i /stubs/handler_api.php için zorunlu.

Anahtarlarınızı gizli tutun

API anahtarlarını hiçbir zaman public repo'ya commit'lemeyin veya istemci tarafı kodda açmayın. Her anahtarın günlük kotası vardır — sızdırılmışsa hemen yenileyin.

Referanslar

Eski API Geçiş Rehberi

Mevcut bot entegrasyonlarını taşımak için drop-in uyumluluk dokümantasyonu. Action listesi, country ID'leri, hata kodları.

Hatalar ve Rate Limits

Tam hata kodu referansı, rate limit politikaları, retry stratejileri ve idempotency rehberi.

Yayınlamaya hazır mısınız?

Interaktif API referansını açın ve her endpoint'i tarayıcınızda canlı deneyin.

API Referansını AçBaşla