Телеграмм-бот @simsms_official_bot поможет следить за балансом, уведомит о новых номерах! Поможет пополнить баланс редкой платежной системой!

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

Выполнение запросов к 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
UA
  Украина
UA
3
DE
  Германия
DE
4
KZ
  Казахстан
KZ
5
HT
  Гаити
HT
6
RO
  Румыния
RO
7
UK
  Англия
UK
8
AR
  Аргентина
AR
9
BA
  Бос. и Герц.
BA
10
BR
  Бразилия
BR
11
VN
  Вьетнам
VN
12
DO
  Доминикана
DO
13
EG
  Египет (Virtual)
EG
14
IL
  Израиль
IL
15
ID
  Индонезия
ID
16
IE
  Ирландия
IE
17
ES
  Испания
ES
18
KH
  Камбоджа
KH
19
CA_V
  Канада (Virtual)
CA_V
20
KE
  Кения
KE
21
CY
  Кипр
CY
22
KG
  Киргизия
KG
23
CN
  Китай (Virtual)
CN
24
LA
  Лаос
LA
25
LV
  Латвия
LV
26
LT
  Литва
LT
27
MY
  Малайзия
MY
28
MA
  Марокко
MA
29
MX
  Мексика
MX
30
MD
  Молдова
MD
31
NG
  Нигерия
NG
32
NL
  Нидерланды
NL
33
NZ
  Новая Зеландия
NZ
34
PL
  Польша
PL
35
PT
  Португалия
PT
36
US
  США
US
37
TH
  Таиланд
TH
38
PH
  Филиппины
PH
39
FI
  Финляндия
FI
40
FR
  Франция
FR
41
CZ
  Чехия
CZ
42
CL
  Чили
CL
43
SE
  Швеция
SE
44
EE
  Эстония
EE
45
ZA
  ЮАР
ZA

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


Лого
Сервис
Код
1
opt28
  1688.com
opt28
2
opt97
  32red.com
opt97
3
opt22
  888casino
opt22
4
opt86
  Adidas & Nike
opt86
5
opt46
  Airbnb
opt46
6
opt61
  Alibaba | Taobao
opt61
7
opt44
  Amazon
opt44
8
opt10
  AOL
opt10
9
opt56
  Badoo
opt56
10
opt25
  BetFair
opt25
11
opt78
  Blizzard
opt78
12
opt81
  Bolt
opt81
13
opt89
  Careem
opt89
14
opt122
  CashWalk
opt122
15
opt76
  CityMobil
opt76
16
opt98
  Clubhouse
opt98
17
opt112
  CoinBase
opt112
18
opt51
  CONTACT
opt51
19
opt26
  Craigslist
opt26
20
opt124
  Credit Karma
opt124
21
opt123
  Dabbl
opt123
22
opt53
  Deliveroo
opt53
23
opt92
  DiDi
opt92
24
opt45
  Discord
opt45
25
opt27
  Dodopizza + PapaJohns
opt27
26
opt40
  DoorDash
opt40
27
opt32
  Drom.RU
opt32
28
opt21
  EasyPay
opt21
29
opt2
  Facebook
opt2
30
opt43
  FastMail
opt43
31
opt6
  Fiverr
opt6
32
opt68
  G2A.COM
opt68
33
opt77
  Gameflip
opt77
34
opt35
  GetTaxi
opt35
35
opt3
  Glo&iPOST.ua
opt3
36
opt108
  Glovo | Raketa
opt108
37
opt1
  GMail, YTube
opt1
38
opt30
  GrabTaxi
opt30
39
opt420
  Grailed
opt420
40
opt110
  Grindr
opt110
41
opt120
  Hinge
opt120
42
opt103
  iCard
opt103
43
opt55
  ifood
opt55
44
opt111
  IMO
opt111
45
opt118
  Inboxdollars
opt118
46
opt16
  Instagram
opt16
47
opt94
  JD.com
opt94
48
opt128
  Kaggle
opt128
49
opt71
  Kakaotalk
opt71
50
opt60
  Lazada
opt60
51
opt37
  Line Messenger
opt37
52
opt8
  LinkedIn
opt8
53
opt42
  LiveScore
opt42
54
opt105
  LocalBitcoins
opt105
55
opt114
  Locanto.com
opt114
56
opt75
  Lyft
opt75
57
opt38
  LYKA
opt38
58
opt33
  Mail.RU (без гарантии)
opt33
59
opt4
  Mail.ru Group
opt4
60
opt100
  Mamba
opt100
61
opt17
  MeetMe
opt17
62
opt96
  MiChat
opt96
63
opt15
  Microsoft
opt15
64
opt7
  Microsoft Office 365
opt7
65
opt115
  Mistplay
opt115
66
opt99
  Momo
opt99
67
opt121
  Monese
opt121
68
opt47
  MoneyLion
opt47
69
opt0
  myopinions & erewards
opt0
70
opt73
  Naver
opt73
71
opt95
  NetBet
opt95
72
opt116
  Neteller
opt116
73
opt101
  Netflix
opt101
74
opt113
  OfferUp
opt113
75
opt70
  OLX + goods.ru
opt70
76
opt109
  Paddy Power
opt109
77
opt129
  Payactiv
opt129
78
opt83
  PayPal + Ebay
opt83
79
opt84
  POF.com
opt84
80
opt107
  Prom.UA
opt107
81
opt57
  Proton Mail
opt57
82
opt48
  Shopee
opt48
83
opt127
  Signal
opt127
84
opt49
  Skout
opt49
85
opt117
  Skrill
opt117
86
opt90
  Snapchat
opt90
87
opt119
  Sneakersnstuff
opt119
88
opt58
  Steam
opt58
89
opt125
  Swagbucks
opt125
90
opt82
  Tango
opt82
91
opt29
  Telegram
opt29
92
opt34
  Tencent QQ
opt34
93
opt52
  Ticketmaster
opt52
94
opt104
  TikTok
opt104
95
opt9
  Tinder
opt9
96
opt66
  Twilio
opt66
97
opt41
  Twitter
opt41
98
opt72
  Uber
opt72
99
opt85
  Venmo
opt85
100
opt39
  Verse
opt39
101
opt11
  Viber
opt11
102
opt24
  WebMoney&ENUM
opt24
103
opt67
  WeChat
opt67
104
opt54
  Weebly
opt54
105
opt80
  WESTSTEIN
opt80
106
opt20
  WhatsAPP
opt20
107
opt106
  Wing money
opt106
108
opt91
  Wise
opt91
109
opt65
  Yahoo
opt65
110
opt88
  Yalla.live
opt88
111
opt93
  Zoho
opt93
112
opt59
  Авито
opt59
113
opt69
  ВКонтакте (без гарантии)
opt69
114
opt31
  Друг Вокруг
opt31
115
opt19
  Любой другой (без гарантии)
opt19
116
opt126
  Магнит
opt126
117
opt5
  Одноклассники (без гарантии)
opt5
118
opt102
  Пятерочка
opt102
119
opt74
  Такси Максим
opt74
120
opt13
  Фотострана
opt13
121
opt14
  Юла (без гарантии)
opt14
122
opt23
  Яндекс&ЮMoney
opt23

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

{"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 Новое

Все запросы должны идти на http://simsms.org/stubs/handler_api.php


Для совместимости с уже существующим ПО, где нет нашего сервиса, но есть это API

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


 http://simsms.org/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country


$api_key - ключ API
$country - страна номера:

0 - Россия, 1 - Украина, 2 - Казахстан, 3 - Китай, 4 - Филиппины, 5 - Грузия, 
6 - Индонезия, 7 - Белорусь, 8 - Кения, 10 - Бразилия, 11 - Кыргызстан, 
12 - США, 13 - Израиль, 14 - Парагвай, 15 - Польша, 16 - Англия, 
17 - США (Virtual), 18 - Финляндия, 19 - Нигерия, 20 - Макао, 21 - Египет, 
22 - Франция, 23 - Ирландия, 24 - Камбоджа, 25 - Лаос, 26 - Гаити, 
27 - Кот д'Ивуар, 28 - Гамбия, 29 - Сербия, 30 - Йемен, 31 - ЮАР, 
32 - Румыния, 33 - Швеция, 34 - Эстония, 35 - Азербайджан, 36 - Канада, 
37 - Марокко, 38 - Гана, 39 - Аргентина, 40 - Узбекистан, 41 - Камерун, 
42 - Чад, 43 - Германия, 44 - Литва, 45 - Хорватия, 47 - Ирак, 
48 - Нидерланды, 49 - Латвия, 50 - Австрия, 51 - Беларусь, 52 - Таиланд, 
53 - Сауд. Аравия, 54 - Мексика, 55 - Тайвань, 56 - Испания, 57 - Иран, 
58 - Алжир, 59 - Словения, 60 - Бангладеш, 61 - Сенегал, 62 - Турция, 
63 - Чехия, 64 - Шри-Ланка, 65 - Перу, 66 - Пакистан, 67 - Новая Зеландия, 
68 - Гвинея, 69 - Мали, 70 - Венесуэла, 71 - Эфиопия


Ответ сервиса будет в json формате, пример:

{"at_0":"330","fb_0":"330","gm_0":"323","go_0":"323","ig_0":"326","mb_0":"330",
"mm_0":"330","ok_0":"330","or_0":"315","ot_0":"315","qw_0":"327","tg_0":"329",
"tw_0":"330","vi_0":"330","vk_0":"292","vr_0":"330","wa_0":"330","wb_0":"328",
"we_0":"330","ya_0":"203","ym_0":"13"}


Где до черточки - название сервиса, после обозначение нужно ли включать переадресацию. 0 - не включать. 1 - включать (переадресация не реализована).

Запрос баланса:


 http://simsms.org/stubs/handler_api.php?api_key=$api_key&action=getBalance


$api_key - ключ API
Ответ сервиса:

ACCESS_BALANCE:$balance (где $balance - баланс на счету)

Возможные ошибки:

BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера


Заказ номера:


 http://simsms.org/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country


$api_key - ключ API
$service - сервис для заказа
$country - страна номера

Список доступных сервисов:

vk(Вконтакте) 
ok(Одноклассники) 
wa(Whatsapp) 
vi(Viber) 
tg(Telegram) 
wb(WeChat) 
go(Google,youtube,Gmail) 
av(avito) 
fb(facebook) 
tw(Twitter) 
ub(Uber) 
qw(Qiwi) 
gt(Gett) 
sn(OLX) 
ig(Instagram) 
ss(Лукойл) 
ym(Юла) 
ma(Mail.ru) 
mg(Mail.ru Group) 
mm(Microsoft) 
uk(Airbnb) 
me(Line messenger) 
mb(Yahoo) 
we(ДругВокруг) 
bd(Пятерочка) 
kp(HQ Trivia) 
ya(Яндекс) 
mt(Steam) 
oi(Tinder) 
fd(Mamba, MeetMe) 
zz(Dent) 
kt(KakaoTalk) 
pm(AOL) 
tn(LinkedIN) 
ot(Любой другой)


Получая номер через API вы подтверждаете согласие с правилами сайта

Ответы сервиса:

NO_NUMBERS - нет номеров
NO_BALANCE - закончился баланс
ACCESS_NUMBER:$id:$number - номер выдан ($id - id операции,$number - номер телефона)

Возможные ошибки:

BAD_ACTION - некорректное действие
BAD_SERVICE - некорректное наименование сервиса
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера


Изменение статуса активации:


 http://simsms.org/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id


$api_key - ключ API
$id - id активации
$status - статус активации:

-1 - отменить активацию
 1 - сообщить о готовности номера (смс на номер отправлено)
 3 - запросить еще один код (платно)
 6 - завершить активацию(если был статус "код получен" - помечает успешно и завершает, если был "подготовка" - удаляет и помечает ошибка, если был статус "ожидает повтора" - переводит активацию в ожидание смс)
 8 - сообщить о том, что номер использован и отменить активацию


Ответы сервиса:

ACCESS_READY - готовность номера подтверждена
ACCESS_RETRY_GET - ожидание нового смс
ACCESS_ACTIVATION - сервис успешно активирован
ACCESS_CANCEL - активация отменена

Возможные ошибки:

ERROR_SQL - ошибка SQL-сервера
NO_ACTIVATION - id активации не существует
BAD_SERVICE - некорректное наименование сервиса
BAD_STATUS - некорректный статус
BAD_KEY - Неверный API-ключ
BAD_ACTION - некорректное действие


Получить состояние активации:


 http://simsms.org/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id


$api_key - ключ API
$id - id активации
Ответы сервиса:

STATUS_WAIT_CODE - ожидание смс
STATUS_WAIT_RETRY:$lastcode - ожидание уточнения кода (где $lastcode - прошлый, неподошедший код)
STATUS_WAIT_RESEND - ожидание повторной отправки смс (софт должен нажать повторно выслать смс и выполнить изменение статуса на 6)
STATUS_CANCEL - активация отменена
STATUS_OK:$code - код получен (где $code - код активации)

Возможные ошибки:

NO_ACTIVATION - id активации не существует
ERROR_SQL - ошибка SQL-сервера
BAD_KEY - Неверный API-ключ
BAD_ACTION - некорректное действие 


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

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

Пример

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

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

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

{"response":"4"}


Примечание

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

Метод get_2fa

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


Пример

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


Результат

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

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

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

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


Первый запрос это 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.


 

БЛОК СХЕМА

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