Внимание! Доступны номера для переадресации по фиксированной цене в 35 рублей. На балансе номера находится от 5 до 30 рублей!

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

Выполнение запросов к 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, 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 адреса. Рекомендуется оформлять заказы с интервалом 250 мс.

Список стран

Для выбора нужной вам страны - укажите соответствующий код в параметре country.


Флаг
Страна
Код
1
RU
  Россия
RU
2
KZ
  Казахстан
KZ
3
UA
  Украина
UA
4
VN
  Вьетнам
VN
5
UK
  Великобритания
UK
6
IL
  Израиль
IL
7
ID
  Индонезия
ID
8
CN2
  Китай (Virtual SIM)
CN2
9
LV
  Латвия
LV
10
RO
  Румыния
RO
11
PH
  Филиппины
PH
12
FR
  Франция
FR
13
US
  США
US
14
US2
  США (Virtual SIM)
US2
15
US3
  США (Virtual SIM2)
US3
16
EE
  Эстония
EE

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


Лого
Сервис
Код
1
opt28
  1688.com
opt28
2
opt85
  Adidas
opt85
3
opt46
  Airbnb
opt46
4
opt10
  AOL
opt10
5
opt38
  Auto.RU
opt38
6
opt56
  Badoo
opt56
7
opt88
  Beetalk
opt88
8
opt92
  Bigo Live
opt92
9
opt3
  BurgerKing
opt3
10
opt89
  Careem
opt89
11
opt26
  Craigslist
opt26
12
opt45
  Discord
opt45
13
opt27
  Dodopizza.ru
opt27
14
opt32
  Drom.RU
opt32
15
opt83
  Ebay
opt83
16
opt2
  Facebook
opt2
17
opt43
  FastMail
opt43
18
opt6
  Fiverr
opt6
19
opt77
  Gameflip
opt77
20
opt76
  Gem4me
opt76
21
opt35
  GetTaxi
opt35
22
opt1
  GMail, YTube
opt1
23
opt30
  GrabTaxi
opt30
24
opt80
  Holvi
opt80
25
opt0
  ICQ
opt0
26
opt16
  Instagram
opt16
27
opt94
  JD.com
opt94
28
opt71
  Kakaotalk
opt71
29
opt39
  Like4u
opt39
30
opt37
  Line Messenger
opt37
31
opt8
  LinkedIn
opt8
32
opt75
  Lyft
opt75
33
opt33
  Mail.RU
opt33
34
opt100
  Mamba
opt100
35
opt17
  MeetMe
opt17
36
opt15
  Microsoft
opt15
37
opt7
  Microsoft Office 365
opt7
38
opt73
  Naver
opt73
39
opt86
  Nike
opt86
40
opt60
  Nimses
opt60
41
opt70
  OLX
opt70
42
opt57
  Proton Mail
opt57
43
opt99
  QIP
opt99
44
opt18
  Qiwi
opt18
45
opt53
  Rambler
opt53
46
opt42
  Rediffmail
opt42
47
opt22
  SEOsprint.net
opt22
48
opt51
  Sipnet.ru
opt51
49
opt90
  Snapchat
opt90
50
opt98
  Spotify
opt98
51
opt58
  Steam
opt58
52
opt78
  Steemit
opt78
53
opt68
  Talk2
opt68
54
opt61
  TaoBao
opt61
55
opt95
  TAOVIP
opt95
56
opt29
  Telegram
opt29
57
opt34
  Tencent QQ
opt34
58
opt9
  Tinder
opt9
59
opt21
  Tinkoff
opt21
60
opt66
  Twilio
opt66
61
opt41
  Twitter
opt41
62
opt52
  Ubank.ru
opt52
63
opt72
  Uber
opt72
64
opt81
  UpWork
opt81
65
opt11
  Viber
opt11
66
opt24
  WebMoney
opt24
67
opt67
  WeChat
opt67
68
opt9001
  WeChat lifted restrictions
opt9001
69
opt54
  Weebly
opt54
70
opt20
  WhatsAPP
opt20
71
opt91
  WOG
opt91
72
opt82
  Worldcore
opt82
73
opt65
  Yahoo
opt65
74
opt40
  Zalo
opt40
75
opt93
  Zoho
opt93
76
opt59
  Авито
opt59
77
opt4
  Вконтакте
opt4
78
opt31
  Друг Вокруг
opt31
79
opt69
  Лукойл-Гарант
opt69
80
opt19
  Любой другой
opt19
81
opt84
  Новые лидеры
opt84
82
opt5
  Одноклассники
opt5
83
opt97
  Почта Банк
opt97
84
opt74
  Такси Максим
opt74
85
opt13
  Фотострана
opt13
86
opt14
  Юла
opt14
87
opt23
  Яндекс
opt23
88
opt25
  Яндекс такси
opt25

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

{"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 адреса.

Рекомендуется оформлять заказы с интервалом 250 мс.м!

Описание методов 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

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

Пример


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

Метод 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.


 

БЛОК СХЕМА

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