SMSVK.net API Документация

SMSVK.net API Документация

Букерцерк Написал

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

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


1. Запрос баланса.

http://smsvk.net/stubs/handler_api.php?api_key=$api_key&action=getBalance

$api_key - Ваш APIKEY (находится во вкладке SMS активации)

Ответ сервиса будет таким:

ACCESS_BALANCE:$balance

где после двоеточия будет указана цифра (Ваш баланс) ($balance = Ваш баланс).

После проверки баланса необходимо произвести сравнение, допустим нужный сервис стоит 10 рублей, а запрос выдал что у Вас 8 рублей на счету - в таких случаях я вывожу надпись в лог о том, что средства закончились, необходимо пополниться, а уже если баланс 10 или более того, то идем далее, на следующий запрос, на запрос количества активаций.

 

2. Запрос количества доступных номеров.

http://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 и больше), то идем выполнять дальнейшие действия, а если ответ менее или равно нулю, то в таких случаях я вывожу в лог сообщение о том, что номера для выбранного сервиса закончились.

 

3. Запрос на получение номера.

http://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. Смена статуса номера (перевод в состояние "Жду СМС").

http://smsvk.net/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id

$api_key - ключ АПИ

$id - id активации

$status - статус активации:

1 - сообщить о готовности номера (необязательно)

3 - запроситьповторный код для этой активации

6 - завершить активацию(если был статус "код получен" - помечает успешно и завершает, если был "подготовка" - удаляет и помечает ошибка, если был статус "ожидает повтора" - переводит активацию в ожидание смс)

8 - сообщить о том, что номер использован и отменить активацию

Ответы сервиса:

ACCESS_READY - готовность номера подтверждена

ACCESS_RETRY_GET - ожидание нового смс

ACCESS_ACTIVATION - сервис успешно активирован

ACCESS_CANCEL - активация отменена

 

После изменения статуса на "1", сервис переходит в стадию ожидания СМС сообщения, а чтобы узнать на какой стадии поток находится сейчас, необходимо узнать статус потока следующим запросом.

 

5. Получение состояния активации.

http://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, будет нужный Вам для активации код.

 

Отправляем в сервис нужный Вам код и активируем аккаунт ;)


Для того чтобы использовать наш сервис через АПИ sms-activate, нужно добавить в etc\host:

51.38.148.125  sms-activate.ru

ВЕРНУТЬСЯ НА САЙТ => http://smsvk.net/