API

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

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

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

Все запросы должны идти на http://temp-sim.ru/tools/api.rb

Парметры в запросах можно передавать как методами GET так и POST. Однако в целях безопасности мы настоятельно советуем искользовать POST



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

Передаваемые патаметры

api_key - ключ АПИ

action "getNumbersStatus"

country - страна

может принимать значени: russia 

operator - оперетор

TELE2 ;

Ответ сервера

Ответ сервера - JSON массив вида {"vk."=>0} Где значение параметра - колличество свободных номеров а наименование

[1] = Вконтакте; [1] = Facebook; [1] = Одноклассники; [1] = Twitch; [1] = Instagram; [1] = Gmail, Google,Youtube; etc = LinkedIN; [1] = AOL; etc = Разное; [1] = Delivery Club; [1] = Viber ; [1] = Telegram; [1] = Avito; [1] = Uber; [1] = Microsoft; etc = KakaoTalk; etc = Drom.ru; etc = Tinder; [1] = Steam; [1] = Яндекс; [1] = Пятерочка; [1] = ДругВокруг; [1] = Yahoo; [1] = Line messenger; [1] = Airbnb; [1] = QIWI; [1] = mail.ru; [1] = Whatsapp ; [1] = Роснефть; [1] = Лента; [1] = М.видео; [1] = Dixy; error = Юла; [1] = Gett; [1] = superabonent.tele2.ru;



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

Передаваемые патаметры

api_key - ключ АПИ

action "getBalance"

Ответ сервера

Ответ сервера - JSON массив вида {"ACCESS_BALANCE":"XXXX.XX","ERROR":"NO"}



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

Передаваемые патаметры

api_key - ключ АПИ

action "getNumber"

passwd пароль от аккаунта

service - может принимать значения (по умолчание все):

vendor - АПИ ключ продавца продавца может не передавать (по умолчание все):

idsimrecipt - id sim карты Если передать этот параметр будет попытка повторой аренды номера на указанной sim карте

13 = Вконтакте; 14 = Facebook; 15 = Одноклассники; 16 = Twitch; 17 = Instagram; 19 = Gmail, Google,Youtube; 20 = LinkedIN; 21 = AOL; 22 = Разное; 23 = Delivery Club; 24 = Viber ; 25 = Telegram; 26 = Avito; 27 = Uber; 28 = Microsoft; 29 = KakaoTalk; 30 = Drom.ru; 31 = Tinder; 32 = Steam; 33 = Яндекс; 34 = Пятерочка; 35 = ДругВокруг; 36 = Yahoo; 37 = Line messenger; 38 = Airbnb; 40 = QIWI; 41 = mail.ru; 42 = Whatsapp ; 43 = Роснефть; 44 = Лента; 45 = М.видео; 46 = Dixy; 48 = Юла; 49 = Gett; 50 = superabonent.tele2.ru;

operator может принимать значения (по умолчание любой):

TELE2 ;

country operator может принимать значения (по умолчание любая):

russia 

Ответ сервера

Ответ сервера - JSON массив вида {"ACCESS_NUMBER":"XXXXXX"}

где XXXXXX может принимать значения
При успешном заказе - ID заказа
NO_BALANCE_BUYER - недостаточно денег у покупателя
NO_BALANCE_VENDOR - недостаточно денег у продавца
NO_NUMBERS - нет свободных номеров



Установить статус активации:

Передаваемые патаметры

api_key - ключ АПИ

action - "setStatus"

id - ID аткивации

passwd - пароль от аккаунта

status - может принимать значения : -1 - Отмена активации
1 - Завершение (смс получено)
2 - сообщить о том, что номер использован и отменить активацию

Ответ сервера

Ответ сервера - JSON массив вида {"STATUS":"OK"} или {"STATUS":"FAIL"}

Второй указывает что операция не выполнена



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

Передаваемые патаметры

api_key - ключ АПИ

action "getStatus"

id - id аткивации



Ответ сервера

Ответ сервера - JSON массив вида {"STATUS"=>"XXXXXX"}

где XXXXXX может принимать значения
Активация не найдена - NO_ACTIVATION
Истекло время активации - STATUS_CANCEL
Ожидаем CMC - STATUS_WAIT_CODE
СМС поступило - OK при этом добавляется поле "SMS"=>"текст смс"