Предварителен преглед: Capydra отваря скоро. Поръчките все още не са възможни.

Capydra
Plus Помощ Количка
Оферта на седмицата

API

Каталог, поръчки и ключове чрез интерфейс

Вземете нашия каталог във Вашата система, задействайте поръчки и вземете ключовете. Тази страница показва пътя в шест стъпки. Ограниченията, тестовата среда и границите са в документацията.

Скоро се отваряКъм документацията

Това ще работи, щом магазинът отвори. Дотогава можете спокойно да прочетете всичко.

Страница за разработчици

OpenAPI

Всяко извикване е описано във файл OpenAPI 3.1. Всяко число на страниците е числото, което кодът налага.

Готово, отваря със старта на продажбите

API е изградено и тествано, документацията е онлайн. Ключове могат да се създават, щом магазинът отвори. Още няма и е само планирано: готов софтуерен комплект, предплатена сума.

Какво можете да правите с него

  • Синхронизиране на каталога

    Зареждате целия списък веднъж, след това само това, което се е променило от последното Ви синхронизиране. Лек изглед показва само наличността.

    Готово, отваря със старта на продажбите
  • Задействане на поръчки

    Една поръчка на извикване, с ценова граница, Вашия собствен номер и ключ срещу двойни покупки.

    Готово, отваря със старта на продажбите
  • Вземане на ключове

    С отделно право, броено и записвано. Първото извикване прекратява правото на отказ за тази поръчка.

    Готово, отваря със старта на продажбите
  • Получаване на webhooks

    Подписани извиквания към Вашия сървър, когато се промени поръчка или продукт. До 3 адреса.

    Готово, отваря със старта на продажбите
  • Предлагане като продавач

    Поддържайте оферти, цени и наличност от Вашата складова система. Това изисква продажбата в Capydra да е отворена.

    Готово, отваря със старта на продажбите
  • Използване с ИИ асистенти

    Същият профил работи през нашия MCP сървър. Правилата и ограниченията са същите.

    Готово, отваря със старта на продажбите

В шест стъпки до първото извикване

  1. 1

    Създайте профил

    Влизате в магазина.

  2. 2

    Създайте ключ

    Под „API ключове“: име, роля (купувач или продавач) и правата, които Ви трябват. Давайте възможно най-малко.

  3. 3

    Потвърдете декларацията за отказ

    Две изречения за отказа от договора, веднъж. Всяка поръчка с ключа се позовава на тях.

  4. 4

    Запазете ключа

    Показва се само веднъж. Съхранявайте го като парола и добавете IP адресите на Вашите сървъри в списъка.

  5. 5

    Задайте дневно ограничение

    Сборът на всички поръчки за един ден е ограничен: €250 при нов ключ, настройваемо до €5,000.

  6. 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

Магазинът още не е отворен: извикванията, които променят нещо, отговарят с 403 showcase_mode, а отговорите не съдържат цени.

Често задавани въпроси

Колко струва API?

Достъпът е безплатен. Плащате поръчките, които задействате. Основна такса няма.

Има ли софтуерен комплект?

Още не. Документацията има примери с curl, а OpenAPI файлът може да се зареди в обичайните инструменти.

Как да получа по-високи ограничения?

Напишете ни своя план и количество. Повишаваме ограниченията за партньори, при които виждаме нуждата.

Какво става, ако ключът ми бъде откраднат?

Блокирайте го на страницата с ключове и създайте нов. Дотогава дневното ограничение и списъкът с IP адреси ограничават вредата. Подозрителни извиквания замразяват ключа сами.

Къде да съобщя за грешка в API?

Чрез формуляра за контакт с тема API. Посочете извикването и часа.

Готови ли сте за първото извикване?

Прочетете страницата за разработчици докрай и след това създайте ключ.

Изпратете запитване