Телеграмм-бот @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
KZ
  Казахстан
KZ
3
UA
  Украина
UA
4
RO
  Румыния
RO
5
UK
  Англия
UK
6
AR
  Аргентина
AR
7
BR
  Бразилия
BR
8
VN
  Вьетнам
VN
9
DE
  Германия
DE
10
GE
  Грузия
GE
11
DO
  Доминикана
DO
12
EG
  Египет (Virtual)
EG
13
IL
  Израиль
IL
14
ID
  Индонезия
ID
15
ES
  Испания
ES
16
KH
  Камбоджа
KH
17
KE
  Кения
KE
18
KG
  Киргизия
KG
19
CO
  Колумбия
CO
20
XK
  Косово
XK
21
LA
  Лаос
LA
22
LV
  Латвия
LV
23
LT
  Литва
LT
24
MY
  Малайзия
MY
25
MX
  Мексика
MX
26
NL
  Нидерланды
NL
27
NZ
  Новая Зеландия
NZ
28
PY
  Парагвай
PY
29
PL
  Польша
PL
30
PT
  Португалия
PT
31
US
  США
US
32
PH
  Филиппины
PH
33
FI
  Финляндия
FI
34
FR
  Франция
FR
35
HR
  Хорватия
HR
36
SE
  Швеция
SE
37
EE
  Эстония
EE

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


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

Для пользователей Windows:
Добавьте строчку в файл "C:\Windows\System32\drivers\etc\hosts", замените domain на нужный домен, который используется в ПО

62.182.88.154 domain


Для пользователей Linux:
Добавьте строчку в файл "/etc/hosts"

62.182.88.154 domain


Данные принимаются POST или GET запросом.
Во всех запросах должен присутствовать API ключ в виде параметра "api_key"

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


 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'}


Примечание

Если у Вас возвращается ответ, что код из 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.


 

БЛОК СХЕМА

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