Настоящий номер, с которого агент читает SMS
Заказы на этом сайте оформляет человек: POST /api/public/create-order принимает запросы только со страниц магазина, остальным отвечает 403 turnstile_required. Агент может искать товары и читать цены через API, MCP и A2A, а купить их должен человек на странице товара. Примеры покупки через API ниже здесь не сработают.
Сервисы до сих пор подтверждают всё по SMS. У агента SIM-карты нет. Аренда номера через API закрывает разрыв: номер настоящий, входящие SMS падают в JSON-эндпоинт, а аренда живёт дольше любой сессии.
Один заказ арендует британский мобильный номер на 3 месяца по фиксированной цене. Входящие читаются одним GET-запросом, кеш на сервере - 30 секунд.
# 1. price and terms
curl "https://kodshop.cloud/api/public/phone/info"Как агент читает сообщения
В письме с доставкой приходит ссылка на дашборд, и её токен работает как API-ключ. GET /api/public/phone/dashboard/{token}/messages возвращает входящие в JSON: отправитель, текст, время. Опрашивайте после того, как запустили то, что шлёт SMS.
Токен и есть вся авторизация, обращайтесь с ним как с паролем. На дашборде можно поставить PIN - второй фактор для человеческого просмотра.
Условия, которые стоит знать до заказа
Аренда длится 3 месяца с активации, в ответе заказа есть expires_at. Продление - отдельный тип заказа (phone_rental_renew, авторизация по токену дашборда), так что долгоживущий агент продлевает номер без помощи человека.
Выдача номера асинхронная по устройству рельсов: после оплаты заказ висит в fulfilling, пока номер выделяется, обычно несколько минут. Опрашивайте эндпоинт заказа, в ответе completed лежит номер.
Для чего это, а для чего нет
Хорошо подходит: агент регистрируется в сервисах по поручению оператора, мониторинги с подтверждением по SMS, общий входящий ящик на 1 номер для команды, проверка доставки SMS из вашего продукта.
Номер настоящий, за ним стоит реальный оператор. Используйте его законно и по правилам тех сервисов, куда его подключаете. За злоупотребления аренду закрывают.
Про аренду номера подробнее
Номер виртуальный или настоящий?
Настоящий британский мобильный номер с оператором за ним, а не VoIP-заглушка. Сервисы, которые режут известные виртуальные диапазоны, видят его как обычный мобильный.
Как агент получает SMS без почтового ящика?
Через эндпоинт сообщений. GET /api/public/phone/dashboard/{token}/messages возвращает входящие в JSON. Токен приходит с письмом о доставке: сохраните его 1 раз, и почта агенту больше не нужна.
Сколько ждать номер после оплаты?
Минуты, не секунды: номер выделяется асинхронно после подтверждения оплаты. Статус заказа идёт из fulfilling в completed, опрос эндпоинта заказа - штатный способ ждать.
Аренду можно продлить?
Да. Создайте заказ с product_type phone_rental_renew и dashboard_token. Email берётся из существующей аренды, поэтому утёкший токен может продлить номер, но не увести доставку.
Можно выбрать страну или взять несколько номеров?
Сейчас продукт один: британский номер на 3 месяца. Несколько номеров - несколько заказов, у каждого свой токен и свой ящик. Нужна другая страна - напишите на support@support.kodshop.cloud, спрос двигает планы.