API kích hoạt SMS
Mua số điện thoại và đọc mã từ các tập lệnh của bạn. API sử dụng định dạng kích hoạt SMS phổ biến, vì vậy hầu hết các client hiện có đều hoạt động bằng cách thay đổi địa chỉ cơ sở và khóa.
Tạo khóa API của bạn trên trang khóa API trong bảng điều khiển. Nó chỉ được hiển thị một lần.
Địa chỉ cơ sở và khóa
Gửi yêu cầu GET hoặc POST đến địa chỉ cơ sở với api_key và action. Tạo khóa trên trang Khóa API trong bảng điều khiển; khóa chỉ hiển thị một lần.
https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance
Mã dịch vụ là tên trên trang dịch vụ của chúng tôi (ví dụ whatsapp, telegram, google). Mã quốc gia là mã ISO viết thường (us, gb, in). Giới hạn: 300 yêu cầu mỗi phút mỗi khóa. Mỗi kích hoạt có thời gian chờ 20 phút, giống như trong bảng điều khiển.
getBalance
Số dư của bạn bằng USD.
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance
ACCESS_BALANCE:12.50
getServicesList
Mã dịch vụ bạn có thể mua (JSON).
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList
{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}getCountries
Mã quốc gia (ISO, viết thường) và mã quay số (JSON).
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries
{"us":{"name":"United States","dial":"1"}}getPrices
Giá bằng USD và số lượng tồn kho theo quốc gia và dịch vụ. Cả hai bộ lọc đều là tùy chọn.
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
Mua một kích hoạt. Trả về id kích hoạt và số điện thoại với mã quốc gia.
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 (chưa có mã), STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code> (yêu cầu mã khác), STATUS_CANCEL (đã hủy hoặc hoàn tiền).
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB
STATUS_OK:482913
setStatus
status=1 sẵn sàng (ACCESS_READY), 3 mã khác (ACCESS_RETRY_GET), 6 hoàn tất (ACCESS_ACTIVATION), 8 hủy với hoàn tiền đầy đủ khi chưa nhận mã (ACCESS_CANCEL).
GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3
ACCESS_RETRY_GET
Quy trình điển hình
- getNumber với dịch vụ và quốc gia. Lưu id.
- Nhập số vào ứng dụng và yêu cầu SMS.
- Gọi getStatus mỗi 5 đến 10 giây cho đến khi STATUS_OK.
- Cần SMS khác? setStatus 3, sau đó getStatus lại. Xong: setStatus 6.
- Không có mã? setStatus 8 hủy với hoàn tiền đầy đủ. Nếu không gọi, hoàn tiền tự động khi thời gian chờ kết thúc.
Lỗi
| BAD_KEY | Thiếu hoặc sai khóa API. |
| BAD_ACTION | Hành động không xác định. |
| BAD_SERVICE | Mã dịch vụ không xác định. |
| BAD_COUNTRY | Dịch vụ không được bán tại quốc gia đó. |
| NO_BALANCE | Không đủ số dư. |
| NO_NUMBERS | Hiện không có số nào khả dụng. Thử lại sau. |
| NO_ACTIVATION | Id kích hoạt không xác định hoặc không thuộc về bạn. |
| EARLY_CANCEL_DENIED | Mã đã được gửi, không thể hủy kích hoạt. |
| TOO_MANY_REQUESTS | Hơn 300 yêu cầu trong một phút. |
| NO_ACTIVATIONS | Đã có 20 kích hoạt đang mở. |