API
Каталог, заказы и ключи через интерфейс
Подключите наш каталог к своей системе, запускайте заказы и забирайте ключи. Эта страница показывает путь в шесть шагов. Лимиты, тестовая среда и ограничения описаны в документации.
Это станет возможным, как только магазин откроется. До тех пор вы можете спокойно всё прочитать.
Страница для разработчиков
OpenAPI
Каждый запрос описан в файле OpenAPI 3.1. Каждая цифра на страницах совпадает с той, которую обеспечивает код.
- BearerОдин ключ на приложение, хранится только в виде хеша, со сроком действия и ротацией
- JSONДеньги в целых центах, даты по ISO 8601, имена в snake_case
- 120 в минутузапросов на чтение для нового ключа, 600 когда ему исполнится 7 дн.
- С подписьюВеб-хуки с подписью, по желанию также подписанные запросы (RFC 9421)
API создан и протестирован, документация доступна онлайн. Ключи доступа можно будет создавать, как только откроется магазин. Пока нет и только планируется: готовый набор программных средств и предоплаченный баланс.
Что вы можете с ним делать
Синхронизировать каталог
Загрузите весь список один раз, затем только то, что изменилось с вашей последней синхронизации. Облегчённое представление показывает только наличие.
Готово, откроется со стартом продажЗапускать заказы
Один заказ на запрос, с пределом цены, вашим собственным номером и ключом защиты от двойных покупок.
Готово, откроется со стартом продажЗабирать ключи
С отдельным правом, с подсчётом и записью в журнал. Первый запрос прекращает право на отказ от договора по этому заказу.
Готово, откроется со стартом продажПолучать веб-хуки
Подписанные запросы на ваш сервер, когда заказ или товар меняется. До 3 адресов.
Готово, откроется со стартом продажПредлагать как продавец
Поддерживайте предложения, цены и наличие из вашей складской системы. Для этого продажи на Capydra должны быть открыты.
Готово, откроется со стартом продажИспользовать с ИИ-ассистентами
Тот же аккаунт работает через наш MCP-сервер. Правила и лимиты те же.
Готово, откроется со стартом продаж
Шесть шагов до первого запроса
- 1
Создайте аккаунт
Вы входите в магазин.
- 2
Создайте ключ доступа
В разделе «Ключи API»: имя, роль (покупатель или продавец) и необходимые вам права. Выдавайте как можно меньше.
- 3
Подтвердите отказ от права
Два предложения об отказе от договора, один раз. Каждый заказ, сделанный с этим ключом, ссылается на них.
- 4
Сохраните ключ
Он показывается только один раз. Храните его как пароль и внесите в список IP-адреса ваших серверов.
- 5
Задайте дневной лимит
Сумма всех заказов за день ограничена: €250 для нового ключа, можно увеличить до €5,000.
- 6
Отправьте первый запрос
С ключом в заголовке «Authorization». Пример ниже читает первые товары.
Первый запрос
Ключ начинается с omk_live_. Он передаётся в каждом запросе как значение Bearer. Деньги указаны в целых центах и включают сервисный сбор.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# только то, что изменилось с вашей последней синхронизации
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Далее в документации
Магазин ещё не открыт: запросы, которые что-то изменяют, отвечают 403 showcase_mode, а в ответах нет цен.
Частые вопросы
Сколько стоит API?
Доступ бесплатный. Вы платите за заказы, которые запускаете. Абонентской платы нет.
Есть ли набор программных средств (SDK)?
Пока нет. В документации есть примеры с curl, а файл OpenAPI можно загрузить в распространённые инструменты.
Как получить более высокие лимиты?
Напишите нам о вашем проекте и объёме. Мы повышаем лимиты для партнёров, у которых видим потребность.
Что будет, если мой ключ украдут?
Заблокируйте его на странице ключей и создайте новый. До этого дневной лимит и список IP ограничивают ущерб. Подозрительные запросы блокируют ключ автоматически.
Куда сообщить об ошибке в API?
Через контактную форму с темой API. Укажите запрос и время.
Готовы к первому запросу?
Прочитайте страницу для разработчиков до конца, затем создайте ключ.
Отправить запрос