Документація API
handler_api, сумісний з sms-activate: ті самі дії, статуси, коди країн і сервісів, а також вебхук кодів.
URL handler_api
https://allinsms.com/stubs/handler_api.php
Базова адреса REST API
https://allinsms.com/v1
Номери (handler_api)
GET або POST з api_key і action. Країни задаються стандартними числовими id (getCountries), сервіси стандартними кодами (tg, wa, go …). Відповіді у вигляді простого тексту, якщо не вказано інше.
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | Параметри | Відповідь | Опис |
|---|---|---|---|
| getBalance | Немає | ACCESS_BALANCE:12.3400 | Поточний баланс в USD. |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | Купити номер. Списання одразу, повернення, якщо код не надійде. |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | Те саме, що getNumber, відповідь у JSON з ціною та часом завершення. |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | Опитуйте кожні 3 до 5 секунд, доки не надійде код. |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | Статус у JSON з повним текстом SMS. |
| getFullSms | id | FULL_SMS:Your code is 48213 | Повний текст останнього SMS. |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 готово, 3 ще один код, 6 завершити, 8 скасувати (після часу очікування, до надходження коду). |
| getActiveActivations | Немає | {"status":"success","activeActivations":[…]} | Ваші номери, які ще активні. |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | Ціни та наявність за країнами та сервісами. |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | Наявність за сервісами для країни. |
| getCountries | Немає | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | Список країн з id. |
| getServicesList | Немає | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | Коди та назви сервісів. |
Значення setStatus
- 1 · Номер передано в сервіс, очікування SMS
- 3 · Запросити ще один код на той самий номер
- 6 · Завершити активацію
- 8 · Скасувати й повернути кошти (коду ще немає)
Час
За замовчуванням номери активні 20 хвилин. Скасування приймається через 120 секунд після покупки (раніше повертається EARLY_CANCEL_DENIED). Без коду кошти за активацію автоматично повертаються після її завершення. Ліміт: 300 запитів на хвилину на ключ.
Помилки
Вебхук
Вкажіть URL вебхука в розділі Акаунт, і ми надсилатимемо на нього POST з кожним отриманим кодом у JSON, з двома повторними спробами, якщо ваш сервер не відповість 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" }