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

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

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

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


https://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

Пример


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


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


Важно

Разрешается создавать до 100 одновременных заказов с одного IP адреса. Рекомендуется оформлять заказы с интервалом 250 мс.

Список стран

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


Флаг
Страна
Код
1
RU
  Россия
RU
2
CA
  Канада
CA
3
UA
  Украина
UA
4
DE
  Германия
DE
5
IT
  Италия
IT
6
KZ
  Казахстан
KZ
7
HT
  Гаити
HT
8
RO
  Румыния
RO
9
AT
  Австрия
AT
10
UK
  Англия
UK
11
AR
  Аргентина
AR
12
BD
  Бангладеш
BD
13
BE
  Бельгия
BE
14
BA
  Бос. и Герц.
BA
15
BR
  Бразилия
BR
16
VN
  Вьетнам
VN
17
HK
  Гонконг
HK
18
DK
  Дания
DK
19
DO
  Доминикана
DO
20
EG
  Египет (Virtual)
EG
21
IL
  Израиль
IL
22
IN
  Индия
IN
23
ID
  Индонезия
ID
24
IE
  Ирландия
IE
25
ES
  Испания
ES
26
KH
  Камбоджа
KH
27
KE
  Кения
KE
28
CY
  Кипр
CY
29
KG
  Киргизия
KG
30
CN
  Китай
CN
31
LA
  Лаос
LA
32
LV
  Латвия
LV
33
LT
  Литва
LT
34
MY
  Малайзия
MY
35
MA
  Марокко
MA
36
MX
  Мексика
MX
37
MD
  Молдова
MD
38
NG
  Нигерия
NG
39
NL
  Нидерланды
NL
40
NZ
  Новая Зеландия
NZ
41
PY
  Парагвай
PY
42
PL
  Польша
PL
43
PT
  Португалия
PT
44
RS
  Сербия
RS
45
SI
  Словения
SI
46
US
  США
US
47
TH
  Таиланд
TH
48
TR
  Турция
TR
49
PH
  Филиппины
PH
50
FI
  Финляндия
FI
51
FR
  Франция
FR
52
HR
  Хорватия
HR
53
CZ
  Чехия
CZ
54
CL
  Чили
CL
55
SE
  Швеция
SE
56
EE
  Эстония
EE
57
ZA
  ЮАР
ZA

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


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

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


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

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


 https://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 - включать (переадресация не реализована).

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


 https://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-сервера


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


 https://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-сервера


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


 https://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 - некорректное действие


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


 https://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

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

Пример


https://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

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

Пример


https://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


Пример


https://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

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

Пример

https://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

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

Пример


https://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


Пример


https://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


Пример


https://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 Пример строки:


        https://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


Пример


https://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 указывается номер заказа в рамках которого необходимо получить еще одно смс.


Пример


https://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 указывается номер который Вы хотите проверить.


Пример


https://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 и т.д. по секретному ключу


Пример

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


Результат

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

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

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

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


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


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


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


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


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


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


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


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


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


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


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


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


 

БЛОК СХЕМА

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