API

API - это протокол взаимодействия между вашим ПО и нашим сервером активаций. 

API нужен для того, чтобы автоматизировать процесс получение смс сообщений на вашей стороне.

Для работы с API необходимо использовать ваш API ключ:
Войдите в ваш кабинет, чтобы его получить!

Описание протокола:
Все запросы должны идти на https://smsak.org/api/
Во всех запросах должен присутствовать обязательный параметр - API ключ.

 

https://smsak.org/api/numbersstatus/$api_key?code=$code
$api_key - ключ АПИ
$code - Код страны
Ответ сервиса будет в json формате, пример:
[{"id":"2","name":"Вконтакте","count":"108","logo":"/uploads/logo/vk.png","cost":"15"},{"id":"3","name":"Odnoklassniki","count":"6","logo":"/uploads/logo/ok.png","cost":"6"},{"id":"4","name":"Avito","count":"127","logo":"/uploads/logo/av.png","cost":"5"},{"id":"5","name":"viber","count":"127","logo":"/uploads/logo/vi.png","cost":"3"},{"id":"6","name":"telegram","count":"126","logo":"/uploads/logo/te.png","cost":"3"},{"id":"7","name":"whatsapp","count":"126","logo":"/uploads/logo/wh.png","cost":"1"},{"id":"8","name":"WeChat","count":"126","logo":"/uploads/logo/wc.png","cost":"6"},{"id":"9","name":"Google,Youtube,Gmail","count":"124","logo":"/uploads/logo/go.png","cost":"5"},{"id":"10","name":"youla.io","count":"126","logo":"/uploads/logo/yu.png","cost":"2"},{"id":"11","name":"Yahoo","count":"125","logo":"/uploads/logo/yo.png","cost":"2"},{"id":"12","name":"Microsoft","count":"125","logo":"/uploads/logo/mi.png","cost":"1"},{"id":"13","name":"facebook","count":"125","logo":"/uploads/logo/fb.png","cost":"1"},{"id":"14","name":"Rambler.ru","count":"126","logo":"/uploads/logo/ra.png","cost":"1"},{"id":"15","name":"yandex","count":"123","logo":"/uploads/logo/ya.png","cost":"5"},{"id":"16","name":"instagram","count":"125","logo":"/uploads/logo/in.png","cost":"4"},{"id":"17","name":"drugvokrug.ru","count":"124","logo":"/uploads/logo/we0.png","cost":"1"},{"id":"18","name":"mamba.ru","count":"125","logo":"/uploads/logo/78.jpg","cost":"1"},{"id":"19","name":"Qiwi","count":"125","logo":"/uploads/logo/qi.png","cost":"3"},{"id":"20","name":"WebMoney","count":"126","logo":"/uploads/logo/webmoney.png","cost":"5"},{"id":"21","name":"fotostrana.ru","count":"126","logo":"/uploads/logo/fotostrana.png","cost":"1"},{"id":"22","name":"ICQ","count":"126","logo":"/uploads/logo/ic.png","cost":"1"},{"id":"23","name":"Twitter","count":"127","logo":"/uploads/logo/tw.png","cost":"2"},{"id":"24","name":"Mail.ru","count":"126","logo":"/uploads/logo/ma.png","cost":"1"},{"id":"25","name":"Uber","count":"126","logo":"/uploads/logo/ub.png","cost":"3"}]
https://smsak.org/api/getbalance/$api_key
$api_key - ключ АПИ
Ответ сервиса, пример:
500
https://smsak.org/api/getnumber/$api_key?id=$service&code=$code
$api_key - ключ АПИ
$service - id сервиса для заказа
$code - Код страны
Ответ сервиса будет в json формате, пример:
{"id":707,"number":"+79777777777","send":0}
https://smsak.org/api/countries/$api_key
$api_key - ключ АПИ
Ответ сервиса будет в json формате, пример:
[{"name":"Россия","code":"RU"},{"name":"Украина","code":"UA"},{"name":"Казахстан","code":"KZ"},{"name":"Узбекистан","code":"UZ"},{"name":"Швеция","code":"SE"},{"name":"Белоруссия","code":"BL"},{"name":"Великобритания","code":"GB"},{"name":"Молдова","code":"MD"},{"name":"Индонезия","code":"ID"},{"name":"Эстония","code":"EE"}]
https://smsak.org/api/getservices/$api_key
$api_key - ключ АПИ
Ответ сервиса будет в json формате, пример:
[{"id":3,"name":"Odnoklassniki","logo":"/uploads/logo/ok.png","cost":6},{"id":2,"name":"Вконтакте","logo":"/uploads/logo/vk.png","cost":15},{"id":4,"name":"Avito","logo":"/uploads/logo/av.png","cost":5},{"id":5,"name":"viber","logo":"/uploads/logo/vi.png","cost":3},{"id":6,"name":"telegram","logo":"/uploads/logo/te.png","cost":3},{"id":7,"name":"whatsapp","logo":"/uploads/logo/wh.png","cost":1},{"id":8,"name":"WeChat","logo":"/uploads/logo/wc.png","cost":6},{"id":9,"name":"Google,Youtube,Gmail","logo":"/uploads/logo/go.png","cost":5},{"id":10,"name":"youla.io","logo":"/uploads/logo/yu.png","cost":2},{"id":11,"name":"Yahoo","logo":"/uploads/logo/yo.png","cost":2},{"id":12,"name":"Microsoft","logo":"/uploads/logo/mi.png","cost":1},{"id":13,"name":"facebook","logo":"/uploads/logo/fb.png","cost":1},{"id":14,"name":"Rambler.ru","logo":"/uploads/logo/ra.png","cost":1},{"id":15,"name":"yandex","logo":"/uploads/logo/ya.png","cost":5},{"id":16,"name":"instagram","logo":"/uploads/logo/in.png","cost":4},{"id":17,"name":"drugvokrug.ru","logo":"/uploads/logo/we0.png","cost":1},{"id":18,"name":"mamba.ru","logo":"/uploads/logo/78.jpg","cost":1},{"id":19,"name":"Qiwi","logo":"/uploads/logo/qi.png","cost":3},{"id":20,"name":"WebMoney","logo":"/uploads/logo/webmoney.png","cost":5},{"id":21,"name":"fotostrana.ru","logo":"/uploads/logo/fotostrana.png","cost":1},{"id":22,"name":"ICQ","logo":"/uploads/logo/ic.png","cost":1},{"id":23,"name":"Twitter","logo":"/uploads/logo/tw.png","cost":2},{"id":24,"name":"Mail.ru","logo":"/uploads/logo/ma.png","cost":1},{"id":25,"name":"Uber","logo":"/uploads/logo/ub.png","cost":3}]
https://smsak.org/api/getstatus/$api_key?id=$id
$api_key - ключ АПИ
$id - id активации
Ответ сервиса будет в json формате, пример:
{"number":"+79777777777","from":"VKcom","text":"VK: 93401 - ваш код для регистрации ВКонтакте.","small":"93401","time":"2017-08-06 12:47:29"}
https://smsak.org/api/all-sms/$api_key?id=$id
$api_key - ключ АПИ
$id - id активации
Ответ сервиса будет в json формате, пример:
[{"number":"+79777777777","from":"VKcom","text":"509752 - код подтверждения регистрации","small":"509752","time":"2019-02-07 09:34:03"},{"number":"+79777777777","from":"VKcom","text":"VK: 93401 - ваш код для регистрации ВКонтакте.","small":"93401","time":"2017-08-06 12:47:29"}]
https://smsak.org/api/getlatestcode/$api_key?id=$id
$api_key - ключ АПИ
$id - id активации
Ответ сервиса, пример:
94983
https://smsak.org/api/play/$api_key?id=$id
$api_key - ключ АПИ
$id - id активации
Ответ сервиса, пример:
1
https://smsak.org/api/setstatus/$api_key?id=$id&status=$status
$api_key - ключ АПИ
$id - id активации
$status - статус активации
$status = 1 - Вернуть номер (если на номер не пришло сообщение, деньги за номер будут возвращены)
$status = 2 - Установить номер для переадресации вызовов (Только для сервисов с переадресацией). Необходимо указать номер в переменной $forward (&forward=79007777777)
Переадресацию можно выставить ТОЛЬКО после приема первой смс
Ответ сервиса, при успешном изменении статуса:
1
Ответ сервиса, при ошибке:
{"error":"Возврат возможен не ранее чем через 30 секунд после взятия"}
{"name":"error","message":"Api ключ не действителен","code":202,"status":200,"type":"app\helpers\apiException"}
name - При возникновении ошибки всегда имеет значение "error"
message - Обозначение ошибки
code - Код ошибки
status - Статус (HTTP код), всегда имеет значение "200"
Возможные коды ошибок:
101 - 'Сервис не найден'
102 - 'Не достаточно средств'
103 - 'Нет доступных номеров'
201 - 'Отсутствует api ключ'
202 - 'Api ключ не действителен'
203 - 'Пользователь заблокирован: Причина'

Апи для аренды номеров

https://smsak.org/api/getfullnumbers/$api_key
$api_key - ключ АПИ
Ответ сервиса будет в json формате, пример:
{"RU":"10","UA":"5","KZ":"8"}
https://smsak.org/api/getfullnumber/$api_key?code=$code&tarif=$tarif
$api_key - ключ АПИ
$code - код страны
$tarif - id тарифа (определяет срок аренды)
Ответ сервиса будет в json формате, пример:
https://smsak.org/api/getallfullnumbers/$api_key
$api_key - ключ АПИ
Ответ сервиса будет в json формате, пример:
[{"id":19999999,"time":"2012-10-14 20:48:12","number":"+3809999999999", "is_work":0}]
id - ИД арендованного номера
time - Дата, до которой номер взят в аренду
number - Номер в международном формате
is_work - Статус номера (1 - в сети, 0 - не в сети)
https://smsak.org/api/send-enable-sim/$api_key?id=$id
$api_key - ключ АПИ
$id - ИД арендованного номера
Ответ сервиса будет текстом, пример:
1
0 - Ошибка
1 - Запрос на включение успешно отправлен
2 - Запрос уже был ранее отправлен, номер в стадии включения в сеть
https://smsak.org/api/send-disable-sim/$api_key?id=$id
$api_key - ключ АПИ
$id - ИД арендованного номера
Ответ сервиса будет текстом, пример:
1
0 - Ошибка
1 - Запрос на отключение успешно отправлен
https://smsak.org/api/getallsmsofnumber/$api_key?phone=$phone
$api_key - ключ АПИ
$phone - номер телефона взятого в аренду
Ответ сервиса будет в json формате, пример:
[{"time":"2012-10-05 21:28:28","from":"Taxify","text":"9999 is your Taxify activation code.","number":"+380999999999"}]
https://smsak.org/api/getlastsmsofnumber/$api_key?phone=$phone&count=$count
$api_key - ключ АПИ
$phone - номер телефона взятого в аренду
$count - количество последних смс
Ответ сервиса будет в json формате, пример:
[{"time":"2012-10-05 21:28:28","from":"Taxify","text":"9999 is your Taxify activation code.","number":"+380999999999"}]
https://smsak.org/api/getalltarifs/$api_key
$api_key - ключ АПИ
Ответ сервиса будет в json формате, пример:
[{"id":1,"days":1,"cost":"150.00","country_id":1,"code":"RU"},{"id":2,"days":7,"cost":"400.00","country_id":1,"code":"RU"},{"id":14,"days":90,"cost":"3600.00","country_id":2,"code":"UA"},{"id":15,"days":90,"cost":"2700.00","country_id":3,"code":"KZ"},{"id":16,"days":180,"cost":"5400.00","country_id":1,"code":"RU"},{"id":17,"days":180,"cost":"5400.00","country_id":2,"code":"UA"},{"id":18,"days":180,"cost":"3600.00","country_id":3,"code":"KZ"}]
https://smsak.org/api/rebuynumber/$api_key?id=$id&tarif=$tarif
$api_key - ключ АПИ
$id - id номера взятого в аренду
$tarif - id тарифа (определяет срок аренды)
Ответ сервиса будет в json формате, пример:

Апи смс-активейта

Для эмуляции api смс-активейта необходимо прописать в файл hosts Вашей операционной системы IP нашего сервера к домену смс-активейта 135.125.0.45
Также возможно прямое обращение через наш сайт https://smsak.org/stubs/handler_api.php
Некоторые методы могут незначительно отличаться
https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country&operator=$operator
$api_key - ключ АПИ
$country - страна
Ответ сервиса будет в json формате. Пример:
{"vk_0":154,"ok_0":155,"wa_0":241,"vi_0":102,"tg_0":80,"wb_0":92,"go_0":198,"av_0":118,"av_1":162,"fb_0":230}
Где до черточки - название сервиса, после обозначение нужно ли включать переадресацию. 0 - нет. 1 - да.
https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getBalance
$api_key - ключ АПИ
Ответ сервиса будет в текстовом формате
ACCESS_BALANCE:'баланс на счету'
https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&operator=$operator&ref=$ref&country=$country
$api_key - ключ АПИ
$service - сервис для заказа
$operator - сотовый оператор номера
$ref - передать реферальный идентификатор
Ответ сервиса будет в текстовом формате
NO_NUMBERS - нет номеров
NO_BALANCE - закончился баланс
ACCESS_NUMBER:$id:$number , где ($id - id операции,$number - номер телефона)
https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id
$api_key - ключ АПИ
$id - ИД арендованного номера
$status - статус активации (1: сообщить о готовности номера (смс на номер отправлено); 3: запросить еще один код (бесплатно); 6: завершить активацию)
Ответ сервиса будет в текстовом формате:
ACCESS_READY - готовность номера подтверждена
ACCESS_RETRY_GET - ожидание нового смс
ACCESS_ACTIVATION - сервис успешно активирован
ACCESS_CANCEL - активация отменена
https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
$api_key - ключ АПИ
$id - ID активации
Ответ сервиса будет в текстовом формате:
STATUS_WAIT_CODE - ожидание смс
STATUS_WAIT_RETRY:'прошлый, неподошедший код' - ожидание уточнения кода
STATUS_CANCEL - активация отменена
STATUS_OK:'код активации' - код получен
https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getFullSms&id=$id
$api_key - ключ АПИ
$id - ID активации
Ответ сервиса будет в текстовом формате:
STATUS_WAIT_CODE - ожидание смс
STATUS_CANCEL - активация отменена
FULL_SMS:полный текст получен
https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country
$api_key - ключ АПИ
$service - краткое наименование сервиса (необязательно)
$country - кодовое наименование страны (необязательно)
Ответ сервиса будет в json формате, пример:
{"0":{"ot":{"count":0,"cost":5},"vk":{"count":0,"cost":19},"ok":{"count":26,"cost":3},"av":{"count":81,"cost":1}}
https://smsak.org/stubs/handler_api.php?api_key=$api_key&action=getCountries
$api_key - ключ АПИ
Ответ сервиса будет в json формате, пример:
{"0":{"id":"0","rus":"Россия","visible":1,"retry":1,"rent":0,"multiService":0},"1":{"id":"1","rus":"Украина","visible":1,"retry":1,"rent":0,"multiService":0},"40":{"id":"40","rus":"Узбекистан","visible":1,"retry":1,"rent":0,"multiService":0},"16":{"id":"16","rus":"Великобритания","visible":1,"retry":1,"rent":0,"multiService":0},"6":{"id":"6","rus":"Индонезия","visible":1,"retry":1,"rent":0,"multiService":0},"34":{"id":"34","rus":"Эстония","visible":1,"retry":1,"rent":0,"multiService":0}}

Альтернативный способ работы

Использование собственного ПО для передачи номеров и смс (виртуальные сим, есим и прочие варианты) Инструкция