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

Для того чтобы вызвать метод 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. Если не указывать, будет выдан номер любого оператора

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

Пример


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


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


Важно

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

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

opt0 - 4Game

opt1 - GMail, YTube

opt2 - Facebook

opt3 - Spaces.ru

opt4 - Вконтакте

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

opt6 - Fiverr

opt7 - Mamba

opt8 - LinkedIn

opt9 - Tinder

opt10 - AOL

opt11 - Viber

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

opt14 - TimeWeb.com

opt15 - MS, Bing, HotMail

opt16 - Instagram

opt17 - MeetMe

opt18 - Qiwi

opt19 - ДРУГОЕ

opt20 - WhatsAPP

opt21 - Webtransfer

opt22 - SEOsprint.net

opt23 - Яндекс

opt24 - WebMoney

opt25 - NaSIMke.ru

opt26 - FreeBitco.in

opt27 - dodopizza.ru

opt28 - Tabor.ru

opt29 - Telegram

opt30 - Простоквашино

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

opt32 - Drom.RU

opt33 - Mail.RU

opt34 - Ценобой

opt35 - GetTaxi

opt37 - VK Serfing

opt38 - Auto.RU

opt39 - like4u

opt40 - VOXOX.COM

opt41 - Twitter

opt51 - Sipnet.ru

opt52 - Ubank.ru

opt53 - PP.ua

opt54 - Weebly

opt56 - Badoo

opt57 - Wmrok

opt58 - Steam

opt59 - Авито

opt60 - LD-Info.ru

opt61 - IMO

opt65 - Yahoo

opt66 - Twilio

opt67 - WeChat

opt68 - Talk2

opt69 - SmartCall

opt70 - Hike

opt71 - MasterCard

opt72 - PremiaRuneta.ru

opt73 - Naver

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

opt75 - EsportsPlus

opt76 - Gem4me

opt77 - Carousell.com

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

{"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 удаляется из базы.

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

Делайте интервал в 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_count

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


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


Пример


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


Результат

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

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


Параметр service_id

Парамет service_id может принимать следующие значения:

4game - 4GAME

gmail - GMail

fb - Facebook

spaces - Spaces.ru

vk - Вконтакте

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

mamba - Mamba

avito - Avito

viber - Viber

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

ms - MS, Live, Bing, Hotmail

instagram - Instagram

qiwi - Qiwi с отвязкой

others - Другое

whatsapp - WhatsAPP

webtransfer - Webtransfer

seosprint - SEOsprint.net

ya - Яндекс

webmoney - WebMoney

nasimke - NaSimke.ru

com - COM.NU

dodopizza - Dodopizza.ru

tabor - Tabor.ru

telegram - Telegram

prostock - Простоквашино

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

drom - Drom.RU

mail - Mail.RU

twitter - Twitter


Коды ошибок

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

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

Метод get_number

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


Пример


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,"id":-1,"text":null,"extra":null,"karma":9.75,"pass":null,"sms":null,"balanceOnPhone":0}

После успешного выполнения возвращает ответ в формате 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_proverka

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


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


Пример


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


Результат

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

{"response":"ok","number":null,"id":-1}


Примечание

После проверки номера, и его успешном выполнении, отправляем запрос на получение номера - 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.


Последние изменение 30.12.2016 в 14.48

Исправлено количество запросов в секунду. Разрешается до 200 подключений в секунду.


БЛОК СХЕМА

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