KodShopКодШоп
esim без человека

Купить eSIM автономно. Строка активации в ответе.

Заказы на этом сайте оформляет человек: POST /api/public/create-order принимает запросы только со страниц магазина, остальным отвечает 403 turnstile_required. Агент может искать товары и читать цены через API, MCP и A2A, а купить их должен человек на странице товара. Примеры покупки через API ниже здесь не сработают.

Агент забронировал перелёт и отель. Пассажир садится в Стамбуле через 6 часов, а интернета на месте нет. 4 HTTP-запроса решают это без человека: последний ответ содержит строку активации LPA, которую телефон принимает напрямую.

Покрытие - 80+ стран. Тарифы различаются объёмом и сроком, цены лежат в ответе каталога, а заказ идёт через тот же API без аккаунта, что и всё остальное.

HTTP + JSONOpenAPI 3.1llms.txtMCPA2AMPPACPUCP
esim.sh
# 1. which countries have coverage
curl "https://kodshop.cloud/api/public/esim/countries"

# 2. bundles for the destination
curl "https://kodshop.cloud/api/public/esim/bundles?country=TR"
# -> [{"name":"...","data_gb":5,"duration_days":30,"price":...}]

Как выглядит доставка

Ответ завершённого заказа содержит объект esim: iccid, qr_code_data (строка LPA вида LPA:1$rsp.example.com$TOKEN), название тарифа, объём и срок. Телефон или модем с eSIM принимает строку LPA напрямую.

Нужен QR картинкой, чтобы передать человеку? GET /api/public/order/{id}/esim-qr.png?token=... отрисует его на сервере. Агент передаёт ссылку и не генерирует QR сам.

Как выбрать тариф

Сначала список стран, потом тарифы по стране назначения. В каждой строке - data_gb, duration_days и цена. Каталог собран из 2 сетей, в каждой ячейке побеждает более дешёвая, так что агент выбирает тариф, а не поставщика.

Заказывайте с bundle_name ровно в том виде, в котором его вернул каталог, плюс country_code. Создание заказа сверяет тариф с живым каталогом до списания денег.

Оплата и сроки

Способы оплаты те же, что и во всём магазине: крипто-инвойс (USDT, минимум 10 RUB на заказ) или карта на сайте для человека. Большинство eSIM приходит в течение 5 минут после оплаты. Часть стран выдаёт профиль асинхронно: заказ висит в fulfilling, и цикл опроса ловит completed обычно за несколько минут.

Про eSIM подробнее

Как быстро приходит eSIM после оплаты?

Обычно в течение 5 минут. Часть направлений выдаёт профиль асинхронно: заказ висит в fulfilling и переключается в completed, когда профиль готов, как правило за минуты. Опрашивайте эндпоинт заказа, статус там первичен.

Агент получает QR-код или строку активации?

И то и другое. qr_code_data в ответе заказа - сырая строка LPA, а эндпоинт esim-qr.png отрисовывает тот же payload картинкой для людей.

Можно проверить покрытие до покупки?

Да. /api/public/esim/countries перечисляет страны, /api/public/esim/bundles?country=XX - конкретные тарифы с объёмом, сроком и ценой. Оба бесплатны и без авторизации.

А если трафик кончится?

Закажите ещё один тариф тем же способом. Заказы независимы: докупка - это вторая покупка из тех же 4 запросов.

Возврат автоматический, если профиль не выдался?

Нет. Сорвавшийся заказ показывает failed в ответе, а возврат делает человек: support@support.kodshop.cloud, укажите номер заказа.

Ещё для агентов