Многоразовая аренда · REST + MCP

Номер, который остаётся вашим

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

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

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

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

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

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

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

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

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

  1. 1

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

    Запросите сервисы, страны и доступные интервалы аренды с их точными текущими ценами в USD.

    GET /v1/sms/rental/servicesGET /v1/sms/rental/countriesGET /v1/sms/rental/intervals sms_rental_list_servicessms_rental_list_countriessms_rental_list_intervals
  2. 2

    Арендуйте на интервал

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

    POST /v1/sms/rental/numbers sms_rental_buy_number
  3. 3

    Собирайте сообщения

    Опрашивайте номер в течение всей аренды и используйте курсоры, чтобы получать сообщения без дублей.

    GET /v1/sms/rental/numbers/{id}/codes sms_rental_get_codes
  4. 4

    Отмените или продлите

    Отмените аренду, если она подлежит возврату, или запросите доступные варианты продления с ценами и продлите активную аренду.

    POST /v1/sms/rental/numbers/{id}/cancelGET /v1/sms/rental/numbers/{id}/extend-optionsPOST /v1/sms/rental/numbers/{id}/extend sms_rental_cancelsms_rental_list_extend_optionssms_rental_extend

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

Подключите 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 в разделе инструментов и поиска в чате.

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

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

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

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

  • sms_rental_list_services
  • sms_rental_list_countries
  • sms_rental_list_intervals
  • sms_rental_buy_number
  • sms_rental_get_codes
  • sms_rental_list_numbers
  • sms_rental_cancel
  • sms_rental_list_extend_options
  • sms_rental_extend

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

Сравни доступные интервалы аренды для WhatsApp в США и покажи точные цены.
Арендуй номер на самый короткий доступный интервал и следи за новыми сообщениями.
Покажи мои активные аренды и продли ту, что истекает раньше всех, на доступный интервал.

REST

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

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

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

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

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

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

curl 'https://api.voxisim.com/v1/sms/rental/services'
curl 'https://api.voxisim.com/v1/sms/rental/countries?service_id=SERVICE_ID'
curl 'https://api.voxisim.com/v1/sms/rental/intervals?service_id=SERVICE_ID&country_id=COUNTRY_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/rental/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

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

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

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

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

3. Получайте сообщения

Опрашивайте номер в течение всей аренды; используйте last_id, чтобы получать только новые сообщения.

curl 'https://api.voxisim.com/v1/sms/rental/numbers/YOUR_RENTAL_ID/codes' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
Метод Маршрут Что делает
GET /v1/sms/rental/services Список сервисов, доступных для аренды
GET /v1/sms/rental/countries Список стран для сервиса
GET /v1/sms/rental/intervals Список интервалов и точных цен
POST /v1/sms/rental/numbers Аренда номера
GET /v1/sms/rental/numbers Список активных или архивных аренд
GET /v1/sms/rental/numbers/{id}/codes Получение пришедших SMS-сообщений
POST /v1/sms/rental/numbers/{id}/cancel Отмена активной аренды
GET /v1/sms/rental/numbers/{id}/extend-options Список вариантов продления и цен
POST /v1/sms/rental/numbers/{id}/extend Продление активной аренды

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

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

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

Интервалы приходят из поиска

Длительности и цены — не фиксированное меню: они приходят из актуального поиска интервалов. Значение hours, которое вы отправляете при покупке, должно совпадать с одним из вариантов, реально доступных в этот момент.

Читайте сообщения без дублей

Опрашивайте номер с last_id, чтобы каждый вызов возвращал только новое, и сохраните id аренды — он понадобится для отмены или продления.

Отменяйте рано, продлевайте поздно

Отмените аренду в допустимом окне, если номер больше не нужен, или продлите активную аренду на любой доступный для неё интервал.

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

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

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

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

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

SMS-активация

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

  • Около 20 минут
  • Один код подтверждения
  • Подтверждения аккаунтов и одноразовых паролей
Читать руководство «SMS-активация»

Аренда SMS

Вы здесь

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

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

Где подходит аренда

Сессии с несколькими сообщениямиДлительные интеграционные тестыПостоянный доступ к аккаунтуПочтовые ящики под наблюдением агента

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

Вопросы об аренде

  • Сутки — минимум, дальше идут более длинные интервалы. Спросите у эндпоинта интервалов, что реально доступно для вашего сервиса и страны, вместо того чтобы рассчитывать на фиксированный набор: варианты различаются.

  • Столько, сколько придёт за время аренды. Именно в этом её отличие от активации, которая заканчивается после одного кода.

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

  • Да, пока она активна, на любой доступный для неё интервал. Продление дешевле и удобнее, чем аренда нового номера, потому что сам номер не меняется.

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

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

Справочник

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

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

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

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

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

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