Запрос баланса пользователя

Пример

https://simsms.org/priemnik.php?
	 metod=get_balance
	 &service=opt4
	 &apikey=DSWAFvdedrE4

Результат

После успешного выполнения возвращает ответ в формате JSON:

{"response":"1","balance":"385.00"}

Коды ошибок

В ходе выполнения могут произойти ошибки:

{"response":"error","error_msg":"Not id or not user balance"}

Запрос баланса пользователя и кармы

Пример

https://simsms.org/priemnik.php?
	 metod=get_userinfo
	 &service=opt4
	 &apikey=DSWAFvdedrE4

Результат

После успешного выполнения возвращает ответ в формате JSON:

{"response":"1","balance":"385.00","karma":"10"}

Коды ошибок

В ходе выполнения могут произойти ошибки:

{"response":"error","error_msg":"Not id or not user balance"}

Запрос на количество свободных активаций для определенного сервиса

Если нужно узнать кол-во свободных для других стран, используйте параметр country с соотвествующим значением. Например, для казахстанких номеров country=KZ

Пример

https://simsms.org/priemnik.php?
	metod=get_count_new
	&service=opt4
	&apikey=DSWAFvdedrE4
	&country=RU
	&operator=MTS_RU // если указан данный параметр, то country не учитывается

Результат

После успешного выполнения возвращает ответ в формате JSON:

      {
        service: "opt5",    идентиф. сервиса
        online: 128,        доступно номеров сейчас
        total: 228,         доступно вообще
        forTotal: 10,       доступно под переадресацию сейчас
        forOnline: 20,      доступно под передаресацию вообще
        country: "RU"       страна симкарт
      }
      

Коды ошибок

В ходе выполнения могут произойти ошибки:

В ходе выполнения могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

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

Пример

https://simsms.org/priemnik.php?
	metod=get_service_price
	&country=RU
	&service=opt4
	&apikey=DSWAFvdedrE4

Результат

После успешного выполнения возвращает ответ в формате JSON:

{"response":"1","country":"RU","service":"opt4","price":"20.90"}

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Запрос на получение номера телефона для определенного сервиса

Пример

https://simsms.org/priemnik.php?
	metod=get_number
	&country=RU
	&service=opt4
	&apikey=DSWAFvdedrE4

Результат

После успешного выполнения возвращает ответ в формате JSON:

{"response":"1","number":"9871234567","id":25623}

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Ответ в формате JSON - {"response":"2","number":"","id":"-1"} - Номера заняты, пробуйте получить номер заново через 30 секунд.
2) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Сообщить серверу, что номер уже использован

В данном методе, параметр ID указывается из ответа на запрос на получение номера телефона get_number

Пример

https://simsms.org/priemnik.php?
	metod=ban
	&service=opt4
	&apikey=DSWAFvdedrE4
	&id=25623

Результат

После успешного выполнения возвращает ответ в формате JSON:

{"responce":"1","number":"","id":25623}

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Ответ в формате JSON -

{"response":"2","number":"","id":""}

Получение смс для определенного сервиса

В данном методе, параметр ID указывается из ответа на запрос на получение номера телефона get_number

Пример

https://simsms.org/priemnik.php?
	metod=get_sms
	&country=ru
	&service=opt4
	&id=25623
	&apikey=DSWAFvdedrE4

Результат

После успешного выполнения возвращает ответ в формате JSON, если код из SMS ещё не найдено:

{"response":"2","number":null,"sms":null}

После успешного выполнения возвращает ответ в формате JSON, если код из SMS найден:

{"response":"1","number":"9871234567","sms":''234562'}

После успешного выполнения возвращает ответ в формате JSON, если пропустили первое получение смс (response = 1), то оно снова дублируется с response = 4:

{"response":"4"}

Примечание

Если у Вас возвращается ответ, что код из SMS ещё не найден, отправляйте запрос get_sms ещё раз через 30 секунд. Учитывайте, что сервер ищет SMS в течении 10 минут. Вам необходимо отправлять запрос в течении 10 минут, с периодичностью в 30 секунд на один запрос. При этом у Вас возвращается либо код из SMS, либо сообщение об ошибке.

Уточнение кода

Если Вы хотите получить повторное СМС без закрытия заказа (Уточнение кода), тогда просто на метод get_sms добавляете дополнительный параметр sms=sms Пример строки:

        https://simsms.org/priemnik.php?
        metod=get_sms
        &country=ru
        &service=opt4
        &id=25623
        &apikey=DSWAFvdedrE4
        &sms=sms
        

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Ответ в формате JSON - {"response":"3","number":"null","sms":null} - такой СМС нет, либо айди запроса не верный, либо истек срок ожидания СМС (Не более 10 минут)
2) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Отмена заказа на полученный номер

В данном методе, параметр ID указывается из ответа на запрос на получение номера телефона get_number

Пример

https://simsms.org/priemnik.php?
	metod=denial
	&country=ru
	&service=opt4
	&id=25623
	&apikey=DSWAFvdedrE4

Результат

В случае успешного выполнения возвращает ответ в формате JSON:

{"responce":"1","number":"","id":25623}

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Ответ в формате JSON -

{"response":"2","number":"","id":""}

Проверка номера для получения нескольких СМС подряд в рамках одного заказа

В данном методе, параметру id указывается номер заказа в рамках которого необходимо получить еще одно смс.

Пример

https://simsms.org/priemnik.php?
	metod=get_clearsms
	&service=opt4
	&id=25623
	&apikey=DSWAFvdedrE4.

Результат

В случае успешного выполнения возвращает ответ в формате JSON:

{"responce":"1","clearsms":"ok"}

Примечание

После проверки номера, и его успешном выполнении, отправляем запрос(ы) на поиск смс - get_sms

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) {"response":"2","clearsms":"non_ok"}

Проверка номера для получения нескольких СМС (через продолжительный период времени)

В данном методе, параметру number указывается номер который Вы хотите проверить.

Пример

https://simsms.org/priemnik.php?
	metod=get_proverka
	&service=opt4
	&number=9685156912
	&apikey=DSWAFvdedrE4.

Результат

В случае успешного выполнения возвращает ответ в формате JSON:

{"responce":"ok","number":"9685156912","id":25623}

Примечание

После проверки номера, и его успешном выполнении, отправляем запрос на получение номера - get_number ТАКЖЕ с параметром number. Для проверки СМС отправляем запрос на СМС get_sms согласно условиям

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) {"response":"error","error_msg":"Number shall consist of 10 digits!"} - Номер должен состоять из 10 цифр

2) {"response":"error","error_msg":"Such a number you did not order for the service"} - Вы не заказывали номер для выбранного сервиса

3) {"response":"modem_busy","error_msg":"The modem is busy, try to order in 5 minutes"} - GSM модуль занят, попробуйте повторить запрос через 5 минут.

4) {"response":"modem_busy","not_number":"This number is no longer in the system"} - Данного номера уже нет в системе.

Получения кода 2FA авторизации Google, Microsoft и т.д. по секретному ключу

Пример

https://simsms.org/priemnik.php?
	metod=get_2fa
	&secret=1234567890
	&apikey=DSWAFvdedrE4.

Результат

В случае успешного выполнения возвращает ответ в формате JSON:

{"response":1,"code2fa":"338205","secret":"1234567890","tonew":18}

Допустим, Вы пишите регистратор аккаунтов в Вконтакте.

Регистратор у Вас работает через прокси.

Первым делом устанавливаем прокси и генерируем Имя и Фамилию или берем из списка.

Переходим на сайт Вконтакте, где вводим Имя и Фамилию, указываем пол, если запросили. Нажимаем на кнопку зарегистрироваться.

Дальше Вконтакте предлагает нам ввести номер телефона. Теперь мы обращаемся к нашему API и узнаём баланс по запросу - https://simsms.org/priemnik.php?metod=get_balance&service=opt4&apikey=DSWAFvdedrE4

В ответ на запрос на получение баланса к нам приходит следующий ответ - {"response":"1","balance":"385.00"}, если Вы пишите через PHP, распаршиваем его через функцию json_decode. Если используйте Zennoposter используйте встроенный тестер регулярных выражений и распаршивайте с помощью регулярки. В общем нам нужно вытащить число из ответа идущее после balance. В итоге у нас получилось число 385.

Теперь сравниваем, если полученное число меньше 10, закрываем проект.

Если больше 10, то отправляем запрос на получение номера - https://simsms.org/priemnik.php?metod=get_number&country=ru&service=opt4&id=1&apikey=DSWAFvdedrE4

Если получили такой ответ - {"response":"1","number":"9257222005","id":4453221,"text":null,"extra":"Megafon_RU",
"pass":null,"sms":null,"balanceOnPhone":0}

Распаршиваем ответ, записываем id из запроса в переменную и вводим полученный номер телефона в регистрацию в ВК и нажимаем на кнопку получить код.

Если пришел ответ {"response":"2","number":"","id":"-1"}, значит номера заняты, отправляем повторный запрос на получение номера (get_number) через 30 секунд.

Если ВК написал, что данный номер телефона нельзя использовать, тогда отправляем номер в бан по запросу - https://simsms.org/priemnik.php?metod=ban&service=opt4&apikey=DSWAFvdedrE4&id=4453221

Если ВК пропустил телефон, тогда ожидаем код и проверяем его получение через запрос - https://simsms.org/priemnik.php?metod=get_sms&country=ru&service=opt4&id=4453221&apikey=DSWAFvdedrE4 где в параметре ID указываем ID полученный из запроса на получение номера (get_number)

Если в ответ на запрос получили ответ: {"response":"2","number":"9871234567","sms":null}, делаем паузу в 30 секунд и отправляем запрос на получение СМС заново.

Если ответ пришел такой - {"response":"3","number":"null","sms":null} значит СМС нет, либо айди запроса не верный, либо истек срок ожидания СМС (Не более 10 минут)

Если ответ пришел такой - {"response":"1","number":"9871234567","sms":''234562'}. СМС найдено, код из СМС содержится после слова sms.

Вводим полученный код ВК и нажимаем продолжить.

Если Вы по какой-то причине хотите отказаться от полученного номера (например нечаянно заказали), отправляйте запрос на отмену номера - https://simsms.org/priemnik.php?metod=denial&country=ru&service=opt4&id=4453221&apikey=DSWAFvdedrE4

Всё, вот весь процесс получения кода с помощью нашего API.