API

API KEY

YOUR_API_KEY

API URL

https://activate-api.smsverified.com/stubs/handler_api.php

getBalance

Получение баланса

Описание

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

Параметры

Название	Тип	Описание
api_key	String	Your API KEY
action	String	getBalance

Тип ответа

text/html

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

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getBalance

Пример ответа на запрос

ACCESS_BALANCE:44.60

getCountries

Получение доступных стран

Описание

Возвращает страны с доступными номерами

Параметры

Название	Тип	Описание
api_key	String	Your API KEY
action	String	getCountries

Тип ответа

application/json

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

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getCountries

Пример ответа на запрос

{
  "31": {
    "id": 48,
    "rus": "Нидерланды",
    "eng": "Netherlands",
    "chn": "荷兰",
    "visible": 1,
    "rent": 0
  },
  "33": {
    "id": 78,
    "rus": "Франция",
    "eng": "France",
    "chn": "法國",
    "visible": 1,
    "rent": 0
  }
}

getNumbersStatus

Получение информации о доступных номерах

Описание

Возвращает информацию о доступных номерах для сервисов

Параметры

Название	Тип	Описание
api_key	String	Your API KEY
action	String	getNumbersStatus
country	Number	ID of the country

Тип ответа

application/json

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

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getNumbersStatus&country=78

Пример ответа на запрос

{
  "yahoo_0": 167,
  "wolt_0": 416,
  "telegram_0": 76,
  "snapchat_0": 391,
  "yemeksepeti_0": 416,
  "amazon_0": 83
}

getNumber

Получение номера для активации

Описание

Получение номера для активации. Возвращает ACCESS_NUMBER:ACCESS_ID:NUMBER, где ACCESS_ID - это ID номера и NUMBER - это сам номер

Параметры

Название	Тип	Описание
api_key	String	Your API KEY
action	String	getNumber
country	Number	ID of the country
service	String	name of the service
maxPrice	Number	maximum price for the number in USD (for example 1.2)
activationType	Number	activation type (0 - receive SMS (code in SMS); 1 - call (code as the calling number); 2 - voice message (the robot calls and the code is spoken by the robot voice)). Default is 0 - SMS

Тип ответа

text/html

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

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getNumber&country=48&service=vk

Пример ответа на запрос

ACCESS_NUMBER:8601705018416664:33774545375

getStatus

Получение кода

Описание

Этот запрос возвращает короткий код, содержащийся в SMS-сообщении, полученном на указанный номер (чтобы увидеть полный текст сообщения, проверьте запрос getFullSms). Этот запрос можно использовать, если вы уверены, что в сообщении нет другой информации, которую стоит хранить или использовать в будущем, кроме кода. В противном случае рассмотрите возможность использования запроса getFullSms.

Server response:
STATUS_OK:CODE - Code received (where CODE - activation code)
STATUS_WAIT_CODE - We are waiting for the arrival of SMS
STATUS_WAIT_RETRY:LASTCODE - We are waiting for another SMS LASTCODE - last received sms
STATUS_CANCEL - activation canceled
NO_ACTIVATION - activation is not found,
BAD_ACTION - invalid action

Параметры

Название	Тип	Описание
api_key	String	Your API KEY
action	String	getStatus
id	Number	ID of activation

Тип ответа

text/html

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

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getStatus&id=2791705004917001

Пример ответа на запрос

STATUS_OK:877613

getFullSms

Получение полного сообщения

Описание

Этот запрос возвращает полный текст полученного SMS-сообщения с заданного номера. Возможно, вы захотите использовать этот запрос, когда предоставленной getStatus информации недостаточно для понимания или вам нужны какие-то данные, содержащиеся в сообщении, например, когда SMS содержит не только код подтверждения, но и ссылку на промокод, дату и время получения или любую другую информацию, которую вы хотите использовать в своем приложении. Если пришло SMS-сообщение, ответ будет в формате: 'FULL_SMS:[отправитель] SMS_message'

Параметры

Название	Тип	Описание
api_key	String	Your API KEY
action	String	getFullSms
id	Number	ID of activation

Тип ответа

text/html

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

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getFullSms&id=2791705004917001

Пример ответа на запрос

FULL_SMS:[vk] 877613

setStatus

Обновить статус активации

Описание

Этот запрос позволяет вам изменить статус операции в соответствии с ее результатами (отменить операцию, получить текстовый код из следующего сообщения, закрыть операцию). Возможно, вы захотите использовать этот запрос, когда захотите явно изменить статус операции, например, когда вашему приложению необходимо получить информацию из второго сообщения, полученного по этому номеру.

Status code:
1 - inform when the phone number is ready (SMS was sent to this number),
3 - request digital code from the next message,
6 - close the operation
8 - Cancel the activation (if the number does not match you)

Server response:
ACCESS_READY - SMS waiting readiness
ACCESS_RETRY_GET - activation is successfully created, but the number is not ready yet,
ACCESS_ACTIVATION - Activation completed successfully
ACCESS_CANCEL - activation is canceled,
NO_ACTIVATION - activation is not found,
BAD_ACTION - invalid action

Параметры

Название	Тип	Описание
api_key	String	Your API KEY
action	String	setStatus
id	Number	ID of activation
status	Number	Activation status

Тип ответа

text/html

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

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=setStatus&id=2791705004917001&status=1

Пример ответа на запрос

ACCESS_ACTIVATION

getPrices

Получени информации о ценах

Описание

Получение информации о ценах. Возвращает JSON {Country: {Service: {cost: Cost, count: Count}}}

Параметры

Название	Тип	Описание
api_key	String	Your API KEY
action	String	getPrices

Тип ответа

application/json

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

https://activate-api.smsverified.com/stubs/handler_api.php?api_key=API_KEY&action=getPrices

Пример ответа на запрос

{
  "england": {
    "mb": {
      "count": 4123,
      "price": 0.4
    },
    "am": {
      "count": 4017,
      "price": 0.11
    }
  },
  "france": {
    "mb": {
      "count": 2123,
      "price": 0.13
    },
    "am": {
      "count": 2014,
      "price": 0.2
    }
  }
}