handler_api tương thích sms-activate: cùng action, trạng thái, mã quốc gia và mã dịch vụ, kèm webhook nhận mã.
URL handler_api
https://allinsms.com/stubs/handler_api.php
Địa chỉ gốc REST API
https://allinsms.com/api/v1
GET hoặc POST với api_key và action. Quốc gia dùng id số chuẩn (getCountries) và dịch vụ dùng mã chuẩn (tg, wa, go …). Phản hồi là văn bản thuần trừ khi có ghi chú.
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | Tham số | Phản hồi | Mô tả |
|---|---|---|---|
| getBalance | Không có | ACCESS_BALANCE:12.3400 | Số dư hiện tại tính bằng USD. |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | Mua một số. Trừ tiền ngay, hoàn tiền nếu không có mã. |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | Giống getNumber, phản hồi JSON kèm giá và thời điểm kết thúc. |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | Truy vấn mỗi 3 đến 5 giây cho đến khi có mã. |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | Trạng thái dạng JSON kèm toàn văn SMS. |
| getFullSms | id | FULL_SMS:Your code is 48213 | Toàn văn SMS gần nhất. |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 sẵn sàng, 3 mã khác, 6 hoàn tất, 8 hủy (sau thời gian chờ, trước khi có mã). |
| getActiveActivations | Không có | {"status":"success","activeActivations":[…]} | Các số của bạn còn đang hoạt động. |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | Giá và số lượng theo quốc gia và dịch vụ. |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | Số lượng theo dịch vụ của một quốc gia. |
| getCountries | Không có | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | Danh sách quốc gia kèm id. |
| getServicesList | Không có | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | Mã và tên dịch vụ. |
Giá trị setStatus
Thời gian
Mặc định số hoạt động 20 phút. Chỉ chấp nhận hủy sau 120 giây kể từ khi mua (sớm hơn sẽ trả về EARLY_CANCEL_DENIED). Nếu không có mã, lượt kích hoạt được hoàn tiền tự động khi kết thúc. Giới hạn: 300 yêu cầu mỗi phút cho mỗi key.
Đặt URL webhook trong Tài khoản và chúng tôi sẽ POST mọi mã nhận được dưới dạng JSON, thử lại hai lần nếu máy chủ của bạn không trả về 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" }