Doğrudan Uyumlu

Eski API Uyumluluğu

Halihazırda sms-activate.org veya benzeri bir servis kullanıyorsan, sadece base URL'ini değiştirerek SMSBulk'a geç. Tüm endpoint'ler, action isimleri ve cevap formatları aynı kalır.

Tek satırda geçiş

https://sms-activate.org/stubs/handler_api.php

https://smsbulk.net/stubs/handler_api.php

Mevcut script'lerin, bot kütüphanelerin ve entegrasyonların kod değişikliği olmadan çalışır. Country ID'ler kanonik eşlemeye uyar (TR=187, US=12, RU=0, vb.).

Kimlik Doğrulama

SMS-Activate'tekiyle aynı: API anahtarını query string parametresi olarak geçir.

# Query string (sms-activate convention)
curl "https://smsbulk.net/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance"

# Response (plain text)
ACCESS_BALANCE:42.50

Aksiyon Referansı

7 aksiyonun hepsi destekleniyor. Aksiyon isimleri, parametreler ve cevap formatları SMS-Activate ile birebir.

getBalance

Cüzdan bakiyenizi USD olarak döndürür.

İstek

GET /stubs/handler_api.php?api_key=KEY&action=getBalance

Cevap

ACCESS_BALANCE:42.50

getNumber

Sanal telefon numarası ayırtır. Gerekli: service kodu (wa/tg/ig/vb.) ve country (integer ID, ISO kodu veya slug).

İstek

GET /stubs/handler_api.php?api_key=KEY&action=getNumber&service=wa&country=187

Cevap

ACCESS_NUMBER:12345678:79991234567

getStatus

Activation durumunu sorgular. STATUS_WAIT_CODE, STATUS_OK:<kod> veya STATUS_CANCEL döner.

İstek

GET /stubs/handler_api.php?api_key=KEY&action=getStatus&id=12345678

Cevap

STATUS_OK:123456

setStatus

Activation durumunu günceller. status=1 (SMS gönderildi), 3 (yeni SMS iste), 6 (tamamla), 8 (iptal).

İstek

GET /stubs/handler_api.php?api_key=KEY&action=setStatus&id=12345678&status=6

Cevap

ACCESS_ACTIVATION

getNumbersStatus

Service-country kombinasyonu başına stok sayısını döndürür. 'wa_187' formatında key'leri olan JSON dict.

İstek

GET /stubs/handler_api.php?api_key=KEY&action=getNumbersStatus&country=187

Cevap

{"wa_187":1234,"tg_187":567}

getPrices

Service+country kombinasyonları için fiyat ve stok. Country ID'ye göre nested JSON.

İstek

GET /stubs/handler_api.php?api_key=KEY&action=getPrices&service=wa&country=187

Cevap

{"187":{"wa":{"cost":0.5,"count":1234}}}

getCountries

Desteklenen country'lerin SMS-Activate ID ve ISO kodlu kanonik listesi.

İstek

GET /stubs/handler_api.php?api_key=KEY&action=getCountries

Cevap

[{"id":187,"iso":"TR"},...]

setStatus Değerleri

Her status kodunun ne yaptığı ve hangi cevabı aldığınız.

Değer	Aksiyon	Cevap
1	SMS gönderildi raporla (no-op)	ACCESS_READY
3	Yeni SMS iste	ACCESS_RETRY_GET
6	Activation'ı tamamla	ACCESS_ACTIVATION
8	Activation'ı iptal et	ACCESS_CANCEL

Country ID'leri

Kanonik SMS-Activate ID'leri korundu. Popüler ülkeler:

Turkey

ID: 187 · ISO: TR

Russia

ID: 0 · ISO: RU

USA

ID: 12 · ISO: US

United Kingdom

ID: 16 · ISO: GB

Germany

ID: 42 · ISO: DE

France

ID: 77 · ISO: FR

India

ID: 22 · ISO: IN

Brazil

ID: 72 · ISO: BR

Üçlü format desteği: Country parametresi integer ID (187), ISO kodu (TR) veya slug (turkey) kabul eder.

Hata Kodları

Tüm hatalar plain text kod döner (text/plain). Asla çevirilmez — bot kütüphanesi uyumluluğu için.

Kod	Anlamı
BAD_KEY	Geçersiz veya eksik API anahtarı
BAD_ACTION	Action parametresi eksik veya hatalı
BAD_SERVICE	Service kodu tanınmıyor
BAD_COUNTRY	Country parametresi tanınmıyor
BAD_STATUS	setStatus için geçersiz status değeri
WRONG_ACTION	Action ismi desteklenmiyor
NO_BALANCE	Yetersiz cüzdan bakiyesi
NO_NUMBERS	Bu service+country için numara yok
NO_ACTIVATION	Activation ID bulunamadı veya size ait değil
RATE_LIMITED	Günlük API kotası aşıldı — Retry-After header'ına bak
ERROR_SQL	İç sunucu hatası

Bot kütüphanesi uyumluluğu: Hata kodları kararlı tanımlayıcılardır, asla çevirilmez. Bu string'leri match eden mevcut script'ler değişiklik gerektirmeden çalışır.

HTTP status eşlemesi ve retry stratejilerine bak

Geçişe hazır mısın?

API anahtarını al ve tek bir curl komutuyla başla. SDK kurulumu yok, kod değişikliği yok.

API Anahtarı Al Doküman'a Dön