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-ключ
Помилка в запиті
Час, на який аккаунт заблоковано
Аккаунт не активний
Некоректна дата