API yang kompatibel

API adalah protokol interaksi antara perangkat lunak anda dan server aktivasi kami. API diperlukan untuk mengotomatisasi proses penerimaan SMS di sisi Anda. Untuk bekerja dengan API, anda harus menggunakan kunci API anda, anda dapat mendapatkannya di bagian profil anda, dengan melalui prosedur pendaftaran yang sederhana. API kami sepenuhnya kompatibel dengan situs web kompetitor.

Deskripsi protokol API

Semua permintaan harus dikirim ke https://api.sms-man.com/stubs/handler_api.php permintaan POST atau GET. Semua permintaan harus mengandung token API dalam bentuk parameter api_key. Semua jawaban dalam format json

Permintaan saldo

Parameter

Parameter	Jenis	Dibutuhkan	Nilai
`action`	String	Ya	`getBalance`
`api_key`	String	Ya	Kunci API Anda

Hasil

ACCESS_BALANCE:$balance (di mana $balance adalah saldo akun Anda)

Kesalahan yang mungkin terjadi

Kesalahan	Deskripsi
`BAD_KEY`	Kunci API salah

Dapatkan harga saat ini

Parameter

Parameter	Jenis	Dibutuhkan	Nilai
`action`	String	Ya	`getPrices`
`api_key`	String	Ya	Kunci API Anda
`country`	Number	Tidak
`service`	String	Tidak

Hasil

{
  "0": {"vk":{"cost":"15","count":6455},"wb":{"cost":"50","count":124}},
  "1": {"fb":{"cost":"6","count":1000}}
}

Kesalahan yang mungkin terjadi

Kesalahan	Deskripsi
`BAD_KEY`	Kunci API salah

Dapatkan nomor

Parameter

Parameter	Jenis	Dibutuhkan	Nilai
`action`	String	Ya	`getNumber`
`api_key`	String	Ya	Kunci API Anda
`country`	Number	Ya
`service`	String	Ya
`maxPrice`	Number	Tidak	Angka yang anda inginkan
`currency`	String	Tidak	`RUB/USD/EUR`
`ref`	String	Tidak	Berikan ID afiliasi

Hasil

ACCESS_NUMBER:$id:$number
$id - id aktivasi
$number - nomor telepon

Kesalahan yang mungkin terjadi

Kesalahan	Deskripsi
`BAD_KEY`	Kunci API salah
`NO_NUMBERS`	Tidak ada nomor, coba lagi nanti
`NO_BALANCE`	Saldo tinggal sedikit

Dapatkan status aktivasi

Parameter

Parameter	Jenis	Dibutuhkan	Nilai
`action`	String	Ya	`getStatus`
`api_key`	String	Ya	Kunci API Anda
`id`	Number	Ya	ID aktivasi

Hasil

STATUS_WAIT_CODE - sms menunggu
STATUS_WAIT_RETRY:$lastcode - menunggu perbaikan kode (di mana $lastcode adalah kode terakhir yang gagal)
STATUS_WAIT_RESEND — menunggu pengiriman ulang SMS (perangkat lunak harus menekan ulang pengiriman SMS dan melakukan perubahan status menjadi 6)
STATUS_CANCEL — aktivasi dibatalkan
STATUS_OK:$code — kode yang diterima (di mana $code adalah kode aktivasi)

Kesalahan yang mungkin terjadi

Kesalahan	Deskripsi
`BAD_KEY`	Kunci API salah
`NO_ACTIVATION`	Tidak ada aktivasi

Dapatkan status aktivasi V2

Parameter

Parameter	Jenis	Dibutuhkan	Nilai
`action`	String	Ya	`getStatusV2`
`api_key`	String	Ya	Kunci API Anda
`id`	Number	Ya	ID aktivasi

Hasil

{
  "verificationType": 0,
  "sms": {"dateTime":"0000-00-00 00:00:00","code":"code","text":"sms text"}
}

STATUS_CANCEL

STATUS_WAIT_CODE

Kesalahan yang mungkin terjadi

Kesalahan	Deskripsi
`BAD_KEY`	Kunci API salah
`NO_ACTIVATION`	Tidak ada aktivasi

Ubah status aktivasi

Parameter

Parameter	Jenis	Dibutuhkan	Nilai
`action`	String	Ya	`setStatus`
`api_key`	String	Ya	Kunci API Anda
`id`	Number	Ya	ID aktivasi
`status`	Number	Ya	Status aktivasi

Status yang mungkin

-1 — Batalkan aktivasi
1 — Beritahu bahwa SMS telah dikirim (opsional)
3 — Minta kode lain
6 — selesaikan aktivasi (jika statusnya "kode diterima" - maka sukses dan selesai, jika statusnya "persiapan" - hapuslah dan tandai kalau error, jika statusnya "menunggu ulang" - artinya aktivasi sedang menunggu SMS)
8 — menginformasikan bahwa nomor digunakan dan membatalkan aktivasi

Hasil

ACCESS_READY - Kesediaan nomor terkonfirmasi
ACCESS_RETRY_GET - menunggu SMS baru
ACCESS_ACTIVATION - layanan berhasil diaktifkan
ACCESS_CANCEL - Aktivasi dibatalkan
EARLY_CANCEL_DENIED - Tidak diperbolehkan membatalkan nomor dalam 2 menit pertama.

Kesalahan yang mungkin terjadi

Kesalahan	Deskripsi
`BAD_KEY`	Kunci API salah
`NO_ACTIVATION`	ID Aktivasi tidak ada
`BAD_STATUS`	Status salah

Dapatkan daftar semua negara

Parameter

Parameter	Jenis	Dibutuhkan	Nilai
`action`	String	Ya	`getCountries`
`api_key`	String	Ya	Kunci API Anda

Hasil

[
  {"id":0,"name":"Россия","name_en":"Russia"},
  {"id":3,"name":"Китай","name_en":"China"}
]

Kesalahan yang mungkin terjadi

Kesalahan	Deskripsi
`BAD_KEY`	Kunci API salah

Dapatkan daftar semua layanan

Parameter

Parameter	Jenis	Dibutuhkan	Nilai
`action`	String	Ya	`getServices`
`api_key`	String	Ya	Kunci API Anda

Hasil

[
  {"id":"vk","name":"Вконтакте"},
  {"id":"wb","name":"WeChat"},
  {"id":"tg","name":"Telegram"}
]

Kesalahan yang mungkin terjadi

Kesalahan	Deskripsi
`BAD_KEY`	Kunci API salah
`BAD_ACTION`	Tindakan yang tidak benar