API

API do aktywacji SMS

Kupuj numery i czytaj kody z własnych skryptów. API używa wspólnego formatu aktywacji SMS, więc większość istniejących klientów działa po zmianie podstawowego adresu i klucza.

Utwórz swój klucz API na stronie klucza API w konsoli. Jest pokazywany tylko raz.

Pobierz klucz API Zarejestruj się

Podstawowy adres i klucz

Wysyłaj żądania GET lub POST na podstawowy adres z api_key i action. Utwórz klucz na stronie Klucz API w konsoli; jest wyświetlany tylko raz.

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

Kody usług to nazwy na naszych stronach usług (na przykład whatsapp, telegram, google). Kody krajów to kody ISO małymi literami (us, gb, in). Limit: 300 żądań na minutę na klucz. Każda aktywacja ma 20 minutowy okres oczekiwania, taki sam jak w konsoli.

getBalance

Twoje saldo w USD.

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

ACCESS_BALANCE:12.50

getServicesList

Kody usług, które możesz kupić (JSON).

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

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

getCountries

Kody krajów (ISO, małe litery) i kody wybierania (JSON).

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

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

getPrices

Ceny w USD i liczba dostępnych numerów według kraju i usługi. Oba filtry są opcjonalne.

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

Kupuje aktywację. Zwraca ID aktywacji i numer z kodem kraju.

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 (brak kodu), STATUS_OK:<code>, STATUS_WAIT_RETRY:<ostatni kod> (wysłano prośbę o kolejny kod), STATUS_CANCEL (anulowano lub zwrócono środki).

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

STATUS_OK:482913

setStatus

status=1 gotowy (ACCESS_READY), 3 kolejny kod (ACCESS_RETRY_GET), 6 zakończ (ACCESS_ACTIVATION), 8 anuluj z pełnym zwrotem, gdy nie dotarł kod (ACCESS_CANCEL).

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

ACCESS_RETRY_GET

Typowy przepływ

Wywołaj getNumber z usługą i krajem. Zapisz ID.
Wprowadź numer w aplikacji i poproś o SMS.
Wywołuj getStatus co 5-10 sekund, aż STATUS_OK.
Potrzebujesz kolejnego SMS? setStatus 3, potem getStatus ponownie. Gotowe: setStatus 6.
Brak kodu? setStatus 8 anuluje z pełnym zwrotem. Bez wywołania, zwrot następuje automatycznie po zakończeniu okresu oczekiwania.

Błędy

BAD_KEY	Brakujący lub błędny klucz API.
BAD_ACTION	Nieznana akcja.
BAD_SERVICE	Nieznany kod usługi.
BAD_COUNTRY	Usługa nie jest sprzedawana w tym kraju.
NO_BALANCE	Niewystarczające saldo.
NO_NUMBERS	Brak dostępnego numeru. Spróbuj za chwilę.
NO_ACTIVATION	Nieznane ID aktywacji lub nie należy do Ciebie.
EARLY_CANCEL_DENIED	Kod już dotarł, więc aktywacja nie może być anulowana.
TOO_MANY_REQUESTS	Ponad 300 żądań w ciągu minuty.
NO_ACTIVATIONS	20 aktywacji jest już otwartych.