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ư

Các thông số

Trường	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

Các thông số

Trường	Loại	Bắt buộc	Giá trị
`token`	String	yes	Khóa API của bạn
`country_id`	Integer	no
`application_id`	Integer	no

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

Các thông số

để chọn một quốc gia ngẫu nhiên, hãy sử dụng country_id=0

Trường	Loại	Bắt buộc	Giá trị
`token`	String	yes	Khóa API của bạn
`country_id`	Integer	no
`application_id`	Integer	yes
`maxPrice`	Integer	no	giá trị bạn muốn
`currency`	String	no	`RUB/USD/EUR`
`ref`	String	no	Vui lòng cung cấp ID giới thiệu.
`hasMultipleSms`	String	no	`True/False`

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

Các thông số

Trường	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

Các thông số

Trường	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
`status`	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"
}

Nhận giá hiện tại

Các thông số

Trường	Loại	Bắt buộc	Giá trị
`token`	String	yes	Khóa API của bạn
`country_id`	Integer	no

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

Các thông số

Trường	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ụ

Các thông số

Trường	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!"
}