API VAK-SMS.COM

Баланс пользователя, в рублях

URL параметры

GET https://vak-sms.com/api/getBalance/?apiKey={apiKey} HTTP/1.1

{"balance": 100.0}

Количество доступных номеров

URL параметры

GET https://vak-sms.com/api/getCountNumber/?apiKey={apiKey}&service={service}&country={country}&operator={operator}&price HTTP/1.1

{"{SERVICE}": 332}  # В SERVICE содержится переданный код

{"{SERVICE}": 332, "price": 2.0}   # В SERVICE содержится переданный код, в PRICE содержится цена

GET https://vak-sms.com/api/getCountNumberList/?apiKey={apiKey}&country={country}&operator={operator} HTTP/1.1

{"vk": {"code": "vk", "count": 403, "price": 20.0}, "ok": {"code": "ok", "count": 403, "price": 3.0}, "ig": {"code": "ig", "count": 403, "price": 3}}

Получение номера

URL параметры

GET https://vak-sms.com/api/getNumber/?apiKey={apiKey}&service={service}&country={country}&operator={operator}&softId={softId} HTTP/1.1

{"tel": 79991112233, "idNum": "3adb61376b8f4adb90d6e758cf8084fd"}

Изменение статуса

URL параметры

После получения номера, сразу происходит ожидание смс. Отправлять запрос с параметрами status=send необходимо только в случае получения еще одной смс с кодом. Если отправлена еще смс, необходимо повторить запрос с тем же idNum и status=send. Такое возможно в течение выделенного времени после получения номера телефона. Повторное получение смс БЕСПЛАТНО. В случае если пришел не верный код, необходимо повторно отправить запрос с тем же idNum и status=send что бы получить новую смс с другим кодом

GET https://vak-sms.com/api/setStatus/?apiKey={apiKey}&status={status}&idNum={idNum} HTTP/1.1

{"status": "ready"}

{"status": "end"}  # номер успешно отменен.
{"status": "smsReceived"}  # на данный номер уже получен код подтверждения, отмена невозможна.
{"status": "waitSMS"}  # на данные номер уже отправлено смс, отмена невозможна. Ожидайте код.
{"status": "update"}  # статус обновлен.

{"status": "update"}  # статус успешно обновлен
{"status": "waitSMS"}  # статус не может быть обновлен, т.к сервис ожидает повторную смс

Состояние активации

URL параметры

GET https://vak-sms.com/api/getSmsCode/?apiKey={apiKey}&idNum={idNum}&all HTTP/1.1

{"smsCode": null}  # сервис ожидает СМС
{"smsCode": "CODE"}  # код получен, в переменной "CODE" содержится код подтверждения активации, type=str

{"smsCode": ["CODE1", "CODE2"]}  # Список полученых кодов, type=list(str)

Варианты ошибок

{"error": "apiKeyNotFound"}  # Неверный API ключ.
{"error": "noService"}  # Данный сервис не поддерживается, свяжитесь с администрацией сайта.
{"error": "noNumber"}  # Нет номеров, попробуйте позже.
{"error": "noMoney"}  # Недостаточно средств, пополните баланс.
{"error": "noCountry"}  # Запрашиваемая страна отсутствует.
{"error": "noOperator"}  # Оператор не найдет для запрашиваемой страны.
{"error": "badStatus"}  # Не верный статус.
{"error": "idNumNotFound"}  # Не верный ID операции.
{"error": "badService"}  # Не верный код сайта, сервиса, соц. сети.
{"error": "badData"}  # Отправлены неверные данные.