Размер шрифта:
Инструкция по подключению к серверу API; Активация аккаунтов через SMS для любых сервисов

Инструкция по подключению к серверу API; Активация аккаунтов через SMS для любых сервисов

Без кейворда

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

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

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

- Название метода из описания методов API

- Название сервиса из списка сервисов

- Ваш APIKey в системе

- (Дополнительный параметр может быть опущен) Требуется ли выполнить переадресацию на Ваш номер, может принимать следующие значение - true, если не указывать, переадресацию выполнить будет не возможно.

- (Дополнительный параметр может быть опущен) Выбор оператора, может принимать следующие значения - Beeline_RU, MTS_RU, Megafon_RU, Beeline_KZ, Tele2_KZ, Activ_KZ, Altel_KZ, Lifecell_UA, Kyivstar_UA, Vodafone_UA. Если не указывать, будет выдан номер любого оператора

- (Обязательный параметр при выполнении переадресации, в остальных случаях может быть опущен) Сумма пополнения баланса сим-карты в рублях при переадресации, может принимать значения от 10 до 20

Пример

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

Важно

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

Список стран

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

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

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

- Превышено количество запросов в минуту

- Вы забанены на 10 минут, т.к. набрали отрицательную карму

- Превышено количество одновременных потоков. Дождитесь смс от предыдущих заказов

API KEY не получен! - Введен не верный API KEY

Недостаточно средств! - Недостаточно средств для выполнения операции. Пополните Ваш кошелек

Превышено количество попыток! - Задайте больший интервал между вызовами к серверу API

Произошла неизвестная ошибка. - Попробуйте повторить запрос позже.

Неверный запрос. - Проверьте синтаксис запроса и список используемых параметров (его можно найти на странице с описанием метода).

Произошла внутренняя ошибка сервера. - Попробуйте повторить запрос позже.

Важные рекомендации

Если СМС не пришла в течении 580 секунд (9 минут 40 секунд), обязательно отправляйте полученный номер в бан.

Если Вы отправите номер в бан после ожидания 10 минут, Ваш полученный номер не отправится в бан и может выдастся заново, т.к. система хранит ID запроса в базе ровно 10 минут, после этого ID удаляется из базы.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Описание методов API

Метод get_balance

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

Пример

Результат

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

Коды ошибок

В ходе выполнения могут произойти ошибки:

Метод get_userinfo

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

Пример

Результат

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

Коды ошибок

В ходе выполнения могут произойти ошибки:

Метод get_count_new

Запрос на количество свободных активаций для определенного сервиса

Если нужно узнать кол-во свободных для других стран, используйте параметр country с соотвествующим значением. Например, для казахстанких номеров country=KZ

Пример

Результат

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

Коды ошибок

В ходе выполнения могут произойти ошибки:

В ходе выполнения могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Метод get_service_price

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

Пример

Результат

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

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Метод get_number

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

Пример

Результат

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

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Ответ в формате JSON - - Номера заняты, пробуйте получить номер заново через 30 секунд. 2) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Метод ban

Сообщить серверу, что номер уже использован

В данном методе, параметр ID указывается из ответа на запрос на получение номера телефона get_number

Пример

Результат

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

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Ответ в формате JSON - 2) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Метод get_sms

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

В данном методе, параметр ID указывается из ответа на запрос на получение номера телефона get_number

Пример

Результат

После успешного выполнения возвращает ответ в формате JSON, если код из SMS ещё не найдено:

После успешного выполнения возвращает ответ в формате JSON, если код из SMS найден:

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

Примечание

Если у Вас возвращается ответ, что код из SMS ещё не найден, отправляйте запрос get_sms ещё раз через 30 секунд. Учитывайте, что сервер ищет SMS в течении 10 минут. Вам необходимо отправлять запрос в течении 10 минут, с периодичностью в 30 секунд на один запрос. При этом у Вас возвращается либо код из SMS, либо сообщение об ошибке.

Уточнение кода

Если Вы хотите получить повторное СМС без закрытия заказа (Уточнение кода), тогда просто на метод get_sms добавляете дополнительный параметр sms=sms Пример строки: В этом случае Ваш заказ не закрывается и вы можете получать повторное СМС. Повторное СМС платное. Стоимость равна стоимости обычной СМС для этого сервиса.

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Ответ в формате JSON - - такой СМС нет, либо айди запроса не верный, либо истек срок ожидания СМС (Не более 10 минут) 2) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Метод denial

Отмена заказа на полученный номер

В данном методе, параметр ID указывается из ответа на запрос на получение номера телефона get_number

Пример

Результат

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

Коды ошибок

В ходе выполнения могут произойти ошибки:

1) Ответ в формате JSON -

2) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Метод get_clearsms

Проверка номера для получения нескольких СМС подряд в рамках одного заказа

В данном методе, параметру id указывается номер заказа в рамках которого необходимо получить еще одно смс.

Пример

Результат

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

Примечание

После проверки номера, и его успешном выполнении, отправляем запрос(ы) на поиск смс - get_sms

Коды ошибок

В ходе выполнения могут произойти ошибки:

2) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Метод get_proverka

Проверка номера для получения нескольких СМС (через продолжительный период времени)

В данном методе, параметру number указывается номер который Вы хотите проверить.

Пример

Результат

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

Примечание

После проверки номера, и его успешном выполнении, отправляем запрос на получение номера - get_number ТАКЖЕ с параметром number. Для проверки СМС отправляем запрос на СМС get_sms согласно условиям

Коды ошибок

В ходе выполнения могут произойти ошибки:

5) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Метод get_2fa

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

Пример

Результат

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

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

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

Первый запрос это redirect (подготовка переадресации) и второй запрос это redirect_confirm

В запросах указываются два дополнительных параметра - number_redirect (номер телефона на который нужно выполнить переадресацию) и amount(сумма в рублях, от 10 до 20)

Пример запроса redirect

Результат

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

Примечание

В параметре number_redirect указываем номер на который нужно выполнить переадресацию!

В параметре amount указываем сумму пополнения баланса сим-карты в рублях, может принимать значения от 10 до 20

Коды ошибок

В ходе выполнения могут произойти ошибки:

4) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Пример запроса redirect_confirm

Результат

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

Примечание

В параметре number_redirect указываем номер на который нужно выполнить переадресацию!

В параметре amount указываем сумму пополнения баланса сим-карты в рублях, может принимать значения от 10 до 20

Коды ошибок

В ходе выполнения могут произойти ошибки:

4) Могут произойти общие ошибки. Их описание находится в списке - Коды возвращаемых ошибок

Как правильно делать переадресаию по API:

1) Заказываем номер, пример строки

2) Дальше отправляем запрос на подготовку переадресации:

1) Ответ должен быть такой:

3) Дальше отправляем запрос на проверку переадресации:

1) Ответ должен быть такой:

4) Получаем СМС, пример строки

1) Если СМС ещё нет ответ будет такой:

Отправляем запрос в цикл с периодичность в 30 сек. пока не получим ответ: Переадресация успешно установилась, смс получено. Переадресация автоматически включится через 15 минут!

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

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

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

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

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

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

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

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

Если больше 10, то отправляем запрос на получение номера - https://simsms.org/priemnik.php?metod=get_number&country=ru&service=opt4&id=1&apikey=DSWAFvdedrE4

Распаршиваем ответ, записываем id из запроса в переменную и вводим полученный номер телефона в регистрацию в ВК и нажимаем на кнопку получить код.

Если пришел ответ , значит номера заняты, отправляем повторный запрос на получение номера (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)

Если в ответ на запрос получили ответ: , делаем паузу в 30 секунд и отправляем запрос на получение СМС заново.

Если ответ пришел такой - значит СМС нет, либо айди запроса не верный, либо истек срок ожидания СМС (Не более 10 минут)

Если ответ пришел такой -