Tài Liệu API

1.1 Ví dụ gửi đi

https://thuesim.com.vn/api/?show=networks&token=0-e5ae15b55895b31f6e1b9ebea57e0b07

Danh sách tham số gửi đi

• token : API token của bạn
  • Dùng để định danh người gửi

1.2 Kết quả trả về

• {"status_code":200,"success":true,"message":"successful","data":[{"id":1,"name":"MOBIFONE"},{"id":2,"name":"VINAPHONE"},{"id":3,"name":"VIETTEL"},{"id":4,"name":"VIETNAMOBILE"}, {"id": 5, "name": "ITELECOM"}]}

Danh sách trả về

• status_code : Mã của kết quả
  • 200 : Thành công
  • 401 : Lỗi xác thực
  • -1 : Có lỗi
• message : Thông tin thêm
  • Thông tin báo thành công hoặc là nội dung của lỗi
• data : Danh sách nhà mạng
  • id : Id của nhà mạng
  • name : Tên của nhà mạng

2.1 Ví dụ gửi đi

https://thuesim.com.vn/api/?show=service&token=0-e5ae15b55895b31f6e1b9ebea57e0b07

Danh sách tham số gửi đi

• token : API token của bạn
  • Dùng để định danh người gửi

2.2 Kết quả trả về

• {"ResponseCode":1,"Data":[{"ID":97,"SV":"02","SERVICE_NAME":"DV KHÁC (TEST)","PRICE":1450,"Time":"300"}]}

Danh sách trả về

• ResponseCode : Mã của kết quả
  • 1 : Thành công
  • 0 : Lỗi xác thực
  • -1 : Có lỗi
• message : Thông tin thêm
  • Thông tin báo thành công hoặc là nội dung của lỗi
• data : Danh sách dịch vụ
  • ID : Id của dịch vụ
  • SV : Nơi lưu dịch vụ
  • SERVICE_NAME : Tên của dịch vụ
  • PRICE : Giá thuê dịch vụ
  • Time : Thời gian hết hạn dịch vụ

3.1 Ví dụ gửi đi

• Cơ bản

  https://thuesim.com.vn/api/register-service/?serviceId=02.97&token=0-e5ae15b55895b31f6e1b9ebea57e0b07

• Tùy chọn nhà mạng

  https://thuesim.com.vn/api/register-service/?serviceId=02.97&token=0-e5ae15b55895b31f6e1b9ebea57e0b07&carries=MOBIFONE

• Tùy chọn đầu số muốn lấy

  https://thuesim.com.vn/api/register-service/?serviceId=02.97&token=0-e5ae15b55895b31f6e1b9ebea57e0b07&yPrefix=90

• Tùy chọn thuê lại số cũ

  https://thuesim.com.vn/api/rephone/?phone=0912345678&serviceId=97&thuesim1=215978.02&token=0-e5ae15b55895b31f6e1b9ebea57e0b07

  • phone: số điện thoại cần thuê lại có bao gồm số 0 ở đầu
  • thuesim1: Gồm id và . SV 0x

  => Chú ý: lấy phải cách nhau 5s trở lên 1 lần, không lấy liên tục dưới 5 giây

Danh sách tham số gửi đi

• token : API token của bạn
  • Dùng để định danh người gửi
• serviceId : ServiceID của dịch vụ
  • Lấy SV(02), serviceId(97), trong danh sách trả về ở mục 2
• ID : Id của Số điện thoại
  • Lấy Id trong danh sách trả về ở mục 2
• carries : Nhà mạng muốn lấy số
  • Bao gồm các giá trị [MOBIFONE, VINAPHONE, VIETTEL ,VIETNAMOBILE, ITELECOM]
  • Bỏ qua thông số này nếu muốn lấy tất cả nhà mạng, - Có thể yêu cầu nhiều nhà mạng cách nhau và kết thúc bằng dấu '|' vd carries=VINAPHONE|VIETTEL|
• yPrefix : Đầu số muốn lấy số
  • Bao gồm các giá trị đầu số của các nhà mạng
  • Bỏ qua thông số này nếu muốn lấy tất cả đầu số, - Có thể yêu cầu nhiều đầu số cách nhau và kết thúc bằng dấu '|' vd yPrefix=96|97|98|
• nPrefix : Đầu số không muốn lấy số
  • Bao gồm các giá trị đầu số của các nhà mạng
  • Bỏ qua thông số này nếu không quan tâm đầu số không muốn lấy, - Có thể yêu cầu nhiều đầu số cách nhau và kết thúc bằng dấu '|' vd nPrefix=97|98|
• number : Số điện thoại muốn thuê lại
  • Dùng trong trường hợp ứng dụng yêu cầu xác thực nhiều lần

3.2 Kết quả trả về

• {"RequestLog":{"ID":88237016.01, "ServiceID":4, "ServiceName":"Yahoo", "IMG":"Yahoo.ico", "Price":470, "Phone":" 0852222127", "SmsContent":null, "StatusStr":"Đợi tin nhắn", "CreatedTime":"2021-10-16T09:27:01", "IsSound":false, "Code":null}, "Balance":123456, "ResponseCode":1, "Message":"Tạo yêu cầu Yahoo thành công !"}

Danh sách trả về

• RequestLog : Mã của kết quả
  • 1 : Thành công
  • 0 : Lỗi xác thực
  • 429 : Limit exceeded, tối đa $ số chờ tin nhắn ($: giới hạn số chờ tin nhắn hiện tại)
  • -1 : Có lỗi
  • -2 : Số dư tài khoản không đủ
  • -3 : Kho số đang tạm hết, vui lòng liên hệ hỗ trợ
  • -4 : Ứng dụng không tồn tại hoặc đang tạm ngưng
• message : Thông tin thêm
  • Thông tin báo thành công hoặc là nội dung của lỗi
• data : Thông tin sim số
  • phone_number : Số điện thoại đã thuê được
  • balance : Số dư hiện tại
  • request_id : Mã để lấy Code trong mục 4

4.1 Ví dụ gửi đi

https://thuesim.com.vn/api/?show=code&ID=88237016.01&token=0-e5ae15b55895b31f6e1b9ebea57e0b07

Danh sách tham số gửi đi

• token : API token của bạn
  • Dùng để định danh người gửi
• requestId : Mã phiên thuê số cần lấy code
  • Đã được lấy ở mục 3

4.2 Kết quả trả về

• Nhận được tin nhắn
  • {"ResponseCode": 0, "Msg": "OK", "Result": { "SMS": "[VU KHUYEN] Trung tam thong bao ma kich hoat tai khoan dang ky tu van du hoc: 529310. Vui long khong chia se cho bat ky ai", "Code": "529310", "IsCall":false, "CallFile":null}}
• Nhận được cuộc gọi
  • {"ResponseCode": 0, "Msg": "OK", "Result": { "SMS": "[Call]mã otp của bạn là 059809mã otp của bạn là 059809", "Code": "059809", "IsCall":true, "CallFile":"https://thuesim.com.vn/audio/play.php?01=769652844_Man.Club_6645fe035042.wav&phone=769652844"}}

Danh sách trả về

• status_code : Mã của kết quả
  • 200 : Thành công
  • 401 : Lỗi xác thực
  • 429 : Limit exceeded, tối đa $ số chờ tin nhắn ($: giới hạn số chờ tin nhắn hiện tại)
  • -1 : Có lỗi
  • -2 : Mã phiên không đúng
• message : Thông tin thêm
  • Thông tin báo thành công hoặc là nội dung của lỗi
• data : Thông tin của tin nhắn/cuộc gọi nhận được
  • ID : Mã để lấy code. Được lấy ở mục 3
  • Phone : Số điện thoại đã thuê được
  • ServiceID : Id của dịch vụ
  • ServiceName : Tên của dịch vụ
  • Status : Trạng thái của tin nhắn
    • 1 : Hoàn thành
    • 0 : Đợi tin nhắn
    • 2 : Hết hạn
  • Price : Giá thuê dịch vụ
  • CreatedTime : Thời gian tạo OTP
  • IsSound : OTP là audio
  • SmsContent : Nội dung tin nhắn (nếu IsSound=true, giá trị sẽ là đường dẫn của file audio otp)
  • Code : Mã của OTP

5.1 Ví dụ gửi đi

https://thuesim.com.vn/api/?show=history&token=0-e5ae15b55895b31f6e1b9ebea57e0b07

Danh sách tham số gửi đi

• token : API token của bạn
  • Dùng để định danh người gửi
• service : Id của dịch vụ
  • Lấy Id trong danh sách trả về ở mục 2
• status : Trạng thái của OTP
  • 1: Hoàn thành
  • 0: Đợi tin nhắn
  • 2: Hết hạn

5.2 Kết quả trả về

• {"status_code":200,"success":true,"message":"successful","data":[{"ID":58098,"ServiceID":1,"ServiceName":"Momo","Status":1,"Price":600,"Phone":"987654321","SmsContent":"486460 la ma xac thuc OTP dang ky vi MoMo. De tranh bi mat tien, tuyet doi KHONG chia se ma nay voi bat ky ai. zniHFS3HBXG","IsSound":"false","CreatedTime":"2020-08-06T17:13:24.88","Code":"486460"}, {"ID":58060,"ServiceID":1,"ServiceName":"Momo","Status":1,"Price":600,"Phone":"987654321","SmsContent":"https://thuesim.com.vn/1234500000123456789000006789.wav","IsSound":"true","CreatedTime":"2020-08-06T17:13:24.88","Code":"486460"}]}

Danh sách trả về

• status_code : Mã của kết quả
  • 200 : Thành công
  • 401 : Lỗi xác thực
  • -1 : Có lỗi
• message : Thông tin thêm
  • Thông tin báo thành công hoặc là nội dung của lỗi
• data : Lịch sử thuê số - mảng
  • ID : ID của OTP
  • ServiceID : Id của dịch vụ
  • ServiceName : Tên của dịch vụ
  • Status : Trạng thái của tin nhắn
    • 1 : Hoàn thành
    • 0 : Đợi tin nhắn
    • 2 : Hết hạn
  • Price : Giá thuê dịch vụ
  • Phone : Số điện thoại thuê được
  • CreatedTime : Thời gian tạo OTP
  • IsSound : OTP là audio
  • SmsContent : Nội dung tin nhắn (nếu IsSound=true, giá trị sẽ là đường dẫn của file audio otp)
  • Code : Mã của OTP