API thuê số điện thoại

Thuê số, đọc SMS đến, gia hạn và hủy từ mã của riêng bạn. JSON qua HTTPS với một khóa API từ bảng điều khiển.

URL cơ sở: https://snsnumber.com/api/v1
Xác thực: Authorization: Bearer snk_...
Giới hạn tốc độ: 300 yêu cầu mỗi phút cho mỗi khóa

Tạo khóa trong bảng điều khiển mục API. Giá tính bằng đô la Mỹ dưới dạng chuỗi với hai số thập phân. Thời gian theo ISO 8601 tính theo UTC.

Điểm cuối

GET/balanceSố dư của bạn bằng đô la Mỹ.

{ "balance": "120.00", "currency": "USD" }

GET/prices?country=usQuốc gia, thời gian và giá cả. Bỏ trống quốc gia để xem tất cả.

{ "currency": "USD", "countries": [ { "country": "us", "name": "United States", "dial": "+1",
  "periods": [ { "days": 15, "price": "36.00" }, { "days": 30, "price": "54.00" } ] } ] }

POST/rentalsThuê một số. Nội dung: quốc gia và số ngày.

curl -X POST https://snsnumber.com/api/v1/rentals -H "Authorization: Bearer snk_..." \
  -H "Content-Type: application/json" -d '{"country":"us","days":30}'

{ "rental": { "id": "RN-7KQ2M9XWD4", "country": "us", "phone": "+14155550123", "state": "active",
  "days": 30, "ends_at": "2026-12-03T10:00:00.000Z", "can_cancel": true, "messages": [] } }

GET/rentals?state=activeSố thuê của bạn, mới nhất trước (trạng thái: đang hoạt động, đã hết hạn, đã hủy).

{ "rentals": [ { "id": "RN-7KQ2M9XWD4", "phone": "+14155550123", "state": "active", "message_count": 2 } ] }

GET/rentals/{id}Một số thuê với hộp thư đến của nó.

{ "rental": { "id": "RN-7KQ2M9XWD4", "messages": [ { "id": 18, "sender": "Verify",
  "text": "Your verification code is 482913.", "code": "482913", "received_at": "2026-11-03T10:01:12.000Z" } ] } }

POST/rentals/{id}/extendThêm thời gian vào một số thuê đang hoạt động. Nội dung: ngày.

{"days":15}  ->  { "rental": { "id": "RN-7KQ2M9XWD4", "extensions": 1, "ends_at": "2026-12-18T10:00:00.000Z" } }

POST/rentals/{id}/cancelHoàn tiền đầy đủ trong vòng 20 phút nếu chưa có SMS nào đến.

{ "rental": { "id": "RN-7KQ2M9XWD4", "state": "canceled" } }

Lỗi

Lỗi trả về trạng thái HTTP và { "error": { "code", "message" } }.

Trạng thái	Mã	Ý nghĩa
401	no_key, bad_key	Thiếu hoặc sai khóa API
402	no_balance	Không đủ số dư
404	not_found	Không tìm thấy số thuê
409	ended, cancel_denied	Số thuê đã kết thúc hoặc thời gian hủy đã qua
429	rate_limited, too_many_active	300 yêu cầu mỗi phút, hoặc 20 số đang hoạt động
503	network_error	Thử lại sau một lúc