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?
Доступ безкоштовний. Ви платите за замовлення, які запускаєте. Базової плати немає.
Чи є програмний набір?
Ще ні. У документації є приклади з curl, а файл OpenAPI можна завантажити у звичні інструменти.
Як отримати вищі ліміти?
Напишіть нам про свій задум і обсяг. Ми підвищуємо ліміти партнерам, у яких бачимо потребу.
Що буде, якщо мій ключ викрадуть?
Заблокуйте його на сторінці ключів і створіть новий. До цього часу шкоду обмежують денний ліміт і список IP. Підозрілі виклики самі блокують ключ.
Куди повідомити про помилку в API?
Через контактну форму з темою API. Вкажіть виклик і час.
Готові до першого виклику?
Прочитайте сторінку для розробників, а потім створіть ключ.
Надіслати запит