Внимание! Доступны номера МТС с переадресацией. С балансом 20 - 30 рублей.


Последнее изменение 2.6.2017

Выполнение запросов к API

Разрешается не более 100 подключений в секунду с одного IP адреса. Для того чтобы вызвать метод API SimSms, Вам необходимо осуществить GET запрос по протоколу HTTP на указанный URL:


http://simsms.org/priemnik.php?
  	metod={METHOD}
  	&service={SERVICE}
  	&id={ID}
  	&apikey={API_KEY}
  	&operator={OPERATOR}
    &redirectphone={REDIRECT}
    &amount={AMOUNT}

{METHOD} - Название метода из описания методов API

{SERVICE} - Название сервиса из списка сервисов

{ID} - ID запроса

{API_KEY} - Ваш APIKey в системе

{REDIRECT} - (Дополнительный параметр может быть опущен) Требуется ли выполнить переадресацию на Ваш номер, может принимать следующие значение - true, если не указывать, переадресацию выполнить будет не возможно.

{OPERATOR} - (Дополнительный параметр может быть опущен) Выбор оператора, может принимать следующие значения - Beeline_RU, MTS_RU, Megafon_RU, Beeline_KZ, Tele2_KZ, Activ_KZ, Altel_KZ, Lifecell_UA, Kyivstar_UA, Vodafone_UA. Если не указывать, будет выдан номер любого оператора

{AMOUNT} - (Обязательный параметр при выполнении переадресации, в остальных случаях может быть опущен) Сумма пополнения баланса сим-карты в рублях при переадресации, может принимать значения от 10 до 20

Пример


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


В ответ на такой запрос Вы получите ответ в формате JSON.


Важно

Разрешается не более 100 подключений в секунду с одного IP адреса.

Список сервисов

opt0 - ICQ

opt1 - GMail, YTube

opt2 - Facebook

opt3 - BurgerKing

opt4 - Вконтакте

opt5 - Одноклассники

opt6 - Fiverr

opt7 - Open I Messenger

opt8 - LinkedIn

opt9 - Tinder

opt10 - AOL

opt11 - Viber

opt13 - Фотострана

opt14 - Юла

opt15 - Microsoft

opt16 - Instagram

opt17 - MeetMe

opt18 - Qiwi

opt19 - Любой другой

opt20 - WhatsAPP

opt21 - Tinkoff

opt22 - SEOsprint.net

opt23 - Яндекс

opt24 - WebMoney

opt25 - Яндекс такси

opt26 - Craigslist

opt27 - Dodopizza.ru

opt28 - 1688.com

opt29 - Telegram

opt30 - GrabTaxi

opt31 - Друг Вокруг

opt32 - Drom.RU

opt33 - Mail.RU

opt34 - Tencent QQ

opt35 - GetTaxi

opt37 - Line Messenger

opt38 - Auto.RU

opt39 - Like4u

opt40 - Zalo

opt41 - Twitter

opt51 - Sipnet.ru

opt52 - Ubank.ru

opt53 - Rambler

opt54 - Weebly

opt56 - Badoo

opt57 - Proton Mail

opt58 - Steam

opt59 - Авито

opt60 - Nimses

opt61 - TaoBao

opt64 - ITunes

opt65 - Yahoo

opt66 - Twilio

opt67 - WeChat

opt68 - Talk2

opt69 - Лукойл-Гарант

opt70 - OLX

opt71 - Kakaotalk

opt72 - Uber

opt73 - Naver

opt74 - Такси Максим

opt75 - Lyft

opt76 - Gem4me

opt77 - Петиция

opt78 - Primo Connect

opt80 - Holvi

opt81 - UpWork

opt82 - Worldcore

opt83 - Ebay

opt84 - GetResponse

opt9001 - WeChat lifted restrictions

Коды возвращаемых ошибок

{"response":"5","number":null,"id":0,"text":null,"extra":null,"sms":null} - Превышено количество запросов в минуту


{"response":"6","number":null,"id":0,"text":null,"extra":null,"sms":null} - Вы забанены на 10 минут, т.к. набрали отрицательную карму


{"response":"7","number":null,"id":0,"text":null,"extra":null,"sms":null} - Превышено количество одновременных потоков. Дождитесь смс от предыдущих заказов


API KEY не получен! - Введен не верный API KEY


Недостаточно средств! - Недостаточно средств для выполнения операции. Пополните Ваш кошелек


Превышено количество попыток! - Задайте больший интервал между вызовами к серверу API


Произошла неизвестная ошибка. - Попробуйте повторить запрос позже.


Неверный запрос. - Проверьте синтаксис запроса и список используемых параметров (его можно найти на странице с описанием метода).


Произошла внутренняя ошибка сервера. - Попробуйте повторить запрос позже.


Важные рекомендации

Если СМС не пришла в течении 580 секунд (9 минут 40 секунд), обязательно отправляйте полученный номер в бан.

Если Вы отправите номер в бан после ожидания 10 минут, Ваш полученный номер не отправится в бан и может выдастся заново, т.к. система хранит ID запроса в базе ровно 10 минут, после этого ID удаляется из базы.

Разрешается не более 100 подключений в секунду с одного IP адреса.

Делайте интервал в 4 - 5 секунд между любыми запросами! Иначе, Вы не сможете полноценно пользоваться API, т.к. Ваши запросы будут отклоняться сервером!

Описание методов API

Метод get_balance

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

Пример


http://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"}

Метод get_userinfo

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

Пример


http://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"}

Метод get_count [НЕ РЕКОМЕНДУЕТСЯ. используйте get_count_new]

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


В этом методе всегда включается параметр service_id, где он может выступать значением из определенных ниже сервисов. Для других методов данный параметр не обязателен.


Пример


http://simsms.org/priemnik.php?
	metod=get_count
	&service=opt4
	&apikey=DSWAFvdedrE4
	&service_id=vk


Результат

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

{"response":"1","counts Vkontakte":"127"}


Коды ошибок

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

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

Метод get_count_new

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


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


Пример


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


Результат

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


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


Коды ошибок

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

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

Метод get_number

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

ВНИМАНИЕ! Доступны номера Казахстана, Украины, Великобритании и Малайзии. Для их получения вам необходимо установить параметр "country" равным "KZ", "UA", "UK" и "MY", соответственно.


Пример


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


Результат

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

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


Коды ошибок

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

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

Метод ban

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


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


Пример


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


Результат

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

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


Коды ошибок

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

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

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

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

Метод get_sms

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


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


Пример


http://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'}


Примечание

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


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

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


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

Метод denial

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


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


Пример


http://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":""}


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

Метод get_clearsms

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


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


Пример


http://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"}

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

Метод get_proverka

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


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


Пример


http://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"} - Данного номера уже нет в системе.

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

Выполнение переадресации

Переадресация номера состоит из двух запросов


Первый запрос это redirect (подготовка переадресации) и второй запрос это redirect_confirm


В запросах указываются два дополнительных параметра - number_redirect (номер телефона на который нужно выполнить переадресацию) и amount(сумма в рублях, от 10 до 20)


Пример запроса redirect


http://simsms.org/priemnik.php?
	metod=redirect
	&service=opt59
	&id=25623
	&number_redirect=9869788422
	&apikey=DSWAFvdedrE4
    &amount=10


Результат

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

{"responce":1,"forwarding":"ready"}


Примечание

В параметре number_redirect указываем номер на который нужно выполнить переадресацию!

В параметре amount указываем сумму пополнения баланса сим-карты в рублях, может принимать значения от 10 до 20


Коды ошибок

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


1) {"responce":3,"forwarding":"wrong_number_format"} - Неправильный формат номера для переадресации

2) {"responce":4,"forwarding":"unknown_error"} - Неизвестная ошибка

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




Пример запроса redirect_confirm


http://simsms.org/priemnik.php?
	metod=redirect_confirm
	&service=opt59
	&id=25623
	&number_redirect=9869788422
	&apikey=DSWAFvdedrE4
    &amount=10


Результат

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

{"response":"1","forwarding":"ok","pass":"824970"}


Примечание

В параметре number_redirect указываем номер на который нужно выполнить переадресацию!

В параметре amount указываем сумму пополнения баланса сим-карты в рублях, может принимать значения от 10 до 20


Коды ошибок

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


1) {"responce":3,"forwarding":"wrong_number_format"} - Неправильный формат номера для переадресации

2) {"responce":4,"forwarding":"unknown_error"} - Неизвестная ошибка

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



Как правильно делать переадресаию по API:

1) Заказываем номер, пример строки


http://simsms.org/priemnik.php?
	metod=get_number
	&country=ru
	&service=opt59
	&id=1
	&apikey=DSWAFvdedrE4
    &redirectphone=true

1) Ответ должен быть такой: {"response":"1","number":"9773993439","id":154935955,"text":null,
"extra":"Tele2_RU","pass":null,"sms":null}

2) Дальше отправляем запрос на подготовку переадресации:


http://simsms.org/priemnik.php?
metod=redirect
&service=opt59
&id=25623
&number_redirect=9869788422
&apikey=DSWAFvdedrE4
&amount=10

1) Ответ должен быть такой: {"response":"1","forwarding":"ready"}

3) Дальше отправляем запрос на проверку переадресации:

          
http://simsms.org/priemnik.php?
metod=redirect_confirm
&service=opt59
&id=25623
&number_redirect=9869788422
&apikey=DSWAFvdedrE4
&amount=10

1) Ответ должен быть такой: {"response":"1","forwarding":"ok","pass":null}

4) Получаем СМС, пример строки

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

1) Если СМС ещё нет ответ будет такой: {"response":"2","number":"9773975273","id":11309714,"text":null,"extra":null,"sms":null}

Отправляем запрос в цикл с периодичность в 30 сек. пока не получим ответ: {"response":"1","number":"9773975273","id":11309714,"text":"31049","extra":"Telegram code 31049","sms":"31049"}
Переадресация успешно установилась, смс получено. Переадресация автоматически включится через 15 минут!

Или ответ {"response":"3","number":null,"id":122244807,"text":"","extra":"-1","pass":"","sms":"","balanceOnPhone":0} Что означает, что переадресацию выполнить не удалось.

Как правильно пользоваться API!

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


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


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


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


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


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


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


Если больше 10, то отправляем запрос на получение номера - http://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 секунд.


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


Если ВК пропустил телефон, тогда ожидаем код и проверяем его получение через запрос - http://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.


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


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


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


 

БЛОК СХЕМА

Скачать блок схему