Dokumentacja API
handler_api zgodne z sms-activate: te same akcje, statusy, kody krajów i serwisów oraz webhook kodów.
URL handler_api
https://allinsms.com/stubs/handler_api.php
Adres bazowy REST API
https://allinsms.com/v1
Numery (handler_api)
GET lub POST z api_key i action. Kraje mają standardowe identyfikatory liczbowe (getCountries), a serwisy standardowe kody (tg, wa, go …). Odpowiedzi to zwykły tekst, chyba że zaznaczono inaczej.
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | Parametry | Odpowiedź | Opis |
|---|---|---|---|
| getBalance | Brak | ACCESS_BALANCE:12.3400 | Aktualne saldo w USD. |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | Kup numer. Opłata pobierana od razu, zwrot, jeśli kod nie przyjdzie. |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | Jak getNumber, odpowiedź JSON z ceną i czasem zakończenia. |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | Odpytuj co 3 do 5 sekund, aż przyjdzie kod. |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | Status w JSON z pełną treścią SMS. |
| getFullSms | id | FULL_SMS:Your code is 48213 | Pełna treść ostatniego SMS. |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 gotowe, 3 kolejny kod, 6 zakończ, 8 anuluj (po czasie oczekiwania, przed kodem). |
| getActiveActivations | Brak | {"status":"success","activeActivations":[…]} | Twoje wciąż aktywne numery. |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | Ceny i dostępność według kraju i serwisu. |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | Dostępność według serwisu dla danego kraju. |
| getCountries | Brak | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | Lista krajów z identyfikatorami. |
| getServicesList | Brak | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | Kody i nazwy serwisów. |
Wartości setStatus
- 1 · Numer wysłany do serwisu, oczekiwanie na SMS
- 3 · Poproś o kolejny kod na ten sam numer
- 6 · Zakończ aktywację
- 8 · Anuluj i zwróć środki (jeszcze bez kodu)
Czas
Numery są domyślnie aktywne przez 20 minut. Anulowanie jest możliwe 120 sekund po zakupie (wcześniej zwraca EARLY_CANCEL_DENIED). Bez kodu aktywacja jest automatycznie zwracana po zakończeniu. Limit: 300 zapytań na minutę na klucz.
Błędy
Webhook
Ustaw URL webhooka w zakładce Konto, a każdy odebrany kod wyślemy na niego metodą POST jako JSON, ponawiając dwa razy, jeśli Twój serwer nie odpowie kodem 2xx.
POST https://your-server/webhook
{ "activationId": 1042, "service": "tg", "country": "id", "phone": "6281244739021",
"code": "48213", "text": "Telegram code: 48213 …", "receivedAt": "2026-10-09T03:12:44.000Z" }