API
Katalog, objednávky a klíče přes rozhraní
Přeneste náš katalog do svého systému, spouštějte objednávky a vyzvedávejte klíče. Tato stránka ukazuje cestu v šesti krocích. Limity, testovací prostředí a omezení jsou v dokumentaci.
To bude fungovat, jakmile se obchod otevře. Do té doby si vše můžete v klidu přečíst.
Stránka pro vývojáře
OpenAPI
Každé volání je popsáno v souboru OpenAPI 3.1. Každé číslo na stránkách je číslo, které kód vynucuje.
- BearerJeden klíč na aplikaci, uložený jen jako hash, s platností a rotací
- JSONPeníze v celých centech, data podle ISO 8601, názvy ve snake_case
- 120 za minutučtení pro nový klíč, 600 jakmile je starý 7 dní
- PodepsanéWebhooky s podpisem, na přání i podepsaná volání (RFC 9421)
API je postaveno a otestováno, dokumentace je online. Klíče lze vytvářet, jakmile se obchod otevře. Zatím neexistuje a je jen plánováno: hotový softwarový kit, předplacený zůstatek.
Co s tím můžete dělat
Synchronizovat katalog
Celý seznam načtete jednou, poté jen to, co se změnilo od vaší poslední synchronizace. Lehký pohled ukazuje jen stav zásob.
Připraveno, otevře se se zahájením prodejeSpouštět objednávky
Jedna objednávka na volání, s cenovým stropem, vaším vlastním číslem a klíčem proti dvojímu nákupu.
Připraveno, otevře se se zahájením prodejeVyzvedávat klíče
S vlastním právem, počítané a zaznamenávané. První vyzvednutí ukončí právo na odstoupení u této objednávky.
Připraveno, otevře se se zahájením prodejePřijímat webhooky
Podepsaná volání na váš server, když se změní objednávka nebo produkt. Až 3 adres.
Připraveno, otevře se se zahájením prodejeNabízet jako prodejce
Spravujte nabídky, ceny a zásoby ze svého skladového systému. Předpokladem je, že prodej na Capydra je otevřen.
Připraveno, otevře se se zahájením prodejePoužívat s AI asistenty
Stejný účet funguje přes náš server MCP. Pravidla a limity jsou stejné.
Připraveno, otevře se se zahájením prodeje
V šesti krocích k prvnímu volání
- 1
Založte účet
Přihlásíte se v obchodě.
- 2
Vytvořte klíč
V části „Klíče API“: název, role (kupující nebo prodejce) a práva, která potřebujete. Dejte co nejméně.
- 3
Potvrďte prohlášení o vzdání se práva
Dvě věty o odstoupení od smlouvy, jednou. Každá objednávka s klíčem na ně odkazuje.
- 4
Zabezpečte klíč
Zobrazí se jen jednou. Uložte ho jako heslo a zapište IP adresy svých serverů do seznamu.
- 5
Nastavte denní limit
Součet všech objednávek za den je omezen: €250 u nového klíče, nastavitelný až do €5,000.
- 6
Odešlete první volání
S klíčem v hlavičce „Authorization“. Příklad níže načte první produkty.
První volání
Klíč začíná omk_live_. Vkládá se do každého volání jako hodnota bearer. Peníze jsou uvedeny v celých centech a zahrnují poplatek za služby.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# jen to, co se změnilo od vaší poslední synchronizace
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Pokračujte v dokumentaci
Obchod ještě není otevřen: volání, která něco mění, odpovídají 403 showcase_mode a odpovědi neobsahují ceny.
Časté dotazy
Kolik API stojí?
Přístup je zdarma. Platíte objednávky, které spustíte. Základní poplatek neexistuje.
Existuje softwarový kit?
Zatím ne. Dokumentace má příklady s curl a soubor OpenAPI lze načíst do běžných nástrojů.
Jak získám vyšší limity?
Napište nám svůj záměr a objem. Limity zvyšujeme partnerům, u nichž vidíme potřebu.
Co když mi klíč někdo ukradne?
Zablokujte ho na stránce klíčů a vytvořte nový. Do té doby škodu omezují denní limit a seznam IP. Nápadná volání klíč sama zablokují.
Kde nahlásím chybu v API?
Přes kontaktní formulář s tématem API. Uveďte volání a čas.
Připraveni na první volání?
Přečtěte si stránku pro vývojáře a poté vytvořte klíč.
Odeslat dotaz