Документация по API

 
Обратите внимание!
Чтобы быть в курсе загрузок номеров, вступите в нашу группу: https://vk.com/smsvknet или в Telegram канал
ХАЛЯВА! ЮЛА по 2 рубля, ИНСТА по 3 рубля.

Документация по API

Первым делом, для старта работы Вам необходимо убедиться в доступности сим-карт, а сделать это можно запросом ниже.

1. Проверка статуса симкарт.
http://support.smsvk.net/stubs/handler_api.php?api_key=$api_key&action=getSimStatus
$api_key - Ваш APIKEY (находится во вкладке SMS активации)
Ответы сервиса:
OK - номера работают
SIM_CHANGE - идет замена сим карт
Если ответ SIM_CHANGE, необходимо подождать от 3 до 10 минут и попробовать снова. Далее делаем несколько проверок (баланс и наличие нужного сервиса).

2. Запрос баланса.
http://support.smsvk.net/stubs/handler_api.php?api_key=$api_key&action=getBalance
$api_key - Ваш APIKEY (находится во вкладке SMS активации)
Ответ сервиса будет таким:
ACCESS_BALANCE:$balance
где после двоеточия будет указана цифра (Ваш баланс) ($balance = Ваш баланс).
После проверки баланса необходимо произвести сравнение, допустим нужный сервис стоит 10 рублей, а запрос выдал что у Вас 8 рублей на счету - в таких случаях я вывожу надпись в лог о том, что средства закончились, необходимо пополниться, а уже если баланс 10 или более того, то идем далее, на следующий запрос, на запрос количества активаций.
 
3. Запрос количества доступных номеров.
http://support.smsvk.net/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus
$api_key - Ваш APIKEY (находится во вкладке SMS активации)
Ответ сервиса будет в json формате, пример:
{"vk":"61","mb":"97","ok":"0","4g":"97","fb":"81","ss":"97","pp":"97","qw":"97","gg":"96","wa":"40","or":"68","wt":"90"}
Из этого ответа вытаскиваем необходимые нам значения и делаем проверку. Например нам нужен сервис "vk", мы делаем запрос и если количество номеров более нуля (1 и больше), то идем выполнять дальнейшие действия, а если ответ менее или равно нулю, то в таких случаях я вывожу в лог сообщение о том, что номера для выбранного сервиса закончились.
 
4. Запрос на получение номера.
http://support.smsvk.net/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service
$api_key - ключ АПИ
$service - сервис для заказа (vk,mb,ok,4g,fb,ss,pp,gg,qw,wa,wt,vb,av,or), можно посмотреть нужный Вам сервис в ответе запроса на получение кол-ва номеров.
Ответы этого запроса:
NO_NUMBERS - нет номеров
NO_BALANCE - закончился баланс
ACCESS_NUMBER:$id:$number - номер выдан
$id - id операции (запоминаем эти данные)
$number - номер телефона (запоминаем эти данные)
После получения номера, отправляем в нужном сервисе на него СМС и меняем статус на "1" следующим запросом, где потребуется вписать $id.

4.1 Запрос на получение номера, с переадресацией
http://support.smsvk.net/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=rd&forward=ВашНомерДляПереадресации(79277396555)
forward=ВашНомер - параметр для передачи системы Вашего номера, на который будет подключена переадресация
service=rd - выбор сервиса "Авито+Переадресация"

5. Смена статуса номера (перевод в состояние "Жду СМС").
http://support.smsvk.net/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id
$api_key - ключ АПИ
$id - id активации
$status - статус активации:
-1 - отменить активацию
1 - сообщить о готовности номера (смс на номер отправлено)
3 - сообщить о неверном коде, для уточнения кода
6 - завершить активацию(если был статус "код получен" - помечает успешно и завершает, если был "подготовка" - удаляет и помечает ошибка, если был статус "ожидает повтора" - переводит активацию в ожидание смс)
8 - сообщить о том, что номер использован и отменить активацию
Ответы сервиса:
ACCESS_READY - готовность номера подтверждена
ACCESS_RETRY_GET - ожидание нового смс
ACCESS_ACTIVATION - сервис успешно активирован
ACCESS_CANCEL - активация отменена
 
После изменения статуса на "1", сервис переходит в стадию ожидания СМС сообщения, а чтобы узнать на какой стадии поток находится сейчас, необходимо узнать статус потока следующим запросом.
 
6. Получение состояния активации.
http://support.smsvk.net/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
$api_key - ключ АПИ
$id - id активации
NO_ACTIVATION - id активации не существует
STATUS_WAIT_CODE - ожидание смс
STATUS_WAIT_RETRY:$lastcode - ожидание уточнения кода
$lastcode - прошлый (неподошедший) код.
STATUS_WAIT_RESEND - ожидание повторной отправки смс (софт должен нажать повторно выслать смс и выполнить изменение статуса на 6)
STATUS_OK:$code - код получен
$code - код активации
 
a. Если выдало NO_ACTIVATION, это значит что прошло 15 минут, и сервис сам отменил активацию вернув Вам средства на баланс.
b. Если выдало STATUS_WAIT_CODE, это значит что мы ждём СМСку, и необходимо повторить запрос чуть позже (через 30 секунд) и повторять в течении 15-ти минут.
c. Если выдало STATUS_WAIT_RETRY:$lastcode - ждем уточнения кода и ставим статус 6 (ждём следующую смску)
d. Если выдало STATUS_WAIT_RESEND, такое выдаёт как правило на Вконтакте, мы просто отправляем из ВК еще раз СМСку и ставим статус 6, запросом из пятого пункта.
e. Самый любимый ответ, STATUS_OK:$code, где вместо переменной $code, будет нужный Вам для активации код.
 
Отправляем в сервис нужный Вам код и активируем аккаунт ;)
 
Любые вопросы задавайте в тикет-систему.