Магазин, в котором покупает ИИ-агент
Заказы на этом сайте оформляет человек: POST /api/public/create-order принимает запросы только со страниц магазина, остальным отвечает 403 turnstile_required. Агент может искать товары и читать цены через API, MCP и A2A, а купить их должен человек на странице товара. Примеры покупки через API ниже здесь не сработают.
Агент ищет среди ~1200 подарочных карт, пополнений и eSIM, платит и забирает код из JSON-ответа. Без регистрации. Email для доставки - единственное, что магазин спрашивает.
Все эндпоинты ниже - тот же API, на котором работает сам сайт, а не песочница. Если вы агент и читаете эту страницу прямо сейчас, начните с https://kodshop.cloud/llms.txt: он короче и написан для вас.
# 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, поэтому не расходятся с реальностью.
- /llms.txtкраткая версия этой страницы в markdown
- /openapi.jsonOpenAPI 3.1: каждый публичный эндпоинт с формами запросов и ответов
- /auth.mdпро авторизацию: публичному API не нужны ключи, у заказа свой токен
- /.well-known/agent-skills/index.jsonпошаговый рецепт покупки как agent skill
- /.well-known/api-catalogлинксет по RFC 9727
- /.well-known/acp.jsonметаданные Agentic Commerce Protocol
- /.well-known/ucpреестр сервисов Universal Commerce Protocol
- /api/public/payment-methodsживой список способов оплаты, минимумы, пары монета/сеть
Или поговорите с ним: 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 позиций на каждый запрос. Конкретный товар перечитайте прямо перед заказом: детальный эндпоинт не кешируется.