Внимание! Доступно пополнение ₴ гривной по курсу банка через авторизированных продавцов промокодов.

Последнее изменение 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
BR
  Бразилия
BR
5
EE
  Эстония
EE
6
FR
  Франция
FR
7
ID
  Индонезия
ID
8
IL
  Израиль
IL
9
KG
  Киргизия
KG
10
LV
  Латвия
LV
11
NL
  Нидерланды
NL
12
PY
  Парагвай
PY
13
PH
  Филиппины
PH
14
PL
  Польша
PL
15
RO
  Румыния
RO
16
UK
  Великобритания
UK
17
VN
  Вьетнам
VN
18
CN2
  Китай (Virtual SIM)
CN2

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


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


 

БЛОК СХЕМА

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