API

API pengaktifan SMS

Beli nombor dan baca kod dari skrip anda sendiri. API menggunakan format pengaktifan SMS biasa, jadi kebanyakan klien sedia ada berfungsi dengan menukar alamat asas dan kunci.

Buat kunci API pada halaman kunci API di konsol. Ia dipaparkan sekali sahaja.

Dapatkan kunci API Daftar

Alamat asas dan kunci

Hantar permintaan GET atau POST ke alamat asas dengan api_key dan action. Buat kunci pada halaman Kunci API di konsol; ia hanya dipaparkan sekali.

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

Kod perkhidmatan adalah nama pada halaman perkhidmatan kami (contohnya whatsapp, telegram, google). Kod negara adalah kod ISO dalam huruf kecil (us, gb, in). Had: 300 permintaan seminit setiap kunci. Setiap pengaktifan mempunyai tempoh 20 minit, sama seperti di konsol.

getBalance

Baki kredit anda dalam USD.

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

ACCESS_BALANCE:12.50

getServicesList

Kod perkhidmatan yang boleh dibeli (JSON).

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

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries

Kod negara (ISO, huruf kecil) dan kod dail (JSON).

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

{"us":{"name":"United States","dial":"1"}}

getPrices

Harga dalam USD dan jumlah stok setiap negara dan perkhidmatan. Kedua-dua penapis adalah pilihan.

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

Membeli pengaktifan. Mengembalikan id pengaktifan dan nombor dengan kod negara.

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 (tiada kod lagi), STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code> (kod lain diminta), STATUS_CANCEL (dibatalkan atau dibayar balik).

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

STATUS_OK:482913

setStatus

status=1 sedia (ACCESS_READY), 3 kod lain (ACCESS_RETRY_GET), 6 selesai (ACCESS_ACTIVATION), 8 batal dengan bayaran balik penuh semasa tiada kod diterima (ACCESS_CANCEL).

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

ACCESS_RETRY_GET

Aliran tipikal

getNumber dengan perkhidmatan dan negara. Simpan id.
Masukkan nombor dalam aplikasi dan minta SMS.
Panggil getStatus setiap 5 hingga 10 saat sehingga STATUS_OK.
Perlukan SMS lain? setStatus 3, kemudian getStatus lagi. Selesai: setStatus 6.
Tiada kod? setStatus 8 membatalkan dengan bayaran balik penuh. Tanpa panggilan, bayaran balik berlaku sendiri apabila tempoh tamat.

Ralat

BAD_KEY	Kunci API hilang atau salah.
BAD_ACTION	Tindakan tidak diketahui.
BAD_SERVICE	Kod perkhidmatan tidak diketahui.
BAD_COUNTRY	Perkhidmatan tidak dijual di negara itu.
NO_BALANCE	Kredit tidak mencukupi.
NO_NUMBERS	Tiada nombor tersedia sekarang. Cuba sebentar lagi.
NO_ACTIVATION	Id pengaktifan tidak diketahui, atau bukan milik anda.
EARLY_CANCEL_DENIED	Kod telah diterima, jadi pengaktifan tidak boleh dibatalkan.
TOO_MANY_REQUESTS	Lebih daripada 300 permintaan dalam seminit.
NO_ACTIVATIONS	20 pengaktifan sudah dibuka.