Разовая активация · REST + MCP

Один номер — один код

Купите приватный номер, поймайте код подтверждения и идите дальше. Активация живёт около 20 минут, а если SMS так и не придёт, деньги остаются у вас: предоплаченный баланс вернётся, а неисполненное удержание x402 будет снято.

Подключить ИИ-клиент Перейти к быстрому старту REST
Срок жизни
Около 20 минут
Что вы получаете
Один код подтверждения
Лучше всего для
Подтверждения аккаунтов и одноразовых паролей
800+ поддерживаемых сервисов
200+ стран в наличии
Без регистрации чтобы посмотреть цены
За номер никаких подписок

Начните разработку

Получите API-ключ меньше чем за минуту

Регистрация по адресу электронной почты — без карты и без звонков менеджера. Ссылка для входа вернёт вас на эту страницу и выдаст ключ, который работает и с REST API, и с MCP-сервером.

Создание бесплатно. Вы платите за каждый номер, никаких подписок.

Как это работает

Четыре шага от начала до конца

Каждый шаг ниже соответствует реальным эндпоинтам и реальным инструментам. Сохраните id, который возвращает покупка, — всё дальнейшее опирается на него.

  1. 1

    Посмотрите актуальное наличие

    Запросите список сервисов, затем стран. Наличие и точные цены в USD возвращаются в реальном времени.

    GET /v1/sms/activation/servicesGET /v1/sms/activation/countries sms_activation_list_servicessms_activation_list_countries
  2. 2

    Купите один номер

    Выберите оплату с баланса или x402 без аккаунта и сохраните возвращённый id активации.

    POST /v1/sms/activation/numbers sms_activation_buy_number
  3. 3

    Опрашивайте до прихода кода

    Читайте статус каждые несколько секунд, пока не придёт код или активация не завершится.

    GET /v1/sms/activation/numbers/{id} sms_activation_get_code
  4. 4

    Завершите или получите возврат

    Используйте код сразу. Если SMS не придёт до истечения срока, средства за активацию вернутся автоматически.

Настройка один раз

Подключите Voxisim к своему ИИ-клиенту

Подключите размещённый эндпоинт — и агент сам сравнит варианты по цене, купит номер и отдаст вам код, без единого запроса с вашей стороны. Ставить нечего: ни пакета, ни локального сервера, ни контейнера — только один URL и вход через браузер.

Размещённый эндпоинт https://api.voxisim.com/mcp
Streamable HTTP · OAuth или bearer-ключ
  1. 01

    Добавьте эндпоинт

    Выберите свой клиент ниже и скопируйте нужный ему блок.

  2. 02

    Войдите один раз

    Подтвердите вход через OAuth в браузере или передайте ключ vxs_ из менеджера секретов, если OAuth не подходит.

  3. 03

    Просто попросите

    Агент сам выбирает нужные инструменты и передаёт id между ними, поэтому одной фразы хватает на весь цикл.

Claude

Веб + десктоп

OAuth

Откройте «Настройки → Коннекторы», добавьте свой коннектор с именем Voxisim и вставьте размещённый эндпоинт.

Без файла конфигурации 
https://api.voxisim.com/mcp

Нажмите «Подключить» и завершите вход в браузере. Включите Voxisim в разделе инструментов и поиска в чате.

Работа агента

Что на самом деле делает ваш агент

Инструменты типизированы и названы по задачам, поэтому результат возвращается структурированными полями, а не текстом, который агенту приходится перечитывать. Покупки списываются с баланса или отвечают платёжным запросом, который агент подписывает с кошелька.

Инструментов для этого продукта: 5

  • sms_activation_list_services
  • sms_activation_list_countries
  • sms_activation_buy_number
  • sms_activation_get_code
  • sms_activation_list_numbers

Попробуйте попросить агента

Найди самую дешёвую доступную страну для WhatsApp, купи одну активацию и дождись кода подтверждения.
Покажи доступные страны и точные текущие цены для активации Telegram, ничего пока не покупая.
Проверь мои активные SMS-активации и сообщи о каждом пришедшем коде.

REST

Быстрый старт REST

Поиск публичный — первый блок можно выполнить прямо сейчас без аккаунта. Для покупки нужен либо предоплаченный ключ, либо подписанный платёж x402, а тело запроса в обоих случаях одинаковое.

Два способа оплаты, один вызов покупки

Предоплаченный баланс проще, если вы покупаете часто. x402 без аккаунта лучше для разовой автономной покупки — сохраните receipt_token из первого оплаченного ответа, чтобы потом прочитать, что вы купили.

1. Бесплатный поиск

Аккаунт не нужен. Получите актуальное наличие и точные цены до покупки.

curl 'https://api.voxisim.com/v1/sms/activation/services'
curl 'https://api.voxisim.com/v1/sms/activation/countries?service_id=SERVICE_ID'

2A. Оплата с баланса

Создайте аккаунт один раз, пополните его через x402 и используйте полученный ключ vxs_ для покупок.

curl -X POST https://api.voxisim.com/v1/signup \
  -H 'content-type: application/json' \
  -d '{"label":"docs-quickstart"}'

curl -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

2B. Или оплата без аккаунта через x402

Отправьте покупку без учётных данных, подпишите одно требование из ответа 402 и повторите тот же запрос.

curl -i -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

curl -X POST https://api.voxisim.com/v1/sms/activation/numbers \
  -H 'content-type: application/json' \
  -H 'X-PAYMENT: BASE64_SIGNED_AUTHORIZATION' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

3. Опрашивайте до прихода кода

Опрашивайте каждые несколько секунд, пока codes не станет непустым или done не станет true.

curl 'https://api.voxisim.com/v1/sms/activation/numbers/YOUR_ACTIVATION_ID' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
Метод Маршрут Что делает
GET /v1/sms/activation/services Список сервисов и самых дешёвых актуальных вариантов
GET /v1/sms/activation/countries Список стран, наличие и точные цены
POST /v1/sms/activation/numbers Покупка разового номера
GET /v1/sms/activation/numbers/{id} Статус и полученные коды
GET /v1/sms/activation/numbers Список активных или архивных активаций

Рабочие заметки

Возвраты, истечение срока и корректное восстановление

Истечение срока и сбои у провайдера — это нормальные состояния, а не исключения. Ветвитесь по типизированной ошибке, повторяйте поиск перед повтором запроса и не считайте, что цена прошлого запуска ещё действует.

Нет SMS — нет оплаты

Если ничего не придёт до истечения примерно 20 минут, возврат произойдёт автоматически. Предоплаченный баланс вернётся, а авторизация x402 будет снята без списания — просить об этом не нужно.

Один код, и он потрачен

Опрашивайте номер, пока codes не станет непустым или done не станет true, затем используйте код без промедления. Активация не поймает второе сообщение — для новой попытки начните новую.

Держите секреты вне промптов

Ключам vxs_ и значениям receipt_token из x402 место в менеджере секретов, а не в промптах, репозитории или логах.

Когда что-то пошло не так

  • invalid_argument — сервис, страна или интервал устарели. Повторите поиск и отправьте актуальное сочетание.
  • payment_required — ожидаемо на пути x402. Подпишите одно из предложенных требований и повторите точно такой же запрос.
  • number_unavailable или конфликт — этот вариант только что закончился. Повторите поиск и выберите другой, а не повторяйте ту же покупку.
  • provider_unavailable или ограничение частоты — сделайте паузу и следуйте подсказке о повторе из ошибки. Немедленный повтор только ухудшит ситуацию.

Ещё не определились?

Активация и аренда решают разные задачи

Берите самый короткий срок, которого хватает вашему сценарию. Наличие и цены актуальны для обоих вариантов.

SMS-активация

Вы здесь

Купите разовый номер телефона и получите на него код подтверждения.

  • Около 20 минут
  • Один код подтверждения
  • Подтверждения аккаунтов и одноразовых паролей

Аренда SMS

Арендуйте номер телефона на выбранный срок и получайте его SMS-сообщения.

  • От суток
  • Несколько SMS-сообщений
  • Сессий, тестирования и постоянного доступа
Читать руководство «Аренда SMS»

Где подходит разовая активация

Одноразовые паролиПодтверждение аккаунтаАвтоматизация регистраций и QAКороткие задачи для агентов

Вопросы и ответы

Вопросы об активации

  • Около 20 минут с момента покупки. Это окно даётся на получение кода, а не на владение номером: после истечения номер пропадает и продлить его нельзя.

  • Возврат придёт автоматически по истечении срока. Не нужно писать в поддержку и подавать заявку: предоплаченный баланс вернётся, а неисполненная авторизация x402 просто снимется.

  • Нет. Активация рассчитана на одно подтверждение. Нужно подтвердить ещё раз — купите новую; именно поэтому это самый дешёвый вариант за код.

  • Обычно в течение нескольких секунд после отправки сервисом, но это зависит целиком от сервиса, а не от нас. Опрашивайте каждые несколько секунд, а не ждите одного длинного запроса.

  • Нет. Вызывайте эндпоинт стран прямо перед покупкой — он возвращает актуальное наличие и точную цену, а они следуют за реальным предложением.

  • Да. Отправьте покупку без учётных данных, подпишите пришедший в ответ вызов x402 и повторите запрос. Для поиска учётные данные и так не нужны.

Справочник

Сгенерированные контракты

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

Интерактивный APIИзучите операции в Scalar REST в MarkdownСгенерировано из OpenAPI MCP в MarkdownСгенерировано из метаданных инструментов OpenAPI JSONМашиночитаемый контракт

Готовы купить первый номер?

Подключите MCP-клиент и попросите его — или скопируйте быстрый старт REST и запустите.

Открыть справочник API Сравнить оба продукта