FAQAPI

Получение истории активаций

Метод getHistory используется для получения истории всех активаций виртуальных номеров, связанных с учётной записью через API SMS.online. Он позволяет автоматизировать процесс анализа выполненных активаций и мониторинга расходов на услуги.

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

Успешный запрос возвращает структурированный список активаций с детализированными данными: уникальный идентификатор активации, дата создания, номер телефона, список полученных SMS-сообщений, стоимость (для активных — 0) и статус активации. Метод подходит для систем аналитики и управления расходами на услуги.

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

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

ПараметрОбязательныйПримечаниеОписание
ДаСм. в профиле в настройках API КлючAPI-ключ обеспечивает доступ к оплаченным услугам
ДаgetHistoryНазвание метода
НетВременная метка в формате Unix TimestampС какой даты брать активации (ограничено 30 днями)
НетВременная метка в формате Unix TimestampПо какую дату брать активации (ограничено 30 днями)
НетЧисловое значениеСмещение первого элемента, возвращаемого в ответе (по-умолчанию 0)
НетЧисловое значениеКоличество элементов, возвращаемых в ответе (по-умолчанию 50, максимум 100)

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

JSON
[
  {
    "id": 635468024,
    "date": "2022-11-12 15:58:39",
    "phone": "79918529716",
    "sms": "["Your sms code"]",
    "cost": 100
    "status": "4"
  }
]

Пример кода

const api_key = "API_KEY"; # Замените 'API_KEY' на ваш реальный API-ключ.
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getHistory`);
# Выполняем GET-запрос к указанному URL
const data = await response.json();
# Выводим содержимое ответа от сервера
console.log(data);
} catch (err) {
# Если произошла ошибка, выводим сообщение об ошибке
console.error(err);
}

Возможные ошибки

ПараметрОписание
Некорректное действие
Неверный API-ключ
Ошибка в запросе
Время на которое аккаунт заблокирован
Аккаунт не активен
Некорректная дата