API
Каталог, поръчки и ключове чрез интерфейс
Вземете нашия каталог във Вашата система, задействайте поръчки и вземете ключовете. Тази страница показва пътя в шест стъпки. Ограниченията, тестовата среда и границите са в документацията.
Това ще работи, щом магазинът отвори. Дотогава можете спокойно да прочетете всичко.
Страница за разработчици
OpenAPI
Всяко извикване е описано във файл OpenAPI 3.1. Всяко число на страниците е числото, което кодът налага.
- BearerЕдин ключ за приложение, съхранен само като хеш, с изтичане и ротация
- JSONПари в цели центове, дати по ISO 8601, имена в snake_case
- 120 в минутачетения за нов ключ, 600 щом навърши 7 дни
- ПодписаноWebhooks с подпис, по желание и подписани извиквания (RFC 9421)
API е изградено и тествано, документацията е онлайн. Ключове могат да се създават, щом магазинът отвори. Още няма и е само планирано: готов софтуерен комплект, предплатена сума.
Какво можете да правите с него
Синхронизиране на каталога
Зареждате целия списък веднъж, след това само това, което се е променило от последното Ви синхронизиране. Лек изглед показва само наличността.
Готово, отваря със старта на продажбитеЗадействане на поръчки
Една поръчка на извикване, с ценова граница, Вашия собствен номер и ключ срещу двойни покупки.
Готово, отваря със старта на продажбитеВземане на ключове
С отделно право, броено и записвано. Първото извикване прекратява правото на отказ за тази поръчка.
Готово, отваря със старта на продажбитеПолучаване на webhooks
Подписани извиквания към Вашия сървър, когато се промени поръчка или продукт. До 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?
Достъпът е безплатен. Плащате поръчките, които задействате. Основна такса няма.
Има ли софтуерен комплект?
Още не. Документацията има примери с curl, а OpenAPI файлът може да се зареди в обичайните инструменти.
Как да получа по-високи ограничения?
Напишете ни своя план и количество. Повишаваме ограниченията за партньори, при които виждаме нуждата.
Какво става, ако ключът ми бъде откраднат?
Блокирайте го на страницата с ключове и създайте нов. Дотогава дневното ограничение и списъкът с IP адреси ограничават вредата. Подозрителни извиквания замразяват ключа сами.
Къде да съобщя за грешка в API?
Чрез формуляра за контакт с тема API. Посочете извикването и часа.
Готови ли сте за първото извикване?
Прочетете страницата за разработчици докрай и след това създайте ключ.
Изпратете запитване