HTTP/HTTPS API

Усі запити, крім /api/login, /api/register, /api/restore_password і /api/public/*, потребують Bearer-токен. Ті самі методи доступні під префіксом /api/v1/....

Базовий URL: https://sms-numbers.co/api

Для POST з тілом надсилайте Content-Type: application/json. Відповіді приходять з Content-Type: application/json; charset=UTF-8.

Повертає номери акаунта (з країною та статусом). Тимчасові/OTP-номери за замовчуванням приховані.

Header: Authorization: Bearer <api_token>

• filter (string) — опційний фільтр за статусом (filter_slug), наприклад active.
• include_disposable (boolean) — включити тимчасові номери для реєстрації.

Дані конкретного номера, що належить вам.

Шлях: id (integer) — ID зі списку. 404 якщо не знайдено.

Залишено для сумісності. Для тарифів використовуйте публічні методи цін, потім POST /api/number/buy.

Шлях: iso — ISO-код країни, наприклад ru, us.

Тарифи: GET https://sms-numbers.co/api/public/countries і GET https://sms-numbers.co/api/public/prices/{country_id}.

Оформлює замовлення довгострокового номера. Списує баланс; при нестачі коштів повертає 402 з посиланнями на оплату. У профілі має бути валідний email (для переадресації SMS).

JSON-тіло:

• agree_terms (обовʼязково) — згода з умовами (true / 1).
• number_price_id (integer) — ID тарифу з /api/public/prices/{id} (обовʼязковий, якщо не вказано country).
• country (integer) — те саме, що ID тарифу (аліас number_price_id).
• period (integer, 1–36, за замовч. 1) — строк у місяцях.
• payment_method (опційно, за замовч. balance) — оплата з балансу; інакше створюється очікуючий платіж.

Приклад тіла:

Скасовує непідключене замовлення (з поверненням при оплаті з балансу) або планує відключення активного номера.

• id (обовʼязково, integer) — ID номера.
• asap (boolean, опційно) — відключити одразу; інакше до valid_till.

Переадресація вхідних SMS і користувацький тег.

• id (обовʼязково).
• email — переадресація на email (dest_email).
• number — переадресація на телефон (dest_number).
• user_tag — власна мітка.

Замовлення disposable-номера для сервісу (≈15 хвилин). Та сама логіка балансу / посилань на оплату.

• service_id (обовʼязково) — ID сервісу з /api/public/services.
• country_id (обовʼязково) — ID країни з /api/public/services/{id}/countries.
• agree_terms (обовʼязково) — згода з умовами.
• payment_method (опційно, за замовч. balance).

Сценарій: GET /api/public/services → GET /api/public/services/{id}/countries → POST /api/service/buy.

Країни, для яких зараз є пакети eSIM. Необов’язковий параметр q фільтрує за назвою або ISO.

Тарифи країни. iso — дволітерний код, наприклад de. У пакеті є package_id, обсяг data, validity_days і price_eur.

Списує баланс і повертає замовлення з QR і полями встановлення. Якщо балансу не вистачає, відповідь 402 з посиланнями на оплату.

package_id (обов’язково) — id пакета зі списку пакетів.

Завершені замовлення eSIM, спочатку нові. Параметр page — наступна сторінка (по 20).

Одне замовлення: sims з qrcode, qrcode_url, iccid і direct_apple_installation_url, якщо Airalo їх віддав, плюс HTML встановлення.

Усі SMS акаунта.

Останнє повідомлення по кожному співрозмовнику (список чатів).

Історія з {number}. Позначає повідомлення як переглянуті.

Вихідне SMS (одне або кілька). Потрібен додатний баланс.

• from (string) — ваш віртуальний номер; якщо не знайдено — системний відправник.
• to (обовʼязково) — отримувач; цифри та + ( ) -; кілька номерів через кому.
• body (обовʼязково) — текст.

Обʼєкт поточного користувача.

Опційні поля: firstname, lastname, phone, country, city, address, zip, company, telegram_id.

Повертає credit і код валюти.

Платежі акаунта, нові зверху.

Створює очікуюче поповнення і повертає посилання на оплату.

• amount (обовʼязково, від 1 до 2000) — сума в EUR.
• method (обовʼязково) — card або crypto.
• number_price_id (опційно) — привʼязати опис тарифу номера.

У відповіді є payment_link → /api/payment/{id}/{method}/pay.

Усі країни каталогу.

Країни, де є довгострокові тарифи.

Країна, оператори (MCC/MNC) і доступні типи продуктів.

Довгострокові (numbers_prices), disposable (numbers_disposable_prices), вихідні SMS (messages_outgoing_prices) і метадані країни.

OTP / сервіси реєстрації, доступні через API.

Країни та ціни setup для сервісу (id зі списку сервісів).

Тіло: email, password. Повертає data.token.

Тіло: email, password (мін. 6); опційно firstname, lastname. Повертає користувача з API-токеном.

Тіло: email — надсилає посилання для скидання.

Успіх: {"success": true, "data": {...}, "message": "..."}

Помилка: {"success": false, "message": "...", "data": {...}}