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": {...}}