API

SMS aktivasyon API

Kendi scriptlerinizden numaralar satın alın ve kodları okuyun. API, ortak SMS aktivasyon formatını kullanır, bu nedenle mevcut çoğu istemci temel adresi ve anahtarı değiştirerek çalışır.

API anahtarınızı konsolun API anahtarı sayfasında oluşturun. Bir kez gösterilir.

Temel adres ve anahtar

api_key ve action ile birlikte temel adrese GET veya POST istekleri gönderin. Anahtarı konsolun API anahtarı sayfasında oluşturun; yalnızca bir kez gösterilir.

https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

Servis kodları, servis sayfalarımızdaki isimlerdir (örneğin whatsapp, telegram, google). Ülke kodları küçük harfli ISO kodlarıdır (us, gb, in). Limit: her anahtar için dakikada 300 istek. Her aktivasyonun, konsoldaki gibi 20 dakikalık bir penceresi vardır.

getBalance

USD cinsinden bakiyeniz.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance
ACCESS_BALANCE:12.50

getServicesList

Satın alabileceğiniz servis kodları (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList
{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries

Ülke kodları (ISO, küçük harf) ve telefon kodları (JSON).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries
{"us":{"name":"United States","dial":"1"}}

getPrices

Ülke ve servise göre USD fiyatları ve stok adetleri. Her iki filtre de isteğe bağlıdır.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us
{"us":{"whatsapp":{"cost":0.18,"count":130598}}}

getNumber

Bir aktivasyon satın alır. Aktivasyon kimliğini ve ülke koduyla birlikte numarayı döndürür.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us
ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182

getStatus

STATUS_WAIT_CODE (henüz kod gelmedi), STATUS_OK:<code>, STATUS_WAIT_RETRY:<son kod> (başka bir kod istendi), STATUS_CANCEL (iptal edildi veya iade edildi).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB
STATUS_OK:482913

setStatus

status=1 hazır (ACCESS_READY), 3 başka bir kod (ACCESS_RETRY_GET), 6 bitir (ACCESS_ACTIVATION), 8 kod gelmeden tam iade ile iptal (ACCESS_CANCEL).

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3
ACCESS_RETRY_GET

Tipik akış

  1. Servis ve ülke ile getNumber çağırın. Kimliği kaydedin.
  2. Numarayı uygulamaya girin ve SMS isteyin.
  3. STATUS_OK alana kadar her 5-10 saniyede bir getStatus çağırın.
  4. Başka bir SMS mi gerekiyor? setStatus 3, ardından tekrar getStatus. Bitti: setStatus 6.
  5. Kod gelmedi mi? setStatus 8 tam iade ile iptal eder. Çağrı olmazsa, pencere sona erdiğinde iade otomatik olarak yapılır.

Hatalar

BAD_KEYEksik veya yanlış API anahtarı.
BAD_ACTIONBilinmeyen işlem.
BAD_SERVICEBilinmeyen servis kodu.
BAD_COUNTRYBu servis o ülkede satılmıyor.
NO_BALANCEYeterli bakiye yok.
NO_NUMBERSŞu an uygun numara yok. Biraz sonra tekrar deneyin.
NO_ACTIVATIONBilinmeyen aktivasyon kimliği veya size ait değil.
EARLY_CANCEL_DENIEDZaten bir kod geldi, bu yüzden aktivasyon iptal edilemez.
TOO_MANY_REQUESTSBir dakikada 300'den fazla istek.
NO_ACTIVATIONSZaten 20 aktivasyon açık.
SMS Aktivasyon API: getNumber, getStatus, setStatus