API v2.0

API adalah protokol interaksi antara perangkat lunak anda dan server aktivasi kami. API diperlukan untuk mengotomatisasi proses penerimaan pesan SMS di sisi anda untuk bekerja dengan API, anda harus menggunakan token API anda, anda bisa mendapatkannya dengan pergi ke halaman profil. Perangkat lunak kami sepenuhnya kompatibel dengan website kompetitor.

Deskripsi protokol API

Semua permintaan harus ditujukan ke https://api.sms-man.com/control/ Permintaan POST atau GET. Semua permintaan harus memiliki kunci API dalam bentuk parameter token

Permintaan saldo

Parameter

Kolom	Jenis	Dibutuhkan	Nilai
`token`	String	yes	Kunci API Anda

Hasil

{
  "balance": "799.70"
}

Kesalahan yang mungkin terjadi

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

Dapatkan batas

Parameter

Kolom	Jenis	Dibutuhkan	Nilai
`token`	String	yes	Kunci API Anda
`country_id`	Integer	no
`application_id`	Integer	no

Hasil

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

Kesalahan yang mungkin terjadi

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

Minta nomor telepon

Parameter

Untuk memilih negara secara acak, gunakan country_id=0

Kolom	Jenis	Dibutuhkan	Nilai
`token`	String	yes	Kunci API Anda
`country_id`	Integer	no
`application_id`	Integer	yes
`maxPrice`	Integer	no	Angka yang anda inginkan
`currency`	String	no	`RUB/USD/EUR`
`ref`	String	no	Berikan ID afiliasi
`hasMultipleSms`	String	no	`True/False`

Hasil

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

Kesalahan yang mungkin terjadi

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

Dapatkan sms

Parameter

Kolom	Jenis	Dibutuhkan	Nilai
`token`	String	yes	Kunci API Anda
`request_id`	Integer	yes	ID Permintaan

Hasil

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

Kesalahan yang mungkin terjadi

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

Ubah status permintaan

Parameter

Kolom	Jenis	Dibutuhkan	Nilai
`token`	String	yes	Kunci API Anda
`request_id`	Integer	yes	ID Permintaan
`status`	String	yes	`ready` / `close` / `reject` / `used`

Hasil

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

Kesalahan yang mungkin terjadi

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

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

Dapatkan harga saat ini

Parameter

Kolom	Jenis	Dibutuhkan	Nilai
`token`	String	yes	Kunci API Anda
`country_id`	Integer	no

Hasil

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

Kesalahan yang mungkin terjadi

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

Dapatkan daftar semua negara

Parameter

Kolom	Jenis	Dibutuhkan	Nilai
`token`	String	yes	Kunci API Anda

Hasil

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

Kesalahan yang mungkin terjadi

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

Dapatkan daftar semua layanan

Parameter

Kolom	Jenis	Dibutuhkan	Nilai
`token`	String	yes	Kunci API Anda

Hasil

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

Kesalahan yang mungkin terjadi

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