API активации

Заказ номера

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

https://smsfastapi.com/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY

Входные параметры

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	См. в настройках аккаунта	Да	API-ключ обеспечивает доступ к оплаченным услугам
SERVICE	См. список сервисов в левом меню	Да	Сервис, номер для которого необходимо получить
OPERATOR	См. список операторов в левом меню	Нет	Сотовый оператор, номер которого необходимо получить
COUNTRY	См. список стран в левом меню	Да	Страна, номер которой необходимо получить
URL	Полный URL вебхука (http/https)	Нет	Адрес вебхука. Если указан, при поступлении SMS на купленный номер отправим POST с данными SMS.
MAXPRICE	Число (целое или дробное с точкой)	Нет	В случае, если покупаемый номер стоит больше переданного параметра, даже при наличии номеров будет возвращено NO_NUMBERS.

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

Ответ сервера	Пример	Описание
ACCESS_NUMBER:ID:NUMBER	ACCESS_NUMBER:234242:79123456789	Получили номер, ID активации - ID, сам номер с кодом страны - NUMBER

Этот запрос используется для управления состоянием номера в системе.

https://smsfastapi.com/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=STATUS&id=ID

Входные данные

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	См. в настройках аккаунта	Да	API-ключ обеспечивает доступ к оплаченным услугам
ID	Числовое значение	Да	ID активации, полученное при запросе номера
STATUS	Числовое значение	Да	Статус который необходимо передать номеру

Возможные значения статуса:

3 - запрошена повторная отправка SMS

6 - активация успешно завершена

8 - активация отменена, выполнен возврат средств

Выходные данные

Ответ сервера	Описание
STATUS_WAIT_CODE	Ожидаем прихода СМС
ACCESS_ACTIVATION	Активация успешно завершена
ACCESS_CANCEL	Активация отменена

Этот запрос используется для получения состояния номера в системе.

https://smsfastapi.com/stubs/handler_api.php?api_key=APIKEY&action=getStatus&id=ID

Входные данные

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	См. в настройках аккаунта	Да	API-ключ обеспечивает доступ к оплаченным услугам
ID	Числовое значение	Да	ID активации, полученное при запросе номера

Выходные данные

Ответ сервера	Описание
STATUS_WAIT_CODE	Ожидаем прихода СМС
STATUS_CANCEL	Активация отменена
STATUS_OK:CODE	Код получен (где CODE - код активации)

Запрос предназначен для получения информации о доступном количестве номеров.

https://smsfastapi.com/stubs/handler_api.php?api_key=APIKEY&action=getNumbersStatus&country=COUNTRY&operator=OPERATOR

Входные данные

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	См. в настройках аккаунта	Да	API-ключ обеспечивает доступ к оплаченным услугам
COUNTRY	См. список стран в левом меню	Да	Страна номера
OPERATOR	См. список операторов в левом меню	Нет	Оператор номера. Если параметр не задан, будет задействован случайный оператор

Выходные данные

Ответ сервера	Описание
JSON ответ	Ответ в формате {"Сервис_0":"Количество"}

актуальной информации о стоимости услуг.

https://smsfastapi.com/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY

Входные данные

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	См. в настройках аккаунта	Да	API-ключ обеспечивает доступ к оплаченным услугам
COUNTRY	См. список стран в левом меню	Да	Страна номера
SERVICE	См. список сервисов в левом меню	Нет	Сервис, номер для которого необходимо получить

Выходные данные

Ответ сервера	Описание
JSON ответ	Ответ в формате { "Страна": { "Сервис": { "Цена": Количество}}}

Этот запрос используется для получения текущего баланса учетной записи, связанной с указанным API-ключом.

https://smsfastapi.com/stubs/handler_api.php?api_key=APIKEY&action=getBalance

Входные параметры

Параметр	Принимаемые значения	Обязательность	Описание
APIKEY	См. в настройках аккаунта	Да	API-ключ обеспечивает доступ к оплаченным услугам

Выходные данные

Ответ сервера	Пример	Описание
ACCESS_BALANCE:BALANCE	ACCESS_BALANCE:540	BALANCE - баланс вашего аккаунта