API

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

  1. getNumber với dịch vụ và quốc gia. Lưu id.
  2. Nhập số vào ứng dụng và yêu cầu SMS.
  3. Gọi getStatus mỗi 5 đến 10 giây cho đến khi STATUS_OK.
  4. Cần SMS khác? setStatus 3, sau đó getStatus lại. Xong: setStatus 6.
  5. 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_KEYThiếu hoặc sai khóa API.
BAD_ACTIONHành động không xác định.
BAD_SERVICEMã dịch vụ không xác định.
BAD_COUNTRYDịch vụ không được bán tại quốc gia đó.
NO_BALANCEKhông đủ số dư.
NO_NUMBERSHiện không có số nào khả dụng. Thử lại sau.
NO_ACTIVATIONId kích hoạt không xác định hoặc không thuộc về bạn.
EARLY_CANCEL_DENIEDMã đã được gửi, không thể hủy kích hoạt.
TOO_MANY_REQUESTSHơn 300 yêu cầu trong một phút.
NO_ACTIVATIONSĐã có 20 kích hoạt đang mở.
API Kích hoạt SMS: getNumber, getStatus, setStatus