API
API - это протокол взаимодействия между вашим ПО и нашим сервером активаций.
API нужен для того, чтобы автоматизировать процесс получение смс сообщений на вашей стороне
Для работы с API необходимо использовать ваш API ключ, получить его можно зайдя на страницу профиля
Наше ПО полностью совместимо с сайтами конкурентов
Пожалуйста, не делайте
1. Более 3 запросов в секунду на получение номера
2. Более 1 запроса в секунду на получение баланса и кол-ва свободных номеров
По умолчанию вам доступно 10 потоков. Под потоком имеется в виду активация которая Ожидает СМС - первичное или повторное. Если смс получено и код распознан, то эта активация уже не считается потоком.
Для увеличения лимита - можете обратится в Техподдержку
В АПИ НЕТ функции получения полной смс. Для нужной информации в поле КОДа - обратитесь в ТехПоддержку
Старайтесь не пользоваться Вебверсией сайта во время активных действий по API и наоборот.
Двойных отчислений за привлечение клиентов у нас нет.
Партнёрская программа имеет преимущество над реферальной.
Все запросы должны идти на https://smska.net/stubs/handler_api.php
POST или GET запросом.
Во всех запросах должен присутствовать API ключ в виде параметра "api_key"
Запрос количества доступных номеров:
$api_key - ключ АПИ
Ответ сервиса будет в json формате, пример:
{"av_0":120,"av_1":18,"ok_0":60,"ok_1":18,"vk_0":44,"vk_1":18 ... }
Варианты сервисов:
0 - без переадресации
1 - с переадресацией вызовов
Запрос баланса:
https://smska.net/stubs/handler_api.php?api_key=$api_key&action=getBalance
$api_key - ключ АПИ
Ответ сервиса:
ACCESS_BALANCE:$balance (где $balance - баланс на счету)
Возможные ошибки:
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера
Заказ номера:
https://smska.net/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&forward=$forward&operator=$operator
$api_key - ключ АПИ
$service - сервис для заказа
$forward - Необходимо ли выполнить переадресацию? Принимаемые значения - 0 (не выполнять), 1 - (выполнять). (необязательный параметр, по умолчанию равен 0)
$operator - Обязательный параметр - значение any. Функционала выбора оператора у нас нет и не планируется.
Список доступных сервисов:
av(Avito)
vk(Вконтакте)
ok(Одноклассники)
we(WeChat)
gl(Google)
is(Instagram)
yl(Юла)
wh(Whatsapp)
vi(Viber)
te(Telegram/Oi)
fb(Facebook)
tw(Twitter)
lu(CLUB-LUKOIL)
bd(Rambler)
le(LENTA)
ge(Gett)
mg(Магнолия)
ss(SeoSprint)
ya(Yandex)
yh(Yahoo)
ubr(Uber)
kw(Kwai)
sk(Роснефть)
ye(Yandex.Eda)
bk(BurgerKing)
ma(Mail.ru)
mi(Microsoft)
im(IMO)
gb(Globus)
ao(Aol)
mb(Mamba)
sl(SunLight)
au(AUTO.RU)
de(DeliveryClub)
pk(Perekrestok)
pt(Пятёрочка)
dv(ДругВокруг)
mx(Maxim)
oz(Другое)
tc(Tencent)
dp(DodoPizza)
mn(MAGNIT)
Получая номер через API вы подтверждаете согласие с правилами проекта
Ответы сервиса:NO_NUMBERS - нет номеров
NO_BALANCE - закончился баланс
ACCESS_NUMBER:$id:$number - номер выдан ($id - id операции,$number - номер телефона)
Возможные ошибки:
BAD_ACTION - некорректное действие
BAD_SERVICE - некорректное наименование сервиса
BAD_KEY - Неверный API-ключ
ERROR_SQL - ошибка SQL-сервера
Получить состояние активации:
https://smska.net/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
$api_key - ключ АПИ
$id - id активации
Ответы сервиса:STATUS_WAIT_CODE - ожидание смс
STATUS_WAIT_RETRY:$lastcode - ожидание уточнения кода (где $lastcode - прошлый, неподошедший код)
STATUS_CANCEL - активация отменена
STATUS_OK:$code - код получен (где $code - код активации)
Возможные ошибки:NO_ACTIVATION - id активации не существует
ERROR_SQL - ошибка SQL-сервера
BAD_KEY - Неверный API-ключ
BAD_ACTION - некорректное действие
Изменение статуса активации
https://smska.net/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward
$api_key - ключ АПИ
$id - id активации
$forward - номер телефона на который нужно выполнить переадресацию (обязательно, только если при getNumber был передан параметр forward=1). Формат 7xxxxxxxxxx - начинается с 7
$status - статус активации:
-1 - Отменить номер. СМС не пришло или этот номер больше не нужен. Данный номер повторно вам не будет выдаваться.
1 - Сообщить о готовности номера (Данный статус не обязательный. Наша система автоматически ждёт смс с начала аренды, данный код исключительно для универсальности API.)
3 - Повторно принять код.
6 - Статус для выставления переадресации
8 - Данный номер использован ранее НЕ МНОЙ в этом сервисе. В этом сервисе номер уже использован. ВНИМАНИЕ! Используйте этот код только если сервис вам отвечает о невозможности использования данного номера, в любых других случаях используйте код ОТМЕНА (-1)
Ответы сервиса:
ACCESS_READY - готовность номера подтверждена
ACCESS_RETRY_GET - ожидание нового смс
ACCESS_CANCEL - активация отменена
ACCESS_RETRY_CANCEL - повторная активация отменена
ACCESS_ERROR - отправленный код не пришел, технический специалист оповещается о проблеме на сайте
ACCESS_USED - полученный номер помечен как "использован" на данном сервисе
ACCESS_FWD - Получен номер для переадресации и запущена её установка (обычно после этого статуса переадресация начинает работать через 1-2 минут)
ACCESS_ACTIVATION - Данная переадресация уже установлена
Возможные ошибки:
ERROR_SQL - ошибка SQL-сервера
NO_ACTIVATION - id активации не существует
BAD_SERVICE - некорректное наименование сервиса
BAD_STATUS - некорректный статус
BAD_KEY - Неверный API-ключ
BAD_ACTION - некорректное действие
Время генерации: 0.01 сек.