KodShopКодШоп
для ИИ-агентов

Магазин, в котором покупает ИИ-агент

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

Агент ищет среди ~1200 подарочных карт, пополнений и eSIM, платит и забирает код из JSON-ответа. Без регистрации. Email для доставки - единственное, что магазин спрашивает.

Все эндпоинты ниже - тот же API, на котором работает сам сайт, а не песочница. Если вы агент и читаете эту страницу прямо сейчас, начните с https://kodshop.cloud/llms.txt: он короче и написан для вас.

HTTP + JSONOpenAPI 3.1llms.txtMCPA2AMPPACPUCP
buy.sh
# 1. search the catalog
curl "https://kodshop.cloud/api/public/products?q=steam&type=voucher"

Вся покупка - 4 HTTP-запроса

Поиск, заказ, оплата, опрос статуса. Запрос создания заказа возвращает order_id и токен доступа к этому заказу - единственный секрет во всей схеме. Передавайте заголовок Idempotency-Key: повтор запроса вернёт тот же заказ, а не купит дважды.

quantity по умолчанию равен 1, так что минимальное тело для карты - это email, product_type, product_id и item_id. Когда заказ дошёл до completed, код лежит прямо в ответе. Он же уходит на почту, но агенту почтовый ящик не нужен.

Всё машиночитаемое

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

Или поговорите с ним: MCP и A2A

На https://kodshop.cloud/mcp работает MCP-сервер (Streamable HTTP), на https://kodshop.cloud/a2a - A2A-агент (JSON-RPC message/send, карточка в /.well-known/agent-card.json). Оба отдают одни и те же 2 инструмента только для чтения: search_catalog и get_product. Чат-агент просматривает каталог, не составляя HTTP-запросы руками.

Покупка намеренно осталась на HTTP-флоу. Покупка тратит деньги и требует адрес доставки, а такое решение должно жить в вашем коде, а не в импровизированном вызове инструмента.

Оплата без браузера

Крипто-инвойс (create-heleket-payment) возвращает адрес в сети и точную сумму - кошелёк агента платит сам, без браузера. Надёжные пары - USDT в сетях bsc и tron. Минимум 10 RUB на заказ: более дешёвые заказы отклоняются с ошибкой amount_too_low. Оплата картой есть на сайте, для людей.

Цены видны до создания заказа: у каждой платёжной операции в /openapi.json есть блок MPP (Machine Payment Protocol) x-payment-info с минимальной суммой, а /api/public/payment-methods отдаёт те же цифры вживую.

Вопросы, которые задают агенты и их операторы

Агент правда может купить здесь без участия человека?

Нет, заказ оформляет человек на странице товара. Агенту открыты поиск по каталогу, цены и наличие.

Нужен ли агенту API-ключ или аккаунт?

Нет. Публичный API работает без ключей. Запрос создания заказа возвращает токен доступа к этому заказу - единственный секрет во всём флоу.

Что именно агент получает после оплаты?

Ответ эндпоинта статуса заказа. Для карт это delivery.code, для eSIM - объект esim с ICCID и строкой активации LPA, для номеров - сам номер. То же самое дублируется на email.

Безопасно ли повторить запрос после таймаута?

Да, если при создании заказа был заголовок Idempotency-Key. Повтор с тем же ключом вернёт тот же заказ, а не создаст второй.

Что будет, если после оплаты доставка сорвалась?

Статус заказа станет failed, ответ это покажет. Возврат делает человек: напишите на support@support.kodshop.cloud с номером заказа. Автоматического эндпоинта возврата нет, и это сознательное решение.

Насколько свежий каталог?

Обновляется каждые 25 минут. Кешируйте список на своей стороне, а не перечитывайте 1200 позиций на каждый запрос. Конкретный товар перечитайте прямо перед заказом: детальный эндпоинт не кешируется.

По товарам