Dành cho nhà phát triển

Đây là phần có tài liệu API để kết nối dịch vụ của bạn với SMS-Man và tự động mua số điện thoại.

API v2.0

API là một giao thức tương tác giữa phần mềm của bạn và máy chủ kích hoạt của chúng tôi. API được cần để tự động hóa quá trình nhận tin nhắn SMS ở phía bạn. Để làm việc với API, bạn phải sử dụng khóa API của bạn, bạn có thể nhận nó bằng cách truy cập trang hồ sơ. Phần mềm của chúng tôi hoàn toàn tương thích với các trang web cạnh tranh

Mô tả Giao thức API

Tất cả các yêu cầu phải gửi đến https://api.sms-man.com/control/ Yêu cầu POST hoặc GET. Tất cả các yêu cầu phải có khóa API dưới dạng tham số token

Yêu cầu số dư

https://api.sms-man.com/control/get-balance?token=$token

Các thông số

Lĩnh vực	Loại	Bắt buộc	Giá trị
token	String	yes	Khóa API của bạn

Kết quả

{"balance":"799.70"}

Lỗi có thể xảy ra

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}

Nhận giới hạn

https://api.sms-man.com/control/limits?token=$token&country_id=$country_id&application_id=$application_id

Các thông số

Lĩnh vực	Loại	Bắt buộc	Giá trị
token	String	yes	Khóa API của bạn
country_id	Integer	no	Quốc gia số điện thoại
application_id	Integer	no	Dịch vụ số

Kết quả

[{"application_id":"1","country_id":"1","numbers":"32302"},{"application_id":"1","country_id":"2","numbers":"3494"}]

Lỗi có thể xảy ra

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

Yêu cầu một số điện thoại

https://api.sms-man.com/control/get-number?token=$token&country_id=$country_id&application_id=$application_id

Các thông số

Lĩnh vực	Loại	Bắt buộc	Giá trị
token	String	yes	Khóa API của bạn
country_id	Integer	no	Quốc gia số điện thoại
application_id	Integer	no	Dịch vụ số
ref	String	no	Vui lòng cung cấp ID giới thiệu.

Kết quả

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539"}

Lỗi có thể xảy ra

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

Nhận SMS

https://api.sms-man.com/control/get-sms?token=$token&request_id=$request_id

Các thông số

Lĩnh vực	Loại	Bắt buộc	Giá trị
token	String	yes	Khóa API của bạn
request_id	Integer	yes	ID yêu cầu

Kết quả

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539", "sms_code": "1243"}

Lỗi có thể xảy ra

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539", "error_code": "wait_sms", "error_msg": "Still waiting..."}

Thay đổi trạng thái yêu cầu

https://api.sms-man.com/control/set-status?token=$token&request_id=$request_id&status=$status

Các thông số

Lĩnh vực	Loại	Bắt buộc	Giá trị
token	String	yes	Khóa API của bạn
request_id	Integer	yes	ID yêu cầu
Trạng thái	String	yes	ready / close / reject / used

Kết quả

{"request_id": 1, "success": true}

Lỗi có thể xảy ra

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}{"success":false,"error_code":"wrong_status","error_msg": "Status $status does not exists"}

Yêu cầu số lượng số có sẵn

https://api.sms-man.com/control/get-prices?token=$token&country_id=$country_id

Các thông số

Lĩnh vực	Loại	Bắt buộc	Giá trị
token	String	yes	Khóa API của bạn
country_id	Integer	no	Quốc gia số điện thoại

Kết quả

{"0":{"1":{"cost":"15","count":6455},"2":{"cost":"50","count":124}}, "1":{"3":{"cost":"6","count":1000}}

Lỗi có thể xảy ra

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

Lấy danh sách tất cả các quốc gia

https://api.sms-man.com/control/countries?token=$token

Các thông số

Lĩnh vực	Loại	Bắt buộc	Giá trị
token	String	yes	Khóa API của bạn

Kết quả

[{'id':0,'title':"Russia"}, {'id':3,'title':"China"}]

Lỗi có thể xảy ra

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}

Lấy danh sách tất cả các dịch vụ

https://api.sms-man.com/control/applications?token=$token

Các thông số

Lĩnh vực	Loại	Bắt buộc	Giá trị
token	String	yes	Khóa API của bạn

Kết quả

[{'id':'1','name':"Vkontakte", "code":"vk"}, {'id':'2','name':"WeChat", "code": "wb"}, {'id':'3','name':"Telegram", "code":"tg"}]

Lỗi có thể xảy ra

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}